Storage Tasks - Create

Serviço:
Storage Actions
Versão da API:
2023-01-01

Cria de forma assíncrona um novo recurso de tarefa de armazenamento com os parâmetros especificados. Se uma tarefa de armazenamento já estiver criada e uma solicitação de criação subsequente for emitida com propriedades diferentes, as propriedades da tarefa de armazenamento serão atualizadas. Se uma tarefa de armazenamento já estiver criada e uma solicitação de criação ou atualização subsequente for emitida com exatamente o mesmo conjunto de propriedades, a solicitação terá êxito.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
storageTaskName
 path True

string

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

O nome da tarefa de armazenamento dentro do grupo de recursos especificado. Os nomes de tarefa de armazenamento devem ter entre 3 e 18 caracteres de comprimento e usar apenas números e letras minúsculas.
subscriptionId
 path True

string (uuid)

A ID da assinatura de destino. O valor deve ser uma UUID.
api-version
 query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Obrigatório Tipo Description
identity True

ManagedServiceIdentity

A identidade do serviço gerenciado do recurso.
location True

string

A localização geográfica onde o recurso reside
properties.action True

StorageTaskAction

A ação da tarefa de armazenamento executada
properties.description True

string

Texto que descreve a finalidade da tarefa de armazenamento
properties.enabled True

boolean

A Tarefa de Armazenamento é habilitada quando definida como true e desabilitada quando definida como false
tags

object

Marcas de recurso.

Respostas

Nome Tipo Description
200 OK

StorageTask

Operação de atualização do recurso 'StorageTask' bem-sucedida
201 Created

StorageTask

Operação de criação do recurso 'StorageTask' bem-sucedida

Cabeçalhos

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

Operação de recurso aceita.

Cabeçalhos

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

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

PutStorageTask

Solicitação de exemplo

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
  }
}

Resposta de exemplo

Código de status:
200 
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
  }
}
Código de status:
201 
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
  }
}
Código de status:
202 
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

Definições

Nome Description
createdByType

O tipo de identidade que criou o recurso.
ElseCondition

O outro bloco da operação de tarefa de armazenamento
ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta de erro
IfCondition

O bloco if da operação de tarefa de armazenamento
ManagedServiceIdentity

Identidade de serviço gerenciada (identidades atribuídas pelo sistema e/ou pelo usuário)
ManagedServiceIdentityType

Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).
OnFailure

Ação a ser tomada quando a operação falhar para um objeto.
OnSuccess

Ação a ser tomada quando a operação for bem-sucedida para um objeto.
ProvisioningState

Representa o estado de provisionamento da tarefa de armazenamento.
StorageTask

Representa a Tarefa de Armazenamento.
StorageTaskAction

A ação da tarefa de armazenamento representa instruções condicionais e operações a serem executadas em objetos de destino.
StorageTaskOperation

Representa uma operação a ser executada no objeto
StorageTaskOperationName

A operação a ser executada no objeto.
systemData

Metadados relativos à criação e última modificação do recurso.
UserAssignedIdentity

Propriedades de identidade atribuídas pelo usuário

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

ElseCondition

Objeto

O outro bloco da operação de tarefa de armazenamento

Nome Tipo Description
operations

StorageTaskOperation[]

Lista de operações a serem executadas no outro bloco

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

IfCondition

Objeto

O bloco if da operação de tarefa de armazenamento

Nome Tipo Description
condition

string

Predicado de condição para avaliar cada objeto. Consulte https://aka.ms/storagetaskconditions para obter propriedades e operadores válidos.
operations

StorageTaskOperation[]

Lista de operações a serem executadas quando o predicado de condição for atendido.

ManagedServiceIdentity

Objeto

Identidade de serviço gerenciada (identidades atribuídas pelo sistema e/ou pelo usuário)

Nome Tipo Description
principalId

string (uuid)

A ID da entidade de serviço da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema.
tenantId

string (uuid)

A ID do locatário da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema.
type

ManagedServiceIdentityType

Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).
userAssignedIdentities

<string,  UserAssignedIdentity>

Identidades de User-Assigned
O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações.

ManagedServiceIdentityType

Enumeração

Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).

Valor Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

OnFailure

Enumeração

Ação a ser tomada quando a operação falhar para um objeto.

Valor Description
break

OnSuccess

Enumeração

Ação a ser tomada quando a operação for bem-sucedida para um objeto.

Valor Description
continue

ProvisioningState

Enumeração

Representa o estado de provisionamento da tarefa de armazenamento.

Valor Description
ValidateSubscriptionQuotaBegin
ValidateSubscriptionQuotaEnd
Accepted
Creating
Succeeded
Deleting
Canceled
Failed

StorageTask

Objeto

Representa a Tarefa de Armazenamento.

Nome Tipo Description
id

string (arm-id)

ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity

ManagedServiceIdentity

A identidade do serviço gerenciado do recurso.
location

string

A localização geográfica onde o recurso reside
name

string

O nome do recurso
properties.action

StorageTaskAction

A ação da tarefa de armazenamento executada
properties.creationTimeInUtc

string (date-time)

A data e a hora de criação da tarefa de armazenamento em UTC.
properties.description

string

Texto que descreve a finalidade da tarefa de armazenamento
properties.enabled

boolean

A Tarefa de Armazenamento é habilitada quando definida como true e desabilitada quando definida como false
properties.provisioningState

ProvisioningState

Representa o estado de provisionamento da tarefa de armazenamento.
properties.taskVersion

integer (int64)

minimum: 1
maximum: 1

Versão da tarefa de armazenamento.
systemData

systemData

Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
tags

object

Marcas de recurso.
type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

StorageTaskAction

Objeto

A ação da tarefa de armazenamento representa instruções condicionais e operações a serem executadas em objetos de destino.

Nome Tipo Description
else

ElseCondition

O outro bloco da operação de tarefa de armazenamento
if

IfCondition

O bloco if da operação de tarefa de armazenamento

StorageTaskOperation

Objeto

Representa uma operação a ser executada no objeto

Nome Tipo Description
name

StorageTaskOperationName

A operação a ser executada no objeto.
onFailure

OnFailure

Ação a ser tomada quando a operação falhar para um objeto.
onSuccess

OnSuccess

Ação a ser tomada quando a operação for bem-sucedida para um objeto.
parameters

object

Parâmetros chave-valor para a operação.

StorageTaskOperationName

Enumeração

A operação a ser executada no objeto.

Valor Description
SetBlobTier
SetBlobTags
SetBlobImmutabilityPolicy
SetBlobLegalHold
SetBlobExpiry
DeleteBlob
UndeleteBlob

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

UserAssignedIdentity

Objeto

Propriedades de identidade atribuídas pelo usuário

Nome Tipo Description
clientId

string (uuid)

A ID do cliente da identidade atribuída.
principalId

string (uuid)

A ID da entidade de segurança da identidade atribuída.