Criar uma tarefa de armazenamento

No portal do Azure, pesquise Tarefas de Armazenamento. Em seguida, em Serviços, selecione Tarefas de armazenamento – Ações de Armazenamento do Azure.

Na página Ações de Armazenamento do Azure | Tarefas de Armazenamento, selecione Criar.

Guia Básico

Na guia Básico, forneça as informações essenciais para a sua conta de armazenamento. A tabela a seguir descreve os campos da guia Conceitos básicos.

A imagem abaixo mostra um exemplo da guia Básico.

Guia Condições

Na guia Condições, defina as condições que devem ser atendidas por cada objeto (contêiner ou blob) e as operações a serem executadas no objeto.

Você deve definir pelo menos uma condição e uma operação. Para adicionar uma cláusula a uma condição, selecione Adicionar nova cláusula. Para adicionar operações, selecione Adicionar nova operação.

A tabela a seguir descreve os campos da guia Condições.

A imagem abaixo mostra um exemplo da guia Condições.

Você pode selecionar condições de visualização para exibir uma lista de blobs que seriam afetados pelas condições que você definiu. Para saber mais, confira Visualizar o efeito das condições.

Guia Atribuições

Uma atribuição identifica uma conta de armazenamento e um subconjunto de objetos nessa conta de destino da tarefa. Uma atribuição também define quando a tarefa é executada e onde os relatórios de execução são armazenados.

Para adicionar uma atribuição, selecione Adicionar atribuição. Esta etapa é opcional. Você não precisa adicionar uma atribuição para criar a tarefa.

A tabela a seguir descreve os campos que aparecem no painel Adicionar atribuição.

selecione a função que você deseja atribuir à identidade gerenciada atribuída pelo sistema da tarefa de armazenamento. Para garantir uma atribuição de tarefa bem-sucedida, use funções que tenham permissões de Proprietário de Dados de Blob. Para saber mais, confira as funções do Azure para tarefas de armazenamento

A imagem a seguir mostra um exemplo do painel Adicionar atribuição.

Guia marcas

Na guia Marcas, você pode especificar marcas do Resource Manager para ajudar a organizar os recursos do Azure. Para mais informações, consulte Recursos de marca, grupos de recursos e assinaturas para organização lógica.

A imagem a seguir mostra uma configuração padrão com as propriedades de tag de índice de uma nova conta de armazenamento.

Guia Examinar + criar

Quando você navega para a guia Revisar + criar, o Azure executa a validação nas configurações da tarefa de armazenamento que você escolheu. Se a validação for aprovada, você pode continuar a criar a tarefa de armazenamento.

Se a validação falhar, o portal indicará quais configurações precisam ser modificadas.

A imagem a seguir mostra os dados da guia Examinar antes da criação de uma tarefa de armazenamento.

1. Primeiro, instale os módulos necessários do PowerShell. Consulte Instalar o módulo do PowerShell

2. Defina uma condição usando JSON. Uma condição é um conjunto de uma ou mais cláusulas. Cada cláusula contém uma propriedade, um valor e um operador. Para saber mais, consulte as condições da tarefa de armazenamento.

   $condition = "<condition-json>"
   

3. Defina cada operação usando o comando New-AzStorageActionTaskOperationObject . Para saber mais, confira as operações de tarefa de armazenamento

    $operation = New-AzStorageActionTaskOperationObject `
    -Name "<operation-name>" `
    -Parameter @{"<parameter-name>"= "<parameter-value"} `
    -OnFailure break `
    -OnSuccess continue
   
   

4. Crie uma tarefa de armazenamento usando o comando New-AzStorageActionTask e passe todas as condições e operações que você definir. O comando a seguir cria uma tarefa de armazenamento e habilita a identidade gerenciada pelo sistema da tarefa. As atribuições de tarefa de armazenamento usam permissões aplicadas a essa identidade gerenciada pelo sistema para autorizar o acesso.

   $task = New-AzStorageActionTask `
   -Name "<storage-task-name>" `
   -ResourceGroupName "<resource-group>" `
   -Location "<location>" `
   -Enabled `
   -Description "<description>" `
   -IfCondition $condition `
   -IfOperation $operation `
   -EnableSystemAssignedIdentity:$true
   

   Se você quiser atribuições para autorizar usando uma identidade gerenciada atribuída pelo usuário, deverá fornecer essa identidade como um parâmetro para o comando New-AzStorageActionTask. O comando a seguir cria uma tarefa de armazenamento e especifica uma identidade gerenciada atribuída pelo usuário. As atribuições de tarefa de armazenamento usam permissões aplicadas à identidade gerenciada atribuída pelo usuário para autorizar o acesso.

   $managedIdentity = Get-AzUserAssignedIdentity -ResourceGroupName <resource-group> -Name <user-assigned-managed-identity-name>
   
   $task = New-AzStorageActionTask `
   -Name "<storage-task-name>" `
   -ResourceGroupName "<resource-group>" `
   -Location "<location>" `
   -Enabled `
   -Description "<description>" `
   -IfCondition $condition `
   -IfOperation $operation `
   -UserAssignedIdentity $managedIdentity.Id
   

   Para saber como criar uma atribuição usando o PowerShell, consulte Criar e gerenciar uma atribuição de tarefa de armazenamento.

