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.

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