

# Registros expirados da tabela de diário
<a name="metadata-tables-expire-journal-table-records"></a>

Por padrão, os registros na tabela de diário não expiram. Para ajudar a minimizar os custos de armazenamento da tabela de diário, você pode habilitar a expiração dos respectivos registros. 

**nota**  
Se você tiver criado sua configuração do S3 Metadata antes de 15 de julho de 2025, não poderá habilitar a expiração dos registro da tabela de diário nessa configuração. Recomendamos que você exclua e crie novamente sua configuração para poder expirar os registros da tabela de diário e criar uma tabela de inventá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).

Se você habilitar a expiração de registros da tabela de diário, poderá definir o número de dias em que os registros da tabela de diário devem ser retidos. Para definir esse valor, especifique qualquer número inteiro entre `7` e `2147483647`. Por exemplo, para reter os registros da tabela de diário por um ano, defina esse valor como `365`.

**Importante**  
Depois que os registros da tabela de diário expirarem, eles não poderão ser recuperados.

Os registros expiram no prazo de 24 a 48 horas depois de se tornarem elegíveis para expiração. Os registros do diário são removidos do snapshot mais recente. Os dados e o armazenamento dos registros excluídos são removidos por meio de operações de manutenção de tabelas.

Se você tiver habilitado a expiração dos registros da tabela de diário, poderá desabilitá-la a qualquer momento para interromper a expiração desses registros.

Você pode criar uma configuração de tabela de diá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.

## Como expirar registros da tabela de diário
<a name="metadata-tables-expire-journal-table-records-procedure"></a>

### Usar o console do S3
<a name="metadata-tables-expire-journal-table-records-console"></a>

**Para expirar registros da tabela de diá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 que contém a configuração da tabela de metadados com a tabela de diário da qual você deseja expirar os registros. 

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

1. Na guia **Metadados**, escolha **Editar** e selecione **Editar expiração do registro da tabela de diário**.

1. Na página **Editar expiração do registro da tabela de diário**, escolha **Habilitada** em **Expiração dos registros**.

1. Defina o número de dias em que os registros da tabela de diário devem ser retidos. Para definir o valor de **Dias após os quais os registros expiram**, especifique qualquer número inteiro entre `7` e `2147483647`. Por exemplo, para reter os registros da tabela de diário por um ano, defina esse valor como `365`.
**Importante**  
Depois que os registros da tabela de diário expirarem, eles não poderão ser recuperados.

1. Marque a caixa de seleção em **Registros da tabela de diário expirarão após o número especificado de dias**. 

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

Se você quiser desabilitar a expiração dos registros da tabela de diário, repita as etapas anteriores, mas escolha **Desabilitada** em vez de **Habilitada** para a etapa 6. 

### Como usar o AWS CLI
<a name="metadata-tables-expire-journal-table-records-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 versão 2 da AWS Command Line Interface*.

Você também pode 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 inicializar 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 expirar os registros da tabela de diário usando a AWS CLI**

Para usar os exemplos de comando a seguir, substitua os `user input placeholders` por suas próprias informações. 

1. Crie um arquivo JSON que contenha sua configuração de tabela de metadados e salve-o (por exemplo, `journal-config.json`). Veja a seguir uma configuração de amostra. 

   Para definir o valor `Days`, especifique qualquer número inteiro entre `7` e `2147483647`. Por exemplo, para reter os registros da tabela de diário por um ano, defina esse valor como `365`.

   ```
   {
     "RecordExpiration": {
       "Expiration": "ENABLED",
       "Days": 10
     }
   }
   ```

   Para desabilitar a expiração dos registros da tabela de diário, crie a configuração de exemplo a seguir. Se `Expiration` estiver definida como `DISABLED`, você não deverá especificar um valor `Days` na configuração.

   ```
   {
     "RecordExpiration": {
       "Expiration": "DISABLED"
     }
   }
   ```

1. Use o seguinte comando para expirar os registros da tabela de diário no bucket de uso geral (por exemplo, `amzn-s3-demo-bucket`):

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

### Uso da API REST
<a name="metadata-tables-expire-journal-table-records-rest-api"></a>

Você pode enviar solicitações REST para expirar os registros da tabela de diário. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataJournalTableConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataJournalTableConfiguration.html).

### Uso da SDKs AWS
<a name="metadata-tables-expire-journal-table-records-sdk"></a>

Você pode usar os SDKs da AWS para expirar os registros da tabela de diá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_UpdateBucketMetadataJournalTableConfiguration.html#API_UpdateBucketMetadataJournalTableConfiguration_SeeAlso).