Partilhar 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á tiver sido 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á tiver sido 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 do URI

Name Em Necessá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 das tarefas de armazenamento devem ter entre 3 e 18 caracteres e usar apenas números e letras minúsculas.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

minLength: 1

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

Corpo do Pedido

Name Necessário Tipo Description
identity True

ManagedServiceIdentity

A identidade do serviço gerenciado do recurso.

location True

string

A geolocalização onde o recurso vive

properties.action True

StorageTaskAction

A ação da tarefa de armazenamento que é executada

properties.description True

string

Texto que descreve a finalidade da tarefa de armazenamento

properties.enabled True

boolean

A Tarefa de Armazenamento é ativada quando definida como true e desativada quando definida como false

tags

object

Tags de recursos.

Respostas

Name Tipo Description
200 OK

StorageTask

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

201 Created

StorageTask

Operação de criação de 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 OAuth2 do Azure Active Directory.

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

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

PutStorageTask

Pedido de amostra

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 da amostra

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

Definições

Name Description
createdByType

O tipo de identidade que criou o recurso.

ElseCondition

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

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

IfCondition

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

ManagedServiceIdentity

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

ManagedServiceIdentityType

Tipo de identidade de serviço gerenciado (onde 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 referentes à 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
User
Application
ManagedIdentity
Key

ElseCondition

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

Name Tipo Description
operations

StorageTaskOperation[]

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

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

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

Name Tipo Description
error

ErrorDetail

O objeto de erro.

IfCondition

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

Name Tipo Description
condition

string

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

operations

StorageTaskOperation[]

Lista de operações a executar quando o predicado da condição satisfaz.

ManagedServiceIdentity

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

Name Tipo Description
principalId

string (uuid)

O ID da entidade de serviço da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema.

tenantId

string (uuid)

O ID do locatário da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema.

type

ManagedServiceIdentityType

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

userAssignedIdentities

<string,  UserAssignedIdentity>

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

ManagedServiceIdentityType

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

Valor Description
None
SystemAssigned
UserAssigned
SystemAssigned,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
ValidateSubscriptionQuotaBegin
ValidateSubscriptionQuotaEnd
Accepted
Creating
Succeeded
Deleting
Canceled
Failed

StorageTask

Representa a tarefa de armazenamento.

Name Tipo Description
id

string (arm-id)

ID de recurso totalmente qualificado 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 geolocalização onde o recurso vive

name

string

O nome do recurso

properties.action

StorageTaskAction

A ação da tarefa de armazenamento que é executada

properties.creationTimeInUtc

string (date-time)

A data e 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 é ativada quando definida como true e desativada 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 contendo informações createdBy e modifiedBy.

tags

object

Tags de recursos.

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.

Name Tipo Description
else

ElseCondition

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

if

IfCondition

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

StorageTaskOperation

Representa uma operação a ser executada no objeto

Name 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
SetBlobTier
SetBlobTags
SetBlobImmutabilityPolicy
SetBlobLegalHold
SetBlobExpiry
DeleteBlob
UndeleteBlob

systemData

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

Name 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

Name Tipo Description
clientId

string (uuid)

O ID do cliente da identidade atribuída.

principalId

string (uuid)

O ID principal da identidade atribuída.