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

Criar uma atribuição no menu da tarefa 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, você identificará a conta de armazenamento que deseja direcionar.

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 no 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 seguida, em Gerenciamento de dados, selecione Tarefas de armazenamento.

Na página Tarefas de Armazenamento , selecione a guia Atribuição de Tarefa , selecione + Criar atribuição e, em seguida, selecione + Adicionar atribuição.

O painel Adicionar atribuição é exibido.

Selecionar um escopo

Na seção Selecionar escopo, selecione uma assinatura e nomeie a atribuição. Em seguida, selecione a conta de armazenamento que você deseja direcionar.

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 As 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 a função que deseja atribuir à identidade gerenciada atribuída 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 necessárias para atribuir tarefas.

Para obter uma descrição de cada propriedade, consulte As 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 da execução. Se você quiser que a tarefa avalie todos os contêineres e blobs em 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 nomeado mycontainer.

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

Definir o gatilho

Na seção Detalhes do gatilho , selecione com que frequência você gostaria que essa tarefa fosse executada. Você pode optar por executar essa tarefa apenas uma vez ou executar a tarefa recorrente. Se você decidir executar essa tarefa de forma recorrente, escolha uma hora de início e 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 As 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 for concluída, a atribuição será exibida na página Atribuições . Se você não vir a atribuição nessa página, selecione o botão Atualizar .

Habilitar uma atribuição

A atribuição é desabilitada por padrão. Para habilitar a atribuição para que ela seja agendada para execução, marque a caixa de seleção que aparece ao lado da atribuição e selecione Habilitar.

Após a execução da tarefa, um relatório de execução é gerado e armazenado no contêiner especificado quando você criou a atribuição. Para obter mais informações sobre esse relatório, bem como como exibir métricas que capturam o número de objetos direcionados, o número de operações tentadas e o número de operações que foram bem-sucedidas, consulte Analisar execuções de tarefa de armazenamento.

Editar uma atribuição

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

• 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 seguida, 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 seguida, em Gerenciamento de dados, selecione tarefas de Armazenamento.

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

2. Especifique com que frequência você gostaria que a tarefa fosse executada. Você pode optar por executar uma tarefa apenas uma vez ou executar a tarefa recorrente. Se você decidir executar essa tarefa de forma recorrente, especifique uma hora de início e 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 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 destino o mycontainer contêiner de uma conta chamada mystorageaccount. Essa atribuição especifica que a tarefa será executada apenas uma vez e salvará relatórios de execução em uma pasta chamada storage-tasks-report. A tarefa está agendada para ser executada daqui a 10 minutos a partir do momento atual.

   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. Conceda à tarefa de armazenamento permissão 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ído pelo sistema ou atribuído pelo usuário) ao criar a tarefa de armazenamento.

   Os comandos a seguir atribuem a função de Storage Blob Data Owner à identidade gerenciada atribuída pelo sistema da 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 você gostaria que a tarefa fosse executada. Você pode optar por executar uma tarefa apenas uma vez ou executar a tarefa recorrente. Se você decidir executar essa tarefa de forma recorrente, especifique uma hora de início e 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. A seguir, 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 no executioncontextvariable é expressa usando a 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. Obtenha a ID da tarefa de armazenamento que você deseja incluir em sua atribuição usando o comando az storage-actions task show e, em seguida, consultando a id propriedade.

 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. Conceda à tarefa de armazenamento permissão 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ído pelo sistema ou atribuído pelo usuário) ao criar a tarefa de armazenamento.

   Os comandos a seguir atribuem a função de Storage Blob Data Owner à identidade gerenciada atribuída pelo sistema da 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 snippet semelhante ao seguinte em 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 snippet JSON semelhante ao seguinte no modelo de Resource Manager do Azure.

  "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"
      ]
    }
  ]