Habilitación o deshabilitación de las tablas de anotaciones

Habilitación o deshabilitación de tablas de anotaciones

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/.

2. En el panel de navegación izquierdo, elija Buckets de uso general.

3. Elija el bucket de uso general con la configuración de tabla de metadatos para el que desea habilitar o deshabilitar una tabla de anotaciones.

4. En la página de detalles del bucket, elija la pestaña Metadatos.

5. En la pestaña Metadatos, elija Editar y, a continuación, Editar la configuración de tabla de anotaciones.

6. En la página Editar la configuración de tabla de anotaciones, elija Habilitado o Deshabilitado en Tabla de anotaciones.

   nota

   Antes de elegir Habilitado, asegúrese de haber revisado y cumplido los requisitos previos.

   • Si elige Habilitado, en Rol de IAM, elija uno de los siguientes métodos de selección de rol de IAM:

     • Crear un nuevo rol de IAM: Amazon S3 crea un nuevo rol de IAM con los permisos necesarios para la tabla de anotaciones.

     • Elegir de los roles de IAM existentes: seleccione un rol de IAM existente en la lista desplegable Rol de IAM. El rol debe tener los permisos necesarios para leer las anotaciones del bucket.

     • Ingresar el ARN del rol de IAM: ingrese el ARN de un rol de IAM existente que tenga los permisos necesarios.

     Para obtener más información sobre los permisos necesarios para el rol de IAM de la tabla de anotaciones, consulte Rol de IAM de la tabla de anotaciones.

     Puede elegir también si desea cifrar la tabla con el cifrado del servidor mediante claves de AWS Key Management Service (AWS KMS) (SSE-KMS). De forma predeterminada, las tablas de anotaciones se cifran con el cifrado del servidor mediante claves administradas por Amazon S3 (SSE-S3).

     Si decide utilizar SSE-KMS, debe proporcionar una clave de KMS administrada por el cliente en la misma región que el bucket de uso general.

     importante

     Solo puede establecer el tipo de cifrado para las tablas de metadatos durante la creación de estas. Después de crear una tabla administrada de AWS, no se puede cambiar la configuración de cifrado.

     • Para cifrar la tabla de anotaciones con SSE-S3 (el valor predeterminado), elija No especificar el tipo de cifrado.

     • Para cifrar la tabla de anotaciones con SSE-KMS, elija Especificar el tipo de cifrado. En Tipo de cifrado, elija Cifrado del servidor con claves de AWS Key Management Service (AWS KMS) (SSE-KMS). En Clave de AWS KMS, elija entre las claves de KMS existentes o introduzca el ARN de clave de KMS. Si aún no tiene una clave de KMS, elija Introduzca el ARN de la clave de KMS y, a continuación, elija Crear una clave de KMS.

   • Si ha elegido Deshabilitado en Después de deshabilitar la tabla de anotaciones, la tabla dejará de actualizarse y las actualizaciones no podrán reanudarse, seleccione la casilla de verificación.

7. Elija Save changes (Guardar cambios).

Habilitación o deshabilitación de las tablas de anotaciones mediante la AWS CLI

Para utilizar los comandos de ejemplo siguientes, sustituya user input placeholders por su propia información.

1. Cree un archivo JSON que contenga la configuración de tabla de anotaciones y guárdelo (por ejemplo, annotation-config.json). A continuación, se muestra un ejemplo de configuración para habilitar una nueva tabla de anotaciones.

   Si va a habilitar una tabla de anotaciones, puede especificar opcionalmente una configuración de cifrado. De forma predeterminada, las tablas de metadatos se cifran con el cifrado del servidor mediante claves administradas por Amazon S3 (SSE-S3), que puede especificar si establece SseAlgorithm en AES256.

   Para cifrar la tabla de anotaciones con cifrado del servidor mediante claves de AWS Key Management Service (AWS KMS) (SSE-KMS), establezca SseAlgorithm en aws:kms. También debe establecer KmsKeyArn en el ARN de una clave de KMS administrada por el cliente en la misma región donde se encuentra el bucket de uso general.

   {
     "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"
     }
   }

   El campo Role es obligatorio al habilitar una tabla de anotaciones por primera vez o al cambiar el rol de IAM. El rol debe conceder permiso de metadatos de Amazon S3 para leer las anotaciones del bucket. Para obtener más información, consulte el rol de IAM de la tabla de anotaciones.

   Si desea deshabilitar una tabla de anotaciones existente, utilice la siguiente configuración:

   {
     "ConfigurationState": "DISABLED"  }
   

2. Utilice el siguiente comando para actualizar la configuración de tabla de anotaciones para el bucket de uso general (por ejemplo, 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