Habilitar os relatórios de estoque de blobs do Armazenamento do Azure

O recurso de inventário de blobs do Armazenamento do Azure fornece uma visão geral dos seus contêineres, blobs, instantâneos e versões de blob em uma conta de armazenamento. Use o relatório de inventário para entender vários atributos de blobs e contêineres, como o tamanho total dos dados, a idade, o status de criptografia, a política de imutabilidade, a responsabilidade legal e assim por diante. O relatório fornece uma visão geral dos seus dados para que eles atendam aos requisitos de negócios e de conformidade.

Para saber mais sobre os relatórios de inventário de blob, consulte Inventário de blob do Armazenamento do Azure.

Habilite os relatórios de inventário de blobs adicionando uma política com uma ou mais regras à sua conta de armazenamento. Adicione, edite ou remova uma política usando o portal do Azure.

Habilitar relatórios de inventário

Portal

1. Entre no portal do Azure para começar.

2. Localize sua conta de armazenamento e exiba a visão geral dela.

3. Em Gerenciamento de dados, selecione Inventário de blob.

4. Selecione Adicionar sua primeira regra de inventário.

   A página Adicionar uma regra é exibida.

5. Na página Adicionar uma regra, dê um nome a nova regra.

6. Escolha o contêiner que armazenará relatórios de inventário.

7. Em Tipo de objeto para inventário, selecione criar um relatório para blobs ou contêineres.

   Caso selecione Blob, então em Subtipo de blob, selecione os tipos de blob que você quer incluir no seu relatório e se vai incluir versões de blob e/ou snapshots no relatório de inventário.

   Observação

   A opção para incluir versões de blob aparece apenas para contas que não têm o recurso de namespace hierárquico ativado. Versões e instantâneos precisam estar habilitados na conta para salvar uma nova regra com a opção correspondente habilitada.

8. Selecione os campos que você deseja incluir no relatório e o formato dos relatórios.

9. Escolha com que frequência você deseja gerar relatórios.

10. Opcionalmente, adicione uma correspondência de prefixo aos filtros de blob no seu relatório de inventário.

11. Selecione Salvar.

    

PowerShell

Você pode adicionar, editar ou remover uma política usando o módulo do Azure PowerShell.

1. Abra uma janela de comando do Windows PowerShell.

2. Certifique-se de que você tenha o Azure PowerShell mais recente instalado. Consulte Instalar o módulo do Azure PowerShell.

3. Entre na sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela.

   Connect-AzAccount
   

4. Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura como ativa.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   Substitua o valor de espaço reservado <subscription-id> pela ID da sua assinatura.

5. Obtenha o contexto da conta de armazenamento que define a conta de armazenamento que você deseja usar.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • Substitua o valor do espaço reservado <resource-group-name> pelo nome do grupo de recursos.

   • Substitua o valor de espaço reservado <storage-account-name> pelo nome da sua conta de armazenamento.

