Criar e gerenciar uma atribuição de tarefa de armazenamento

Criar uma atribuição a partir do menu de tarefas de armazenamento

Você pode criar uma atribuição no contexto de uma tarefa de armazenamento. Essa opção pode ser conveniente se você for o autor da tarefa e quiser direcionar várias contas de armazenamento. Para cada atribuição, deves identificar a conta de armazenamento que pretendes destinar.

Navegue até a tarefa de armazenamento no portal do Azure e, em Gerenciamento de tarefas de armazenamento, selecione Atribuições.

Na página Atribuições , selecione + Adicionar atribuição e o painel Adicionar atribuição será exibido.

Criar uma atribuição a partir do menu da conta de armazenamento

Você também pode criar uma atribuição no contexto de uma conta de armazenamento. Essa opção pode ser conveniente se você quiser usar uma tarefa existente para processar objetos em sua conta de armazenamento. Para cada atribuição, você identificará a tarefa de armazenamento que deseja atribuir à sua conta.

Navegue até a conta de armazenamento no portal do Azure e, em Gerenciamento de dados, selecione Tarefas de armazenamento.

Na página Tarefas de armazenamento , selecione o separador Atribuição de tarefas , selecione + Criar atribuição e, em seguida, selecione + Adicionar atribuição.

O painel Adicionar atribuição é exibido.

Selecione um escopo

Na seção Selecionar escopo, selecione uma assinatura e atribua um nome à atribuição. Em seguida, selecione a conta de armazenamento que você deseja segmentar.

Se você abriu o painel Adicionar atribuição no contexto da conta de armazenamento, selecionará uma tarefa de armazenamento em vez da conta de armazenamento.

Para obter uma descrição de cada propriedade, consulte Configurações de atribuição.

Adicionar uma atribuição de função

Na seção Atribuição de função, na lista suspensa Função, selecione o papel que pretende atribuir à identidade gerida 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 necessárias para atribuir tarefas.

Para obter uma descrição de cada propriedade, consulte Configurações de atribuição.

Adicionar um filtro

Na seção Filtrar objetos , escolha se deseja direcionar um subconjunto de blobs com base em um filtro. Os filtros ajudam a restringir o escopo de execução. Se desejar que a tarefa avalie todos os contêineres e blobs de uma conta, selecione a opção Não filtrar . O exemplo a seguir usa um filtro para direcionar somente blobs que existem em um contêiner chamado mycontainer.

Para obter uma descrição de cada propriedade, consulte Configurações de atribuição.

Definir o gatilho

Na seção Detalhes do gatilho , selecione com que frequência você deseja que essa tarefa seja executada. Você pode optar por executar essa tarefa apenas uma vez ou executar a tarefa recorrentemente. Se você decidir executar essa tarefa de forma recorrente, escolha uma hora de início e de término e especifique o número de dias entre cada execução. Você também pode especificar onde deseja armazenar os relatórios de execução.

Para obter uma descrição de cada propriedade, consulte Configurações de atribuição.

Salvar a atribuição

Selecione o botão Adicionar para criar a atribuição.

O painel Adicionar atribuição é fechado. Quando a implantação estiver concluída, a atribuição aparecerá na página Atribuições . Se não encontrar a tarefa na página, selecione o botão Atualizar.

Ativar uma atribuição

A atribuição está desativada por padrão. Para habilitar a atribuição para que ela seja agendada para ser executada, marque a caixa de seleção que aparece ao lado da atribuição e selecione Habilitar.

Depois que a tarefa é executada, um relatório de execução é gerado e, em seguida, armazenado no contêiner que você especificou quando criou a atribuição. Para obter mais informações sobre esse relatório, bem como sobre como exibir métricas que capturam o número de objetos de destino, o número de operações tentadas e o número de operações bem-sucedidas, consulte Analisar execuções de tarefas de armazenamento.

Editar uma atribuição

Uma atribuição torna-se um subrecurso da conta de armazenamento de destino. Portanto, depois de criar a atribuição, você pode editar apenas a frequência de execução. Os outros campos de uma atribuição ficam em modo apenas leitura. A opção Execução única (apenas uma vez) torna-se somente leitura também.

• Para editar a frequência de execução de uma atribuição no contexto de uma tarefa de armazenamento, navegue até a tarefa de armazenamento no portal do Azure e, em Gerenciamento de tarefas de armazenamento, selecione Atribuições.

