Habilitar ou desabilitar tabelas de inventário em tempo real
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.
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
. -
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.
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
Como habilitar ou desabilitar tabelas de inventário
Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/
. -
No painel de navegação à esquerda, escolha Buckets de uso geral.
-
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.
-
Na página de detalhes do bucket, escolha a guia Metadados.
-
Na guia Metadados, escolha Editar e selecione Editar configuração da tabela de inventário.
-
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.
-
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.
-
-
Escolha Salvar alterações.
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 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 AWS Management Console. Para ter mais informações, consulte What is CloudShell? e Getting started with AWS CloudShell no Guia do usuário do AWS CloudShell.
Como habilitar ou desabilitar tabelas de inventário usando a AWS CLI
Para usar os comandos a seguir, substitua os
por suas próprias informações. user input
placeholders
nota
Antes de habilitar uma configuração de inventário, analise e cumpra os pré-requisitos.
-
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
comoAES256
.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
comoaws:kms
. Você também deve definirKmsKeyArn
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" } }
-
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 \ --regionus-east-2
Você pode enviar solicitações REST para habilitar ou desabilitar tabelas de inventário. Para obter mais informações, consulte UpdateBucketMetadataInventoryTableConfiguration.
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.