1. Defina uma condição usando JSON. Uma condição é um conjunto de uma ou mais cláusulas. Cada cláusula contém uma propriedade, um valor e um operador. Para saber mais, consulte as condições da tarefa de armazenamento.

   conditionclause="<condition-json>"
   

   Dica

   A CLI do Azure usa sintaxe abreviada. A sintaxe abreviada é uma representação simplificada de uma cadeia de caracteres JSON. Para saber mais, confira Como usar a sintaxe abreviada com a CLI do Azure.

2. Crie uma tarefa de armazenamento usando o comando az storage-actions task create e passe para dentro uma expressão formatada em JSON das condições e operações. Este exemplo identifica blobs na camada fria e as transfere para a camada quente. Todos os outros blobs são excluídos. O comando a seguir cria uma tarefa de armazenamento e especifica uma identidade gerenciada atribuída pelo sistema. As atribuições de tarefa de armazenamento usam permissões aplicadas à identidade gerenciada atribuída pelo sistema para autorizar o acesso.

   az storage-actions task create -g myresourcegroup -n mystoragetask \ 
   --identity "{type:SystemAssigned}" \
   --action "{if:{condition:'[[equals(AccessTier,'/Cool'/)]]',operations:[{name:'SetBlobTier',parameters:{tier:'Hot'},onSuccess:'continue',onFailure:'break'}]},else:{operations:[{name:'DeleteBlob',onSuccess:'continue',onFailure:'break'}]}}" --description myStorageTask --enabled true
   

   Se você quiser autorizar atribuições usando uma identidade gerenciada atribuída pelo usuário, deverá fornecer essa identidade como um parâmetro para o comando az storage-actions task create. O comando a seguir cria uma tarefa de armazenamento e especifica uma identidade gerenciada atribuída pelo usuário. As atribuições de tarefa de armazenamento usam permissões aplicadas à identidade gerenciada atribuída pelo usuário para autorizar o acesso.

   $identityId=az identity show --name <user-assigned-managed-identity-name> \
   --resource-group <resource-group> --query "id"
   
   az storage-actions task create -g myresourcegroup -n mystoragetask \ 
   --identity $identityId \
   --action "{if:{condition:'[[equals(AccessTier,'/Cool'/)]]',operations:[{name:'SetBlobTier',parameters:{tier:'Hot'},onSuccess:'continue',onFailure:'break'}]},else:{operations:[{name:'DeleteBlob',onSuccess:'continue',onFailure:'break'}]}}" --description myStorageTask --enabled true
   

   Para saber mais sobre operações, consulte operações de tarefa de armazenamento.

   Para saber como criar uma atribuição usando a CLI do Azure, consulte Criar e gerenciar uma atribuição de tarefa de armazenamento.

Inclua um snippet semelhante ao seguinte em seu modelo Bicep. Este exemplo define uma política de imutabilidade em documentos do Word.

Para obter um exemplo completo, consulte Início Rápido: Criar uma tarefa de armazenamento com o Bicep.

resource storageTask 'Microsoft.StorageActions/storageTasks@2023-01-01' = {
  name: storageTaskName
  location: 'westus'
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    action: {
      if: {
        condition: '[[endsWith(Name, \'.docx\')]]'
        operations: [
         {
            name: 'SetBlobImmutabilityPolicy'
            onSuccess: 'continue'
            onFailure: 'break'
            parameters: {
              untilDate: '2025-06-20T20:34:00'
              mode: 'locked'
            }
         }
        ]
      }

    }
    description: 'My storage task'
    enabled: true
  }
}

Inclua um snippet JSON semelhante ao seguinte no modelo de Resource Manager do Azure. Este exemplo define uma política de imutabilidade em documentos do Word.

Para obter um exemplo completo, consulte Início Rápido: Criar uma tarefa de armazenamento com um modelo do ARM.

 "resources": [
    {
      "type": "Microsoft.StorageActions/storageTasks",
      "apiVersion": "2023-01-01",
      "name": "mystoragetask",
      "location": "westus",
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "action": {
          "if": {
            "condition": "[[[endsWith(Name, '.docx')]]",
            "operations": [
              {
                "name": "SetBlobImmutabilityPolicy",
                "onSuccess": "continue",
                "onFailure": "break",
                "parameters": {
                  "untilDate": "2025-06-20T20:34:00",
                  "mode": "locked"
                }
              },
            ]
          }
        },
        "description": "my storage task",
        "enabled": true
      }
    }
  ]