

# Habilitar ou desabilitar tabelas de inventário em tempo real
<a name="metadata-tables-enable-disable-inventory-tables"></a>

Por padrão, sua configuração de tabela de metadados contém uma *tabela de diário*, que registra os eventos referentes aos objetos em seu bucket. A tabela de diário é necessária para cada configuração de tabela de metadados. 

Opcionalmente, você pode adicionar uma *tabela de inventário em tempo real* à sua configuração de tabela de metadados. A tabela de inventário em tempo real fornece um inventário simples e consultável de todos os objetos e das respectivas versões no bucket para que você possa determinar o estado mais recente dos dados.

**nota**  
Se você tiver criado sua configuração do S3 Metadata antes de 15 de julho de 2025, não poderá habilitar uma tabela de inventário nessa configuração. Recomendamos que você exclua e recrie sua configuração para poder criar uma tabela de inventário e expirar os registros da tabela de diário. Para obter mais informações, consulte [Habilitar tabelas de inventário em configurações de metadados criadas antes de 15 de julho de 2025](metadata-tables-create-configuration.md#metadata-tables-migration).

A tabela de inventário contém os metadados mais recentes de todos os objetos em seu bucket. É possível usar essa tabela para simplificar e acelerar fluxos de trabalho de negócios e tarefas de big data identificando objetos que você deseja processar para várias workloads. Por exemplo, você pode consultar a tabela de inventário para fazer o seguinte: 
+ Encontrar todos os objetos armazenados na classe de armazenamento S3 Glacier Deep Archive.
+ Criar uma distribuição de tags de objeto ou encontrar objetos sem tags.
+ Encontrar todos os objetos que não são criptografados usando a criptografia do lado do servidor com chaves do AWS Key Management Service (AWS KMS) (SSE-KMS). 
+ Compare sua tabela de inventário em dois momentos diferentes para entender o aumento de objetos com tags específicas.

Se você optar por habilitar uma tabela de inventário para sua configuração de tabela de metadados, essa tabela passará por um processo conhecido como *preenchimento*, durante o qual o Amazon S3 verifica o bucket de uso geral para recuperar os metadados iniciais de todos os objetos existentes no bucket. Dependendo do número de objetos no bucket, esse processo pode levar de minutos (no mínimo 15 minutos) a horas. Quando o processo de preenchimento é concluído, o status da tabela de inventário muda de **Preenchendo** para **Ativo**. Depois que o preenchimento é concluído, geralmente as atualizações dos objetos são mostradas na tabela de inventário no prazo de uma hora.

**nota**  
Você recebe cobrança pelo preenchimento da tabela de inventário. Se o bucket de uso geral tiver mais de um bilhão de objetos, você também pagará uma taxa mensal pela tabela de inventário. Para obter mais informações, consulte [Preços do Amazon S3](https://aws.amazon.com/s3/pricing/).
Não é possível pausar as atualizações na tabela de inventário e depois retomá-las. No entanto, é possível desabilitar a configuração da tabela de inventário. Desabilitar a tabela de inventário não a exclui. A tabela de inventário é mantida em seus registros até que você decida excluí-la.   
Se você tiver desabilitado a tabela de inventário e depois quiser reabilitá-la, primeiro exclua a tabela de inventário antiga do bucket de tabela gerenciado pela AWS. Quando você reabilita a configuração de tabela de inventário, o Amazon S3 cria outra tabela de inventário. Nesse caso, você recebe cobrança novamente pelo preenchimento da nova tabela.

Você pode habilitar ou desabilitar as tabelas de inventário usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), os SDKs da AWS ou a API REST do Amazon S3.

**Pré-requisitos**  
Se você desabilitou sua tabela de inventário e agora deseja reabilitá-la, primeiro exclua manualmente a tabela de inventário antiga do bucket de tabela gerenciado pela AWS. Do contrário, a reabilitação da tabela de inventário falhará, porque já existe uma tabela de inventário no bucket de tabela. Para excluir uma tabela de inventário, consulte [Excluir uma tabela de metadados](metadata-tables-delete-table.md#delete-metadata-table-procedure). 

Quando você reabilita a configuração de tabela de inventário, o Amazon S3 cria outra tabela de inventário. Nesse caso, você recebe cobrança novamente pelo preenchimento da nova tabela. 

## Habilitar ou desabilitar tabelas de inventário
<a name="metadata-tables-enable-disable-inventory-tables-procedure"></a>

### Usar o console do S3
<a name="metadata-tables-enable-disable-inventory-tables-console"></a>

**Como habilitar ou desabilitar tabelas de inventário**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets de uso geral**.

1. Escolha o bucket de uso geral com a configuração da tabela de metadados para a qual você deseja habilitar ou desabilitar uma tabela de inventário.

1. Na página de detalhes do bucket, escolha a guia **Metadados**. 

1. Na guia **Metadados**, escolha **Editar** e selecione **Editar configuração da tabela de inventário**.

1. Na página **Editar configuração da tabela de inventário**, escolha **Habilitada** ou **Desabilitada** em **Tabela de inventário**.
**nota**  
Antes de escolher **Habilitada**, verifique se você analisou e atendeu aos [pré-requisitos](#inventory-table-config-prereqs). 
   + Se você optou por **Habilitada**, poderá optar por criptografar a tabela com a criptografia do lado do servidor usando chaves do AWS Key Management Service (AWS KMS) (SSE-KMS). Por padrão, as tabelas de inventário são criptografados com a criptografia do lado do servidor usando chaves gerenciadas pelo Amazon S3 (SSE-S3).

     Se você optar por usar o SSE-KMS, deverá fornecer uma chave do KMS gerenciada pelo cliente na mesma região do bucket de uso geral. 
**Importante**  
Você pode definir o tipo de criptografia para uma tabela de metadados somente ao criá-la. Após a criação de uma tabela gerenciada pela AWS, não é possível alterar a configuração de criptografia.
     + Para criptografar uma tabela de inventário com SSE-S3 (o padrão), escolha **Não especificar o tipo de criptografia**. 
     + Para criptografar uma tabela de inventário com SSE-KMS, escolha **Especificar o tipo de criptografia.** Em **Tipo de criptografia**, escolha **Criptografia do lado do servidor usando chaves do AWS Key Management Service (AWS KMS) (SSE-KMS)**. Em **Chave do AWS KMS**, escolha entre suas chaves existentes do KMS ou insira o ARN da chave do KMS. Se você ainda não tiver uma chave do KMS, escolha **Inserir o ARN da chave do KMS** e selecionar **Criar uma chave do KMS**.
   + Se você escolher **Desabilitada**, marque a caixa de seleção em **Depois que a tabela de inventário for desabilitada, a tabela não será mais atualizada e as atualizações não poderão ser retomadas**.

1. Escolha **Salvar alterações**.

### Como usar o AWS CLI
<a name="metadata-tables-enable-disable-inventory-tables-cli"></a>

Para executar os comandos a seguir, você deve ter a AWS CLI instalada e configurada. Se ainda não tiver a AWS CLI instalada, consulte [Instalar ou atualizar a versão mais recente da AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-install.html) no *Guia do usuário da AWS Command Line Interface*.

Também é possível executar comandos da AWS CLI pelo console usando o AWS CloudShell. O AWS CloudShell é um shell pré-autenticado e baseado em navegador que você pode iniciar diretamente do Console de gerenciamento da AWS. Para ter mais informações, consulte [What is CloudShell?](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html) e [Getting started with AWS CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/getting-started.html) no *Guia do usuário do AWS CloudShell*.

**Como habilitar ou desabilitar tabelas de inventário usando a AWS CLI**

Para usar os exemplos de comando a seguir, substitua os `user input placeholders` por suas próprias informações. 
**nota**  
Antes de habilitar uma configuração de inventário, analise e cumpra os [pré-requisitos](#inventory-table-config-prereqs). 

1. Crie um arquivo JSON que contenha a configuração da tabela de inventário e salve-o (por exemplo, `inventory-config.json`). O exemplo a seguir é uma configuração de amostra para habilitar uma nova tabela de inventário.

   Se você estiver habilitando uma tabela de inventário, poderá, opcionalmente, especificar uma configuração de criptografia. Por padrão, as tabelas de metadados são criptografados com a criptografia do lado do servidor usando chaves gerenciadas pelo Amazon S3 (SSE-S3), que você pode especificar configurando `SseAlgorithm` como `AES256`.

   Para criptografar uma tabela de inventário com criptografia do lado do servidor usando chaves do AWS Key Management Service (AWS KMS) (SSE-KMS), defina como `SseAlgorithm` como `aws:kms`. Você também deve definir `KmsKeyArn` como o ARN de uma chave do KMS gerenciada pelo cliente na mesma região em que o bucket de uso geral está localizado.

   ```
   {
     "ConfigurationState": "ENABLED",
     "EncryptionConfiguration": {       
       "SseAlgorithm": "aws:kms",
       "KmsKeyArn": "arn:aws:kms:us-east-2:account-id:key/key-id"
     }  
   }
   ```

   Se você quiser desabilitar uma tabela de inventário existente, use a seguinte configuração: 

   ```
   {
     "ConfigurationState": "DISABLED"  }  
   }
   ```

1. Use o seguinte comando para atualizar a configuração da tabela de metadados para o bucket de uso geral (por exemplo, `amzn-s3-demo-bucket`):

   ```
   aws s3api update-bucket-metadata-inventory-table-configuration \
   --bucket amzn-s3-demo-source-bucket \
   --inventory-table-configuration file://./inventory-config.json \
   --region us-east-2
   ```

### Uso da API REST
<a name="metadata-tables-enable-disable-inventory-tables-rest-api"></a>

Você pode enviar solicitações REST para habilitar ou desabilitar tabelas de inventário. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataInventoryTableConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataInventoryTableConfiguration.html).

### Uso da SDKs AWS
<a name="metadata-tables-enable-disable-inventory-tables-sdk"></a>

Você pode usar os SDKs da AWS para habilitar ou desabilitar tabelas de inventário no Amazon S3. Para ter mais informações, consulte a [lista de SDKs compatíveis](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataInventoryTableConfiguration.html#API_UpdateBucketMetadataInventoryTableConfiguration_SeeAlso).