Criar configurações de tabelas de metadados

Como criar uma configuração de tabelas de metadados

Antes de criar uma configuração de tabelas de metadados, revise e cumpra os pré-requisitos e revise Limitações e restrições das tabelas de metadados.

1. Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

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

3. Escolha o bucket de uso geral para o qual você deseja criar uma configuração de tabelas de metadados.

   nota

   Garanta que esse bucket de uso geral esteja em uma Região da AWS onde os buckets de tabela estejam disponíveis. Os buckets de tabela só estão disponíveis nas regiões Leste dos EUA (Norte da Virgínia), Leste dos EUA (Ohio) e Oeste dos EUA (Oregon).

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

5. Na guia Metadados, escolha Criar configuração de metadados.

6. Na página Criar configuração de metadados, em Tabela de diário, você pode escolher se deseja 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 diário são criptografadas 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 diário com SSE-S3 (o padrão), escolha Não especificar o tipo de criptografia.

   • Para criptografar uma tabela de diá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.

     Verifique se você configurou as permissões necessárias para o SSE-KMS. Para ter mais informações, consulte Permissões para SSE-KMS.

7. (Opcional) 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, escolha Habilitada em Expiração dos registros.

   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 o valor em Dias após os quais os registros expiram, você pode especificar 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.

   Os registros expirarão no prazo de 24 a 48 horas depois que se tornarem elegíveis para expiração.

   Importante

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

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

8. (Opcional) Se você quiser adicionar uma tabela de inventário à configuração da tabela de metadados, em Tabela de inventário em tempo real, escolha Habilitada para o Status da configuração.

   Você pode optar por criptografar a tabela com 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.

     Verifique se você configurou as permissões necessárias para o SSE-KMS. Para ter mais informações, consulte Permissões para SSE-KMS.

9. Escolha Criar configuração de tabelas de metadados.

Como criar uma configuração de tabelas de metadados usando a AWS CLI

Antes de criar uma configuração de tabelas de metadados, revise e cumpra os pré-requisitos e revise Limitações e restrições das tabelas de metadados.

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

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

   Você deve especificar se deseja habilitar ou desabilitar a expiração de registros da tabela de diário. Se você optar por habilitar a expiração de registros, também deverá especificar o número de dias após os quais os registros da tabela de diário expirarão. Para definir o valor Days, você pode especificar 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.

   Opcionalmente, você pode optar por configurar uma tabela de inventário.

   Para tabelas de diário e tabelas de inventário, você pode especificar opcionalmente 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 tabelas de metadados com a criptografia do lado do servidor usando chaves do AWS Key Management Service (AWS KMS) (SSE-KMS), defina 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.

   {
     "JournalTableConfiguration": {
        "RecordExpiration": {          
          "Expiration": "ENABLED",
         "Days": 10
       },
       "EncryptionConfiguration": {  
         "SseAlgorithm": "AES256"
       }
     },
     "InventoryTableConfiguration": { 
       "ConfigurationState": "ENABLED",
       "EncryptionConfiguration": {   
         "SseAlgorithm": "aws:kms",
         "KmsKeyArn": "arn:aws:kms:us-east-2:account-id:key/key-id"
       }
     }
   }

2. Use o comando a seguir para aplicar a configuração de tabelas de metadados ao bucket de uso geral (por exemplo, amzn-s3-demo-bucket):

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

3. Para verificar se a configuração foi criada, execute o seguinte comando:

   aws s3api get-bucket-metadata-configuration \
   --bucket amzn-s3-demo-bucket \
   --region us-east-2