Habilitar relatórios de inventário de blob de Armazenamento do Azure

O recurso de inventário de blob do Armazenamento do Azure fornece uma visão geral de 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 da criptografia, a política de imutabilidade, a retenção legal e assim por diante. O relatório fornece uma visão geral dos seus dados para os requisitos de negócios e conformidade.

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

Habilite relatórios de inventário de blob 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 da conta.

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

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

   A página Adicionar uma regra é exibida.

5. Na página Adicionar uma regra, nomeie a nova regra.

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

7. Em Tipo de objeto a ser inventariado, escolha se deseja criar um relatório para blobs ou contêineres.

   Se você selecionar Blob, em Subtipo de Blob, escolha os tipos de blobs que deseja incluir no relatório e se deseja incluir versões e/ou instantâneos de blob no relatório de inventário.

   Nota

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

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

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

10. Opcionalmente, adicione uma correspondência de prefixo para filtrar blobs no relatório de inventário.

11. Selecione Guardar.

    

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. Verifique se você tem o módulo mais recente do Azure PowerShell. Consulte Instalar o módulo do Azure PowerShell.

3. Inicie sessão na sua subscrição do Azure com o comando Connect-AzAccount e siga as instruções no ecrã.

   Connect-AzAccount
   

4. Se a sua identidade estiver associada a mais do que uma subscrição, defina a sua subscrição ativa.

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

   Substitua o valor do espaço reservado <subscription-id> pelo 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 <resource-group-name> valor do espaço reservado pelo nome do seu grupo de recursos.

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

6. Crie regras de inventário usando o comando New-AzStorageBlobInventoryPolicyRule . Cada regra lista campos de relatório. Para obter uma lista completa de campos de relatório, consulte Inventário de blobs 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 este comando usando o -Rule parâmetro.

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

CLI do Azure

Você pode adicionar, editar ou remover uma política por meio da CLI do Azure.

1. Primeiro, abra o Azure Cloud Shell ou, se você tiver instalado a CLI do Azure localmente, abra um aplicativo de console de comando, como o Windows PowerShell.

2. Se a sua identidade estiver associada a mais do que uma subscrição, defina a sua subscrição ativa.

      az account set --subscription <subscription-id>
   

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

3. Defina as regras de sua política em um documento JSON. A seguir mostra o conteúdo de um arquivo JSON de exemplo 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 az storage account blob-inventory-policy create. Forneça o nome do documento JSON usando o --policy parâmetro.

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

Desativar relatórios de inventário

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

1. Inicie sessão no portal do Azure.

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

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

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.

   

   Desmarcar a caixa de seleção Ativar inventário de blob suspende todas as execuções de inventário de blob. Você pode marcar essa caixa de seleção mais tarde se quiser retomar as execuções de inventário.

Opcionalmente, ative o rastreamento de tempo de acesso

Você pode optar por ativar o rastreamento 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 efeito na latência de acesso de leitura, apenas a primeira leitura das últimas 24 horas atualiza a última hora de acesso. As leituras subsequentes no mesmo período de 24 horas não atualizam a última hora de acesso. Se um blob for modificado entre leituras, o último tempo de acesso será o mais recente dos dois valores.

Portal

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

1. Inicie sessão no portal do Azure.

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

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

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

   

PowerShell

Para habilitar o controle do tempo do último acesso com o PowerShell, chame o comando Enable-AzStorageBlobLastAccessTimeTracking , conforme mostrado no exemplo a seguir. Lembre-se de substituir os valores de espaço reservado 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 controle do tempo do último acesso com a CLI do Azure, chame o comando az storage account blob-service-properties update , conforme mostrado no exemplo a seguir. Lembre-se de substituir os valores de espaço reservado 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óximos passos

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