Ajouter un tag à un bucket - Amazon Simple Storage Service
PermissionsRésolution des erreursÉtapes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Ajouter un tag à un bucket

Vous pouvez ajouter des balises aux compartiments Amazon S3 et modifier ces balises. L'utilisation de balises sur des buckets n'entraîne aucun frais supplémentaire au-delà des taux de requêtes standard de l'API S3. Pour plus d’informations, consultez Tarification Amazon S3. Pour plus d'informations sur le balisage des buckets, consultez. Utilisation de balises avec des compartiments S3 à usage général

Permissions

Pour ajouter un tag à un bucket, vous devez disposer des autorisations suivantes :

  • s3:TagResource

Résolution des erreurs

Si vous rencontrez une erreur lorsque vous tentez d'ajouter une balise à un bucket, vous pouvez effectuer les opérations suivantes :

  • Vérifiez que vous disposez des éléments requis Permissions pour ajouter un tag à un bucket.

  • Si vous avez essayé d'ajouter une clé de balise commençant par le préfixe AWS réservéaws:, modifiez la clé de balise et réessayez.

Étapes

Vous pouvez ajouter des balises aux compartiments à l'aide de la console Amazon S3, de l'interface de ligne de AWS commande (AWS CLI), de l'API REST Amazon S3 et AWS SDKs.

Pour ajouter des balises à un compartiment à l'aide de la console Amazon S3 :

  1. Connectez-vous à la console Amazon S3 à l'adresse https://console.aws.amazon.com/s3/.

  2. Dans le volet de navigation de gauche, choisissez buckets.

  3. Choisissez le nom du compartiment.

  4. Choisissez l’onglet Propriétés.

  5. Faites défiler la section Balises et choisissez Ajouter une balise.

  6. La page Ajouter des balises s’ouvre. Vous pouvez saisir jusqu’à 50 paires clé-valeur de balise.

  7. Si vous ajoutez une nouvelle balise portant le même nom de clé qu’une balise existante, la valeur de la nouvelle balise remplace celle de l’ancienne balise.

  8. Vous pouvez également modifier les valeurs des clés existantes sur cette page.

  9. Après avoir ajouté les balises, choisissez Enregistrer les modifications.

SDK for Java 2.x

Cet exemple montre comment ajouter des balises à un compartiment à usage général à l'aide du AWS SDK for Java 2.x. Pour utiliser la commande, remplacez les user input placeholders par vos propres informations. 

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;
import software.amazon.awssdk.services.s3control.model.TagResourceResponse;

public class TagResourceExample {
    public static void tagResourceExample() {
        S3ControlClient s3Control = S3ControlClient.builder().region(Region.US_WEST_2).build();

        TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                .resourceArn("arn:aws::s3:::bucket/my-bucket")
                .accountId("111122223333")
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();

        TagResourceResponse response = s3Control.tagResource(tagResourceRequest);
        System.out.println("Status code (should be 204):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}

Pour plus d'informations sur la prise en charge de l'API REST Amazon S3 pour l'ajout de balises à un compartiment à usage général, consultez la section suivante du manuel Amazon Simple Storage Service API Reference :

Pour installer la AWS CLI, reportez-vous à la section Installation de la AWS CLI dans le guide de AWS Command Line Interface l'utilisateur.

L'exemple de CLI suivant vous montre comment ajouter des balises à un compartiment à usage général à l'aide du AWS CLI. Pour utiliser la commande, remplacez les user input placeholders par vos propres informations.

Requête :

aws s3control tag-resource --resource-arn arn:aws:s3:::amzn-s3-demo-bucket --region us-east-2 --account-id 444455556666 --tags '[{"Key":"mykey","Value":"myvalue"}]'