Compartilhar via


Storage Tasks - Create

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

OK -- Atualize a tarefa de armazenamento com as mesmas propriedades especificadas no corpo da solicitação.

201 Created

StorageTask

OK – Criar tarefa de armazenamento com as mesmas propriedades especificadas no corpo da solicitação.

202 Accepted

Aceito – Criar ou atualizar solicitação aceita; a operação será concluída de forma assíncrona.

Cabeçalhos

Location: string

Other Status Codes

ErrorResponse

Resposta de erro que descreve por que a operação falhou.

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

{
  "location": "westus",
  "identity": {
    "type": "SystemAssigned"
  },
  "properties": {
    "enabled": true,
    "description": "My Storage task",
    "action": {
      "if": {
        "condition": "[[equals(AccessTier, 'Cool')]]",
        "operations": [
          {
            "name": "SetBlobTier",
            "parameters": {
              "tier": "Hot"
            },
            "onSuccess": "continue",
            "onFailure": "break"
          }
        ]
      },
      "else": {
        "operations": [
          {
            "name": "DeleteBlob",
            "onSuccess": "continue",
            "onFailure": "break"
          }
        ]
      }
    }
  }
}

Resposta de exemplo

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
{
  "id": "/subscriptions/c86a9c18-8373-41fa-92d4-1d7bdc16977b/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
  "name": "mytask1",
  "type": "Microsoft.StorageActions/storageTasks",
  "location": "westus",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "2fd475e8-8923-4597-842f-7ce1adfc6c4a",
    "tenantId": "b4a2005c-32c1-434c-bbf0-ff486912fc75"
  },
  "properties": {
    "enabled": true,
    "description": "Storage task",
    "action": {
      "if": {
        "condition": "[[equals(AccessTier, 'Cool')]]",
        "operations": [
          {
            "name": "SetBlobTier",
            "parameters": {
              "tier": "Hot"
            },
            "onSuccess": "continue",
            "onFailure": "break"
          }
        ]
      },
      "else": {
        "operations": [
          {
            "name": "DeleteBlob",
            "onSuccess": "continue",
            "onFailure": "break"
          }
        ]
      }
    },
    "taskVersion": 1,
    "provisioningState": "Succeeded",
    "creationTimeInUtc": "2023-07-06T00:24:59.1441663Z"
  }
}
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
{
  "id": "/subscriptions/c86a9c18-8373-41fa-92d4-1d7bdc16977b/resourceGroups/res4228/providers/Microsoft.StorageActions/storageTasks/mytask1",
  "name": "mytask1",
  "type": "Microsoft.StorageActions/storageTasks",
  "location": "westus",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "2fd475e8-8923-4597-842f-7ce1adfc6c4a",
    "tenantId": "b4a2005c-32c1-434c-bbf0-ff486912fc75"
  },
  "properties": {
    "enabled": true,
    "description": "Storage task",
    "action": {
      "if": {
        "condition": "[[equals(AccessTier, 'Cool')]]",
        "operations": [
          {
            "name": "SetBlobTier",
            "parameters": {
              "tier": "Hot"
            },
            "onSuccess": "continue",
            "onFailure": "break"
          }
        ]
      },
      "else": {
        "operations": [
          {
            "name": "DeleteBlob",
            "onSuccess": "continue",
            "onFailure": "break"
          }
        ]
      }
    },
    "taskVersion": 1,
    "provisioningState": "Succeeded",
    "creationTimeInUtc": "2023-07-06T00:24:59.1441663Z"
  }
}
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

O tipo de identidade que criou o recurso.

Valor Description
Application
Key
ManagedIdentity
User

ElseCondition

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

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

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

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

IfCondition

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

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

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

Valor Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

onFailure

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

Valor Description
break

onSuccess

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

Valor Description
continue

ProvisioningState

Representa o estado de provisionamento da tarefa de armazenamento.

Valor Description
Accepted
Canceled
Creating
Deleting
Failed
Succeeded
ValidateSubscriptionQuotaBegin
ValidateSubscriptionQuotaEnd

StorageTask

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

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

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

A operação a ser executada no objeto.

Valor Description
DeleteBlob
SetBlobExpiry
SetBlobImmutabilityPolicy
SetBlobLegalHold
SetBlobTags
SetBlobTier
UndeleteBlob

systemData

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

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.