Activation ou désactivation des tables d'annotations

Pour activer ou désactiver les tables d'annotations

1. Connectez-vous à Console de gestion AWS et ouvrez la console Amazon S3 à l'adresse https://console.aws.amazon.com/s3/.

2. Dans le volet de navigation de gauche, choisissez Compartiments à usage général.

3. Choisissez le compartiment à usage général avec la configuration de table de métadonnées pour laquelle vous souhaitez activer ou désactiver une table d'annotations.

4. Sur la page de détails du compartiment, sélectionnez l’onglet Métadonnées.

5. Dans l'onglet Métadonnées, choisissez Modifier, puis choisissez Modifier la configuration de la table d'annotations.

6. Sur la page de configuration Modifier la table d'annotations, choisissez Activé ou Désactivé sous Table d'annotations.

   Note

   Avant de choisir Activée, veillez à consulter et remplir les prérequis.

   • Si vous avez choisi Activé, sous Rôle IAM, choisissez l'une des méthodes de sélection des rôles IAM suivantes :

     • Créer un nouveau rôle IAM — Amazon S3 crée un nouveau rôle IAM avec les autorisations requises pour la table d'annotations.

     • Choisissez parmi les rôles IAM existants  : sélectionnez un rôle IAM existant dans la liste déroulante des rôles IAM. Le rôle doit disposer des autorisations requises pour lire les annotations de votre compartiment.

     • Entrez l'ARN du rôle IAM — Entrez l'ARN d'un rôle IAM existant qui possède les autorisations requises.

     Pour plus d'informations sur les autorisations requises pour le rôle IAM dans la table d'annotations, consultez la section Rôle IAM dans la table d'annotations.

     Vous pouvez également choisir de chiffrer votre table avec un chiffrement côté serveur à l'aide de AWS Key Management Service (AWS KMS) keys (). SSE-KMS Par défaut, les tables d'annotations sont chiffrées côté serveur à l'aide de clés gérées par Amazon S3 ()SSE-S3.

     Si vous choisissez de l'utiliser SSE-KMS, vous devez fournir une clé KMS gérée par le client dans la même région que votre compartiment à usage général.

     Important

     Vous pouvez définir le type de chiffrement de vos tables de métadonnées uniquement lors de leur création. Une fois qu'une table AWS gérée est créée, vous ne pouvez pas modifier ses paramètres de chiffrement.

     • Pour chiffrer votre table d'annotations avec SSE-S3 (par défaut), choisissez Ne pas spécifier le type de cryptage.

     • Pour chiffrer votre table d'annotations SSE-KMS, choisissez Spécifier le type de cryptage. Dans Type de cryptage, choisissez Server-side le chiffrement à l'aide AWS Key Management Service de clés (SSE-KMS) ().AWS KMS Sous CléAWS KMS , choisissez une clé KMS parmi celles existantes ou saisissez l’ARN de votre clé KMS. Si vous ne possédez pas encore de clé KMS, choisissez Saisir l’ARN de la clé KMS, puis Créer une clé KMS.

   • Si vous avez choisi Désactivé, sous Une fois la table d'annotations désactivée, la table ne sera plus mise à jour et les mises à jour ne pourront pas être reprises, cochez la case.

7. Sélectionnez Enregistrer les modifications.

Pour activer ou désactiver les tables d'annotations à l'aide du AWS CLI

Pour utiliser les exemples de commandes suivants, remplacez les user input placeholders par vos propres informations.

1. Créez un fichier JSON contenant la configuration de votre table d'annotations et enregistrez-le (par exemple,annotation-config.json). Voici un exemple de configuration permettant d'activer une nouvelle table d'annotations.

   Si vous activez une table d'annotations, vous pouvez éventuellement spécifier une configuration de chiffrement. Par défaut, les tables de métadonnées sont chiffrées avec un chiffrement côté serveur à l'aide de clés gérées Amazon S3 (SSE-S3), que vous pouvez spécifier en SseAlgorithm réglant sur. AES256

   Pour chiffrer votre table d'annotations avec un chiffrement côté serveur à l'aide de AWS Key Management Service (AWS KMS) keys (SSE-KMS), définissez sur. SseAlgorithm aws:kms Vous devez également définir KmsKeyArn sur l’ARN d’une clé KMS gérée par le client dans la même région que celle où se trouve votre compartiment à usage général.

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

   Ce Role champ est obligatoire lorsque vous activez une table d'annotations pour la première fois ou lorsque vous modifiez le rôle IAM. Le rôle doit accorder à Amazon S3 Metadata l'autorisation de lire les annotations de votre compartiment. Pour plus d'informations, consultez la section Rôle IAM dans la table d'annotations.

   Si vous souhaitez désactiver une table d'annotations existante, utilisez la configuration suivante :

   {
     "ConfigurationState": "DISABLED"  }
   

2. Utilisez la commande suivante pour mettre à jour la configuration de la table d'annotations pour votre compartiment à usage général (par exemple,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