Como habilitar ou desabilitar tabelas de anotação

Para habilitar ou desabilitar tabelas de anotação

1. Faça login no Console de gerenciamento da AWS 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 com a configuração da tabela de metadados para a qual você deseja habilitar ou desabilitar uma tabela de anotação.

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

5. Na guia Metadados, escolha Editar e selecione Editar configuração da tabela de anotação.

6. Na página Editar configuração da tabela de anotação, escolha Habilitada ou Desabilitada em Tabela de anotação.

   nota

   Antes de escolher Habilitada, verifique se você analisou e atendeu aos pré-requisitos.

   • Se você selecionar Habilitada, em Perfil do IAM, escolha um dos seguintes métodos de seleção de perfil do IAM:

     • Criar um perfil do IAM: o Amazon S3 cria um novo perfil do IAM com as permissões necessárias para a tabela de anotação.

     • Escolher entre perfis do IAM existentes: selecione um perfil do IAM existente no menu suspenso Perfil do IAM. O perfil deve ter as permissões necessárias para ler anotações do bucket.

     • Inserir ARN do perfil do IAM: insira o ARN de um perfil do IAM existente que tenha as permissões necessárias.

     Para obter mais informações sobre as permissões necessárias para o perfil do IAM da tabela de anotação, consulte Perfil do IAM da tabela de anotação.

     Você também 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 anotação 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 anotação com SSE-S3 (o padrão), escolha Não especificar o tipo de criptografia.

     • Para criptografar uma tabela de anotação 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 anotação for desabilitada, a tabela não será mais atualizada e as atualizações não poderão ser retomadas.

7. Escolha Salvar alterações.

Para habilitar ou desabilitar tabelas de anotação 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 a configuração da tabela de anotação e salve-o (por exemplo, annotation-config.json). O exemplo a seguir é uma configuração de amostra para habilitar uma nova tabela de anotação.

   Se você estiver habilitando uma tabela de anotação, poderá 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 anotação com 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.

   {
     "ConfigurationState": "ENABLED",
     "Role": "arn:aws:iam::account-id:role/annotation-table-role",
     "EncryptionConfiguration": {
       "SseAlgorithm": "aws:kms",
       "KmsKeyArn": "arn:aws:kms:us-east-2:account-id:key/key-id"
     }
   }

   O campo Role é obrigatório ao habilitar uma tabela de anotação pela primeira vez ou ao alterar o perfil do IAM. O perfil deve conceder ao Amazon S3 Metadata permissão para ler anotações do seu bucket. Para obter mais informações, consulte Perfil do IAM da tabela de anotação.

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

   {
     "ConfigurationState": "DISABLED"  }
   

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

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