• Para editar a frequência de execução de uma atribuição no contexto de uma conta de armazenamento, navegue até a conta de armazenamento no portal do Azure e, em Gerenciamento de dados, selecione Tarefas de armazenamento.

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

2. Especifique com que frequência pretende que a tarefa seja executada. Você pode optar por executar uma tarefa apenas uma vez ou executar a tarefa recorrentemente. Se você decidir executar essa tarefa de forma recorrente, especifique uma hora de início e de término e especifique o número de dias entre cada execução. Você também pode especificar onde deseja armazenar os relatórios de execução. O exemplo a seguir cria uma variável para valores de gatilho.

   $startTime = $startTime = (Get-Date).AddMinutes(10) 
   $reportPrefix = "my-storage-task-report"
   $triggerType = RunOnce
   $targetPrefix = "mycontainer/"
   

3. Obtenha a tarefa de armazenamento que você deseja incluir em sua atribuição usando o comando Get-AzStorageActionTask .

   $task = Get-AzStorageActionTask -Name <"storage-task-name"> -ResourceGroupName "<resource-group>"
   

4. Crie uma atribuição de tarefa de armazenamento usando o New-AzStorageTaskAssignment comando. A atribuição a seguir tem como alvo o mycontainer contêiner de uma conta chamada mystorageaccount. Esta atribuição especifica que a tarefa será executada apenas uma vez e salvará os relatórios de execução em uma pasta chamada storage-tasks-report. A tarefa está programada para ser executada dentro de 10 minutos a partir do momento presente.

   New-AzStorageTaskAssignment `
   -ResourceGroupName "<resource-group>" `
   -AccountName "<storage-account-name>" `
   -name "<storage-task-assignment-name>" `
   -TaskId $task.ID `
   -ReportPrefix $reportPrefix `
   -TriggerType $triggerType `
   -StartOn $startTime.ToUniversalTime() `
   -Description "<description>" `
   -Enabled:$true `
   -TargetPrefix $targetPrefix `
   -TargetExcludePrefix ""
   

5. Dê permissão à tarefa de armazenamento para executar operações na conta de armazenamento de destino atribuindo uma função à identidade gerenciada. Você pode escolher o tipo de identidade gerenciada (atribuída pelo sistema ou atribuída pelo usuário) ao criar a tarefa de armazenamento.

   Os comandos a seguir atribuem a função de Storage Blob Data Owner à identidade gerida atribuída pelo sistema para a tarefa de armazenamento.

   New-AzRoleAssignment `
   -ResourceGroupName "<resource-group>" `
   -ResourceName "<storage-account-name>" `
   -ResourceType "Microsoft.Storage/storageAccounts" `
   -ObjectId $task.IdentityPrincipalId  `
   -RoleDefinitionName "Storage Blob Data Owner"
   

   Os comandos a seguir atribuem a função Storage Blob Data Owner a uma identidade gerenciada atribuída pelo usuário.

   $managedIdentity = Get-AzUserAssignedIdentity -ResourceGroupName <resource-group> -Name <user-assigned-managed-identity-name>
   
   New-AzRoleAssignment `
   -ResourceGroupName "<resource-group>" `
   -ResourceName "<storage-account-name>" `
   -ResourceType "Microsoft.Storage/storageAccounts" `
   -ObjectId $managedIdentity.Id  `
   -RoleDefinitionName "Storage Blob Data Owner"
   

Criar uma atribuição usando a CLI do Azure

1. Especifique com que frequência pretende que a tarefa seja executada. Você pode optar por executar uma tarefa apenas uma vez ou executar a tarefa recorrentemente. Se você decidir executar essa tarefa de forma recorrente, especifique uma hora de início e de término e especifique o número de dias entre cada execução. Você também pode especificar onde deseja armazenar os relatórios de execução. O seguinte cria uma variável de cadeia de caracteres formatada em JSON que especifica o nome do contêiner, a frequência de execução da tarefa (RunOnce) e o tempo para executar o relatório.

      current_datetime=$(date +"%Y-%m-%dT%H:%M:%S")
      executioncontextvariable="{target:{prefix:[mycontainer/],excludePrefix:[]},trigger:{type:'RunOnce',parameters:{startOn:'"${current_datetime}"'}}}"
   

   A cadeia de caracteres usada em executioncontextvariable é expressa através de 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. Obtenha o ID da tarefa de armazenamento que pretende incluir na sua atribuição utilizando o comando az storage-actions task show e, em seguida, consultando a propriedade id.

 id=$(az storage-actions task show -g "<resource-group>" -n "<storage-task-name>" --query "id")

3. Crie uma atribuição de tarefa de armazenamento usando o az storage account task-assignment create comando.

   az storage account task-assignment create \
      -g '<resource-group>' \
      -n '<storage-task-assignment-name>' \
      --account-name '<storage-account-name>' \
      --description '<description>' \
      --enabled true \
      --task-id $id \
      --execution-context $executioncontextvariable \
      --report "{prefix:storage-tasks-report}"
   

4. Dê permissão à tarefa de armazenamento para executar operações na conta de armazenamento de destino atribuindo uma função à identidade gerenciada. Você pode escolher o tipo de identidade gerenciada (atribuída pelo sistema ou atribuída pelo usuário) ao criar a tarefa de armazenamento.

   Os comandos a seguir atribuem a função de Storage Blob Data Owner à identidade gerida atribuída pelo sistema para a tarefa de armazenamento.

   $storageAccountID=az storage account show --name <storage-account-name> --resource-group <resource-group> --query "id"
   $roleDefinitionId="b7e6dc6d-f1e8-4753-8033-0f276bb0955b" \
   
   
   az role assignment create \
      --assignee-object-id $principalID \
      --scope $storageAccountID \
      --role $roleDefinitionId \
      --description "My role assignment" 
   

   Os comandos a seguir atribuem a função Storage Blob Data Owner a uma identidade gerenciada atribuída pelo usuário.

   $storageAccountID=az storage account show --name <storage-account-name> --resource-group <resource-group> --query "id"
   $roleDefinitionId="b7e6dc6d-f1e8-4753-8033-0f276bb0955b"
   $identityId=az identity show --name <user-assigned-managed-identity-name> \
   --resource-group <resource-group> --query "id"
   
    az role assignment create \
    --assignee-object-id $identityId 
      --role $roleDefinitionId \
      --description "My role assignment" 
   

Inclua um trecho semelhante ao seguinte no seu modelo Bicep.

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-02-01' = {
  name: 'mystorageaccount'
  location: 'westus'
  kind: 'StorageV2'
  sku: {
    name: 'Standard_LRS'
  }
}

resource storageAccountName_storageTaskAssignment 'Microsoft.Storage/storageAccounts/storageTaskAssignments@2023-05-01' = {
  parent: storageAccount
  name: 'mystoragetaskassignment'
  properties: {
    taskId: '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroup/providers/Microsoft.StorageActions/storageTasks/mystoragetask'
    enabled: true
    executionContext: {
      target: {
        prefix: [
          'mycontainer/'
        ]
        excludePrefix: []
      }
      trigger: {
        type: 'RunOnce'
        parameters: {
          startOn: '2025-04-20T21:34:00'
        }
      }
    }
    report: {
      prefix: 'storage-tasks-report'
    }
    description: 'mystoragetaskassignment'
  }
}

Inclua um trecho JSON semelhante ao seguinte em seu modelo do Azure Resource Manager.

  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-02-01",
      "name": "mystorageaccount",
      "location": "westus",
      "kind": "StorageV2",
      "sku": {
        "name": "Standard_LRS"
      }
    },
    {
      "type": "Microsoft.Storage/storageAccounts/storageTaskAssignments",
      "apiVersion": "2023-05-01",
      "name": "storagetaskassignmentname",
      "properties": {
        "taskId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroup/providers/Microsoft.StorageActions/storageTasks/mystoragetask",
        "enabled": true,
        "executionContext": {
          "target": {
            "prefix": [
              "mycontainer/"
            ],
            "excludePrefix": []
          },
          "trigger": {
            "type": "RunOnce",
            "parameters": {
              "startOn": "2025-04-20T21:34:00"
            }
          }
        },
        "report": {
          "prefix": "storage-tasks-report"
        },
        "description": "[parameters('storageTaskAssignmentDescription')]"
      },
      "dependsOn": [
        "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroup/providers/Microsoft.Storage/storageAccounts/mystorageaccount"
      ]
    }
  ]