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) |
Идентификатор целевой подписки. Значение должно быть 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
Поток OAuth2 в Azure Active Directory.
Тип:
oauth2
Flow:
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 |
Если блок задачи хранилища |
|
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
Если блок задачи хранилища
| Имя | Тип | Описание |
|---|---|---|
| condition |
string |
Предикат условия для оценки каждого объекта. Сведения о допустимых свойствах и операторах см. в https://aka.ms/storagetaskconditions. |
| operations |
Список операций, выполняемых при выполнении предиката условия. |
ManagedServiceIdentity
Управляемое удостоверение службы (назначенные системой удостоверения и (или) назначенные пользователем удостоверения
| Имя | Тип | Описание |
|---|---|---|
| principalId |
string (uuid) |
Идентификатор субъекта-службы назначенного системой удостоверения. Это свойство будет предоставлено только для назначаемого системой удостоверения. |
| tenantId |
string (uuid) |
Идентификатор клиента назначенного системой удостоверения. Это свойство будет предоставлено только для назначаемого системой удостоверения. |
| 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) |
Полный идентификатор ресурса для ресурса. Например, "/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 |
Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy. |
|
| tags |
object |
Теги ресурсов. |
| type |
string |
Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts" |
StorageTaskAction
Действие задачи хранилища представляет условные операторы и операции, выполняемые на целевых объектах.
| Имя | Тип | Описание |
|---|---|---|
| else |
Другой блок операции задачи хранения |
|
| 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) |
Идентификатор клиента назначенного удостоверения. |
| principalId |
string (uuid) |
Основной идентификатор назначенного удостоверения. |