Criar uma tarefa de armazenamento

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

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

Separador Informações Básicas

Na guia Noções básicas, forneça as informações essenciais para sua tarefa de armazenamento. A tabela a seguir descreve os campos na guia Noções básicas .

A imagem a seguir mostra um exemplo da guia Noções básicas .

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 na guia Condições .

A imagem a seguir 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, consulte Visualizar o efeito das condições.

Guia Atribuições

Uma atribuição identifica uma conta de armazenamento e um subconjunto de objetos nessa conta que a tarefa terá como destino. 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. Este passo é opcional. Não é necessário 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 as permissões de Proprietário de Dados de Blob. Para saber mais, consulte Funções do Azure para tarefas de armazenamento

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

Separador Etiquetas

No separador Etiquetas, pode especificar etiquetas do Resource Manager para ajudar a organizar os recursos do Azure. Para obter mais informações, veja Etiquetar recursos, grupos de recursos e subscrições para organização lógica.

A imagem a seguir mostra uma configuração padrão das propriedades da marca de índice para uma nova conta de armazenamento.

Separador Rever + 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ê poderá continuar a criar a tarefa de armazenamento.

Se a validação falhar, o portal indica que definições têm de ser modificadas.

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

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

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

   $condition = "<condition-json>"
   

3. Defina cada operação usando o comando New-AzStorageActionTaskOperationObject . Para saber mais, consulte Operações de tarefas 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 tarefas 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 desejar que as atribuições sejam autorizadas usando uma identidade gerenciada atribuída pelo usuário, você 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 ao usuário. As atribuições de tarefas 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 uma coleção de uma ou mais cláusulas. Cada cláusula contém uma propriedade, um valor e um operador. Para saber mais, consulte Condições da tarefa de armazenamento.

   conditionclause="<condition-json>"
   

   Sugestão

   A CLI do Azure usa sintaxe abreviada. A sintaxe abreviada é uma representação simplificada de uma cadeia de caracteres JSON. Para saber mais, consulte 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 uma expressão formatada em JSON das condições e operações. Este exemplo localiza blobs na camada fria e os move 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 ao sistema. As atribuições de tarefas 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 desejar que as atribuições sejam autorizadas usando uma identidade gerenciada atribuída pelo usuário, você 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 ao usuário. As atribuições de tarefas 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 tarefas 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 trecho semelhante ao seguinte no seu modelo Bicep. Este exemplo define uma política de imutabilidade em documentos do Word.

Para obter um exemplo completo, consulte Guia de 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 trecho JSON semelhante ao seguinte em seu modelo do Azure Resource Manager. Este exemplo define uma política de imutabilidade em documentos do Word.

Para obter um exemplo completo, consulte Guia de início rápido: criar uma tarefa de armazenamento com um modelo 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
      }
    }
  ]