Поделиться через


Storage Tasks - Create

Асинхронно создает ресурс задачи хранилища с указанными параметрами. Если задача хранилища уже создана, а последующий запрос на создание выдан с различными свойствами, свойства задачи хранения будут обновлены. Если задача хранилища уже создана, а последующий запрос на создание или обновление выдан с одинаковым набором свойств, запрос будет выполнен успешно.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}?api-version=2023-01-01

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя не учитывает регистр.

storageTaskName
path True

string

minLength: 3
maxLength: 18
pattern: ^[a-z0-9]{3,18}$

Имя задачи хранения в указанной группе ресурсов. Имена задач хранилища должны быть от 3 до 18 символов длиной и использовать только цифры и строчные буквы.

subscriptionId
path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть UUID.

api-version
query True

string

minLength: 1

Версия API, используемая для этой операции.

Текст запроса

Имя Обязательно Тип Описание
identity True

ManagedServiceIdentity

Удостоверение управляемой службы ресурса.

location True

string

Географическое расположение, в котором находится ресурс

properties.action True

StorageTaskAction

Действие задачи хранилища, выполняемая

properties.description True

string

Текст, описывающий назначение задачи хранения

properties.enabled True

boolean

Задача хранилища включена, если задано значение true и отключено, если задано значение false

tags

object

Теги ресурсов.

Ответы

Имя Тип Описание
200 OK

StorageTask

Операция обновления ресурса 'StorageTask' выполнена успешно

201 Created

StorageTask

Операция по созданию ресурса 'StorageTask' выполнена успешно

Заголовки

  • Location: string
  • Retry-After: integer
202 Accepted

Операция ресурса принята.

Заголовки

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

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

Определения

Имя Описание
createdByType

Тип удостоверения, создавшего ресурс.

ElseCondition

Другой блок операции задачи хранения

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Ответ на ошибку

IfCondition

Если блок задачи хранилища

ManagedServiceIdentity

Управляемое удостоверение службы (назначенные системой удостоверения и (или) назначенные пользователем удостоверения

ManagedServiceIdentityType

Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).

OnFailure

Действие, выполняемое при сбое операции для объекта.

OnSuccess

Действие, выполняемое при успешном выполнении операции для объекта.

ProvisioningState

Представляет состояние подготовки задачи хранилища.

StorageTask

Представляет задачу хранилища.

StorageTaskAction

Действие задачи хранилища представляет условные операторы и операции, выполняемые на целевых объектах.

StorageTaskOperation

Представляет операцию, выполняемую для объекта

StorageTaskOperationName

Операция, выполняемая для объекта.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

UserAssignedIdentity

Свойства назначаемого пользователем удостоверения

createdByType

Тип удостоверения, создавшего ресурс.

Значение Описание
User
Application
ManagedIdentity
Key

ElseCondition

Другой блок операции задачи хранения

Имя Тип Описание
operations

StorageTaskOperation[]

Список операций, выполняемых в другом блоке

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

IfCondition

Если блок задачи хранилища

Имя Тип Описание
condition

string

Предикат условия для оценки каждого объекта. Сведения о допустимых свойствах и операторах см. в https://aka.ms/storagetaskconditions.

operations

StorageTaskOperation[]

Список операций, выполняемых при выполнении предиката условия.

ManagedServiceIdentity

Управляемое удостоверение службы (назначенные системой удостоверения и (или) назначенные пользователем удостоверения

Имя Тип Описание
principalId

string (uuid)

Идентификатор субъекта-службы назначенного системой удостоверения. Это свойство будет предоставлено только для назначаемого системой удостоверения.

tenantId

string (uuid)

Идентификатор клиента назначенного системой удостоверения. Это свойство будет предоставлено только для назначаемого системой удостоверения.

type

ManagedServiceIdentityType

Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).

userAssignedIdentities

<string,  UserAssignedIdentity>

удостоверения User-Assigned
Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах.

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

ManagedServiceIdentity

Удостоверение управляемой службы ресурса.

location

string

Географическое расположение, в котором находится ресурс

name

string

Имя ресурса

properties.action

StorageTaskAction

Действие задачи хранилища, выполняемая

properties.creationTimeInUtc

string (date-time)

Дата и время создания задачи хранения в формате UTC.

properties.description

string

Текст, описывающий назначение задачи хранения

properties.enabled

boolean

Задача хранилища включена, если задано значение true и отключено, если задано значение false

properties.provisioningState

ProvisioningState

Представляет состояние подготовки задачи хранилища.

properties.taskVersion

integer (int64)

minimum: 1
maximum: 1

Версия задачи хранилища.

systemData

systemData

Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.

tags

object

Теги ресурсов.

type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

StorageTaskAction

Действие задачи хранилища представляет условные операторы и операции, выполняемые на целевых объектах.

Имя Тип Описание
else

ElseCondition

Другой блок операции задачи хранения

if

IfCondition

Если блок задачи хранилища

StorageTaskOperation

Представляет операцию, выполняемую для объекта

Имя Тип Описание
name

StorageTaskOperationName

Операция, выполняемая для объекта.

onFailure

OnFailure

Действие, выполняемое при сбое операции для объекта.

onSuccess

OnSuccess

Действие, выполняемое при успешном выполнении операции для объекта.

parameters

object

Параметры "ключ-значение" для операции.

StorageTaskOperationName

Операция, выполняемая для объекта.

Значение Описание
SetBlobTier
SetBlobTags
SetBlobImmutabilityPolicy
SetBlobLegalHold
SetBlobExpiry
DeleteBlob
UndeleteBlob

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя Тип Описание
createdAt

string (date-time)

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string (date-time)

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.

UserAssignedIdentity

Свойства назначаемого пользователем удостоверения

Имя Тип Описание
clientId

string (uuid)

Идентификатор клиента назначенного удостоверения.

principalId

string (uuid)

Основной идентификатор назначенного удостоверения.