Storage Tasks - Create
异步创建具有指定参数的新存储任务资源。 如果已创建存储任务,并发出具有不同属性的后续创建请求,则会更新存储任务属性。 如果已创建存储任务,并且后续的创建或更新请求与属性集完全相同,则请求将成功。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}?api-version=2023-01-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 |
资源组的名称。 名称不区分大小写。 |
storage
|
path | True |
string minLength: 3maxLength: 18 pattern: ^[a-z0-9]{3,18}$ |
指定资源组中的存储任务的名称。 存储任务名称长度必须介于 3 到 18 个字符之间,并且仅使用数字和小写字母。 |
subscription
|
path | True |
string (uuid) |
目标订阅的 ID。 该值必须是 UUID。 |
api-version
|
query | True |
string minLength: 1 |
用于此操作的 API 版本。 |
请求正文
名称 | 必需 | 类型 | 说明 |
---|---|---|---|
identity | True |
资源的托管服务标识。 |
|
location | True |
string |
资源所在的地理位置 |
properties.action | True |
执行的存储任务操作 |
|
properties.description | True |
string |
描述存储任务用途的文本 |
properties.enabled | True |
boolean |
当设置为 true 且设置为 false 时禁用存储任务 |
tags |
object |
资源标记。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
资源“StorageTask”更新作成功 |
|
201 Created |
资源“StorageTask”创建作成功 标头
|
|
202 Accepted |
已接受资源作。 标头
|
|
Other Status Codes |
意外的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 流程。
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
PutStorageTask
示例请求
PUT https://management.azure.com/subscriptions/1f31ba14-ce16-4281-b9b4-3e78da6e1616/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1?api-version=2023-01-01
{
"identity": {
"type": "SystemAssigned"
},
"location": "westus",
"properties": {
"description": "My Storage task",
"action": {
"else": {
"operations": [
{
"name": "DeleteBlob",
"onFailure": "break",
"onSuccess": "continue"
}
]
},
"if": {
"condition": "[[equals(AccessTier, 'Cool')]]",
"operations": [
{
"name": "SetBlobTier",
"onFailure": "break",
"onSuccess": "continue",
"parameters": {
"tier": "Hot"
}
}
]
}
},
"enabled": true
}
}
示例响应
location: https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9101/providers/Microsoft.StorageActions/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-01-01
{
"name": "mytask1",
"type": "Microsoft.StorageActions/storageTasks",
"id": "/subscriptions/c86a9c18-8373-41fa-92d4-1d7bdc16977b/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
"identity": {
"type": "SystemAssigned",
"principalId": "2fd475e8-8923-4597-842f-7ce1adfc6c4a",
"tenantId": "b4a2005c-32c1-434c-bbf0-ff486912fc75"
},
"location": "westus",
"properties": {
"description": "Storage task",
"action": {
"else": {
"operations": [
{
"name": "DeleteBlob",
"onFailure": "break",
"onSuccess": "continue"
}
]
},
"if": {
"condition": "[[equals(AccessTier, 'Cool')]]",
"operations": [
{
"name": "SetBlobTier",
"onFailure": "break",
"onSuccess": "continue",
"parameters": {
"tier": "Hot"
}
}
]
}
},
"creationTimeInUtc": "2023-07-06T00:24:59.1441663Z",
"enabled": true,
"provisioningState": "Succeeded",
"taskVersion": 1
}
}
location: https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9101/providers/Microsoft.StorageActions/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-01-01
{
"name": "mytask1",
"type": "Microsoft.StorageActions/storageTasks",
"id": "/subscriptions/c86a9c18-8373-41fa-92d4-1d7bdc16977b/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
"identity": {
"type": "SystemAssigned",
"principalId": "2fd475e8-8923-4597-842f-7ce1adfc6c4a",
"tenantId": "b4a2005c-32c1-434c-bbf0-ff486912fc75"
},
"location": "westus",
"properties": {
"description": "Storage task",
"action": {
"else": {
"operations": [
{
"name": "DeleteBlob",
"onFailure": "break",
"onSuccess": "continue"
}
]
},
"if": {
"condition": "[[equals(AccessTier, 'Cool')]]",
"operations": [
{
"name": "SetBlobTier",
"onFailure": "break",
"onSuccess": "continue",
"parameters": {
"tier": "Hot"
}
}
]
}
},
"creationTimeInUtc": "2023-07-06T00:24:59.1441663Z",
"enabled": true,
"provisioningState": "Succeeded",
"taskVersion": 1
}
}
location: https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9101/providers/Microsoft.StorageActions/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-01-01
定义
名称 | 说明 |
---|---|
created |
创建资源的标识的类型。 |
Else |
存储任务操作的其他块 |
Error |
资源管理错误附加信息。 |
Error |
错误详细信息。 |
Error |
错误响应 |
If |
存储任务操作的 if 块 |
Managed |
托管服务标识(系统分配和/或用户分配的标识) |
Managed |
托管服务标识的类型(其中允许 SystemAssigned 和 UserAssigned 类型)。 |
On |
作失败时要执行的作。 |
On |
对对象成功执行作时要执行的作。 |
Provisioning |
表示存储任务的预配状态。 |
Storage |
表示存储任务。 |
Storage |
存储任务作表示对目标对象执行的条件语句和作。 |
Storage |
表示对对象执行的作 |
Storage |
要对对象执行的作。 |
system |
与创建和上次修改资源相关的元数据。 |
User |
用户分配的标识属性 |
createdByType
创建资源的标识的类型。
值 | 说明 |
---|---|
User | |
Application | |
ManagedIdentity | |
Key |
ElseCondition
存储任务操作的其他块
名称 | 类型 | 说明 |
---|---|---|
operations |
要在其他块中执行的作列表 |
ErrorAdditionalInfo
资源管理错误附加信息。
名称 | 类型 | 说明 |
---|---|---|
info |
object |
其他信息。 |
type |
string |
其他信息类型。 |
ErrorDetail
错误详细信息。
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
错误附加信息。 |
|
code |
string |
错误代码。 |
details |
错误详细信息。 |
|
message |
string |
错误消息。 |
target |
string |
错误目标。 |
ErrorResponse
错误响应
名称 | 类型 | 说明 |
---|---|---|
error |
错误对象。 |
IfCondition
存储任务操作的 if 块
名称 | 类型 | 说明 |
---|---|---|
condition |
string |
用于计算每个对象的条件谓词。 有关有效属性和运算符,请参阅 https://aka.ms/storagetaskconditions。 |
operations |
条件谓词满足时要执行的作列表。 |
ManagedServiceIdentity
托管服务标识(系统分配和/或用户分配的标识)
名称 | 类型 | 说明 |
---|---|---|
principalId |
string (uuid) |
系统分配标识的服务主体 ID。 此属性仅针对系统分配的标识提供。 |
tenantId |
string (uuid) |
系统分配标识的租户 ID。 此属性仅针对系统分配的标识提供。 |
type |
托管服务标识的类型(其中允许 SystemAssigned 和 UserAssigned 类型)。 |
|
userAssignedIdentities |
<string,
User |
User-Assigned 标识 |
ManagedServiceIdentityType
托管服务标识的类型(其中允许 SystemAssigned 和 UserAssigned 类型)。
值 | 说明 |
---|---|
None | |
SystemAssigned | |
UserAssigned | |
SystemAssigned,UserAssigned |
OnFailure
作失败时要执行的作。
值 | 说明 |
---|---|
break |
OnSuccess
对对象成功执行作时要执行的作。
值 | 说明 |
---|---|
continue |
ProvisioningState
表示存储任务的预配状态。
值 | 说明 |
---|---|
ValidateSubscriptionQuotaBegin | |
ValidateSubscriptionQuotaEnd | |
Accepted | |
Creating | |
Succeeded | |
Deleting | |
Canceled | |
Failed |
StorageTask
表示存储任务。
名称 | 类型 | 说明 |
---|---|---|
id |
string (arm-id) |
资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}” |
identity |
资源的托管服务标识。 |
|
location |
string |
资源所在的地理位置 |
name |
string |
资源的名称 |
properties.action |
执行的存储任务操作 |
|
properties.creationTimeInUtc |
string (date-time) |
存储任务的创建日期和时间(UTC)。 |
properties.description |
string |
描述存储任务用途的文本 |
properties.enabled |
boolean |
当设置为 true 且设置为 false 时禁用存储任务 |
properties.provisioningState |
表示存储任务的预配状态。 |
|
properties.taskVersion |
integer (int64) minimum: 1maximum: 1 |
存储任务版本。 |
systemData |
包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。 |
|
tags |
object |
资源标记。 |
type |
string |
资源的类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
StorageTaskAction
存储任务作表示对目标对象执行的条件语句和作。
名称 | 类型 | 说明 |
---|---|---|
else |
存储任务操作的其他块 |
|
if |
存储任务操作的 if 块 |
StorageTaskOperation
表示对对象执行的作
名称 | 类型 | 说明 |
---|---|---|
name |
要对对象执行的作。 |
|
onFailure |
作失败时要执行的作。 |
|
onSuccess |
对对象成功执行作时要执行的作。 |
|
parameters |
object |
作的键值参数。 |
StorageTaskOperationName
要对对象执行的作。
值 | 说明 |
---|---|
SetBlobTier | |
SetBlobTags | |
SetBlobImmutabilityPolicy | |
SetBlobLegalHold | |
SetBlobExpiry | |
DeleteBlob | |
UndeleteBlob |
systemData
与创建和上次修改资源相关的元数据。
名称 | 类型 | 说明 |
---|---|---|
createdAt |
string (date-time) |
资源创建时间戳(UTC)。 |
createdBy |
string |
创建资源的标识。 |
createdByType |
创建资源的标识的类型。 |
|
lastModifiedAt |
string (date-time) |
上次修改的资源时间戳(UTC) |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识的类型。 |
UserAssignedIdentity
用户分配的标识属性
名称 | 类型 | 说明 |
---|---|---|
clientId |
string (uuid) |
分配的标识的客户端 ID。 |
principalId |
string (uuid) |
已分配标识的主体 ID。 |