6. Criar regras de inventário usando o comando New-AzStorageBlobInventoryPolicyRule. Cada regra lista os campos de relatório. Para obter uma lista completa de campos de relatório, consulte Inventário de blob do Armazenamento do Azure.

    $containerName = "my-container"
   
    $rule1 = New-AzStorageBlobInventoryPolicyRule -Name Test1 -Destination $containerName -Disabled -Format Csv -Schedule Daily -PrefixMatch con1,con2 `
                -ContainerSchemaField Name,Metadata,PublicAccess,Last-modified,LeaseStatus,LeaseState,LeaseDuration,HasImmutabilityPolicy,HasLegalHold
   
    $rule2 = New-AzStorageBlobInventoryPolicyRule -Name test2 -Destination $containerName -Format Parquet -Schedule Weekly  -BlobType blockBlob,appendBlob -PrefixMatch aaa,bbb `
                -BlobSchemaField name,Last-Modified,Metadata,LastAccessTime
   
    $rule3 = New-AzStorageBlobInventoryPolicyRule -Name Test3 -Destination $containerName -Format Parquet -Schedule Weekly -IncludeBlobVersion -IncludeSnapshot -BlobType blockBlob,appendBlob -PrefixMatch aaa,bbb `
                -BlobSchemaField name,Creation-Time,Last-Modified,Content-Length,Content-MD5,BlobType,AccessTier,AccessTierChangeTime,Expiry-Time,hdi_isfolder,Owner,Group,Permissions,Acl,Metadata,LastAccessTime
   
    $rule4 = New-AzStorageBlobInventoryPolicyRule -Name test4 -Destination $containerName -Format Csv -Schedule Weekly -BlobType blockBlob -BlobSchemaField Name,BlobType,Content-Length,Creation-Time
   
   

7. Use Set-AzStorageBlobInventoryPolicy para criar uma política de inventário de blob. Passe regras para esse comando pelo parâmetro -Rule.

   $policy = Set-AzStorageBlobInventoryPolicy -StorageAccount $storageAccount -Rule $rule1,$rule2,$rule3,$rule4  
   

CLI do Azure

Adicione, edite ou remova uma política usando a CLI do Azure.

1. Primeiro, abra o Azure Cloud Shellou, se você instalou a CLI do Azure localmente, abra um aplicativo de console de comando, como o Windows PowerShell.

2. Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura como ativa.

      az account set --subscription <subscription-id>
   

   Substitua o valor de espaço reservado <subscription-id> pela ID da sua assinatura.

3. Defina as regras de sua política em um documento JSON. O seguinte mostra o conteúdo de um exemplo de arquivo JSON chamado policy.json.

   {
   "enabled": true,
   "type": "Inventory",
   "rules": [
     {
       "enabled": true,
       "name": "inventoryPolicyRule2",
       "destination": "mycontainer",
       "definition": {
         "filters": {
           "blobTypes": [
             "blockBlob"
           ],
           "prefixMatch": [
             "inventoryprefix1",
             "inventoryprefix2"
           ],
           "includeSnapshots": true,
           "includeBlobVersions": true
         },
         "format": "Csv",
         "schedule": "Daily",
         "objectType": "Blob",
         "schemaFields": [
           "Name",
           "Creation-Time",
           "Last-Modified",
           "Content-Length",
           "Content-MD5",
           "BlobType",
           "AccessTier",
           "AccessTierChangeTime",
           "Snapshot",
           "VersionId",
           "IsCurrentVersion",
           "Metadata"
         ]
       }
     }
    ]
   }
   
   

4. Crie uma política de inventário de blob usando o comando de criação az storage account blob-inventory-policy. Forneça o nome do seu documento JSON usando o parâmetro --policy.

   az storage account blob-inventory-policy create -g myresourcegroup --account-name mystorageaccount --policy @policy.json
   

Desabilitar relatórios de inventário

Embora você possa desabilitar relatórios individuais, você também pode impedir que o inventário de blobs seja executado.

1. Entre no portal do Azure.

2. Localize sua conta de armazenamento e exiba a visão geral dela.

3. Em Gerenciamento de dados, selecione Inventário de blob.

4. Selecione Configurações de inventário de Blob e, no painel Configurações de inventário de Blob, desmarque a caixa de seleção Habilitar inventário de blob e selecione Salvar.

   

   Limpar a caixa de seleção Habilitar inventário de blob suspende todas as execuções de inventário de blob. Você poderá selecionar esta caixa de seleção mais tarde se quiser retomar as execuções de inventário.

Assinar o evento de conclusão da política de inventário de blobs

Você pode assinar o evento de conclusão do inventário de blobs para receber informações sobre o resultado das suas execuções de inventário. Esse evento é disparado quando a execução do inventário é concluída para uma regra definida em uma política de inventário. Este evento também ocorre se a execução do inventário falha com um erro de usuário antes de começar. Por exemplo, uma política inválida ou um erro ocorrido quando um contêiner de destino não está presente vai disparar o evento.

1. Entre no portal do Azure.

2. Localize sua conta de armazenamento e exiba a visão geral dela.

3. No menu à esquerda, selecione Eventos.

4. Selecione + Assinatura de Evento.

   A página Criar Assinatura de Evento será exibida.

5. Na página Criar Assinatura de Evento, nomeie sua assinatura de evento e use o esquema padrão, Esquema da Grade de Eventos.

6. Em TIPOS DE EVENTO, escolha Conclusão do Inventário de Blobs.

7. Em DETALHES DO PONTO DE EXTREMIDADE, escolha Fila de Armazenamento como Tipo de Ponto de Extremidade e selecione Configurar um ponto de extremidade.

8. Na página Filas, escolha a assinatura, a conta de armazenamento e crie uma fila. Nomeie sua fila e clique em Criar.

9. Opcionalmente, selecione a guia Filtros se quiser filtrar o assunto do evento ou suas características.

10. Opcionalmente, selecione a guia Recursos Adicionais se quiser habilitar o armazenamento de mensagens não entregues, as políticas de repetição e definir o tempo de expiração da assinatura do evento.

11. Opcionalmente, selecione a guia Propriedades de Entrega para definir o tempo de vida útil da mensagem da fila de armazenamento.

12. Escolha Criar

Para exibir as mensagens da fila entregues

1. Localize sua conta de armazenamento e exiba a visão geral dela.

2. Em Armazenamento de Dados, selecione Filas e abra a nova fila criada para configurar o ponto de extremidade para acessar as mensagens.

3. Selecione a mensagem para o tempo de execução do inventário desejado para acessar as propriedades da mensagem e revisar o corpo da mensagem para o status do evento.

Para obter mais métodos sobre como assinar eventos de armazenamento de blobs, confira Armazenamento de Blobs do Azure como origem da Grade de Eventos - Grade de Eventos do Azure | Microsoft Learn

Habilitar opcionalmente o rastreamento de tempo de acesso

Você pode optar por habilitar o controle de tempo de acesso de blob. Quando o controle de tempo de acesso estiver habilitado, os relatórios de inventário incluirão o campo LastAccessTime com base na hora em que o blob foi acessado pela última vez com uma operação de leitura ou gravação. Para minimizar o impacto na latência de acesso de leitura, somente a primeira leitura das últimas 24 horas atualiza o horário do último acesso. As leituras subsequentes no mesmo período de 24 horas não atualizam o horário do último acesso. Se um blob for modificado entre leituras, o horário do último acesso será o mais recente dos dois valores.

Portal

Para habilitar o rastreamento de tempo do último acesso com o portal do Azure, siga estas etapas:

1. Entre no portal do Azure.

2. Localize sua conta de armazenamento e exiba a visão geral dela.

3. Em Gerenciamento de dados, selecione Inventário de blob.

4. Selecione Configurações de inventário de Blob e, no painel Configurações de inventário de Blob, selecione a caixa de seleção Habilitar o controle de último acesso.

   

PowerShell

Para habilitar o rastreamento de tempo do último acesso com o PowerShell, chame o comando Enable-AzStorageBlobLastAccessTimeTracking, como mostrado no exemplo a seguir. Lembre-se de substituir os valores dos espaços reservados entre colchetes angulares pelos seus próprios valores:

# Initialize these variables with your values.
$rgName = "<resource-group>"
$accountName = "<storage-account>"

Enable-AzStorageBlobLastAccessTimeTracking  -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -PassThru

CLI do Azure

Para habilitar o rastreamento de tempo do último acesso com a CLI do Azure, chame o comando az storage account blob-service-properties update como mostrado no exemplo a seguir. Lembre-se de substituir os valores dos espaços reservados entre colchetes angulares pelos seus próprios valores:

az storage account blob-service-properties update \
    --resource-group <resource-group> \
    --account-name <storage-account> \
    --enable-last-access-tracking true

Próximas etapas

• Calcular a contagem e o tamanho total de blobs por contêiner
• Tutorial: analisar relatórios de inventário de blobs
• Gerenciar o ciclo de vida de Armazenamento de Blobs do Azure