Ajout d’une balise à un point d’accès de compartiments de répertoires - Amazon Simple Storage Service
AutorisationsRésolution des erreursÉtapes

Ajout d’une balise à un point d’accès de compartiments de répertoires

Vous pouvez ajouter des balises à des points d’accès Amazon S3 de compartiments de répertoires et modifier ces balises. Pour en savoir plus, voir Utilisation de balises avec des points d’accès S3 pour les compartiments de répertoires.

Autorisations

Pour ajouter une balise à un point d’accès de compartiments de répertoires, vous devez disposer des autorisations suivantes :

  • s3express:TagResource

Résolution des erreurs

Si vous rencontrez une erreur lorsque vous tentez d’ajouter une balise à un point d’accès de compartiments de répertoires :

  • Vérifiez que vous disposez des Autorisations requises pour ajouter une balise à un point d’accès de compartiments de répertoires.

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

Étapes

Vous pouvez ajouter des balises à des points d’accès de compartiments de répertoires à l’aide de la console Amazon S3, de l’interface de ligne de commande AWS (AWS CLI), de l’API REST Amazon S3 et des kits AWS SDK.

Pour ajouter des balises à un point d’accès de compartiments de répertoires à 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 Points d’accès (compartiments de répertoires).

  3. Choisissez le nom du point d’accès.

  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 point d’accès pour compartiment de répertoires à l’aide du AWS SDK for Java 2.x. Pour utiliser cette commande, remplacez les espaces réservés à la saisie utilisateur 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:region:111122223333:accesspoint/my-access-point/*")
                .accountId("111122223333")
                .tags(Tag.builder().key("key1").value("value1").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 point d’accès de compartiments de répertoires, consultez la section suivante dans la Référence des API Amazon Simple Storage Service :

Pour installer l’interface de ligne de commande AWS, consultez Installation de l’interface de ligne de commande AWS dans le Guide de l’utilisateur AWS Command Line Interface.

L’exemple d’interface de ligne de commande suivant montre comment ajouter des balises à un compartiment de répertoires à l’aide de l’AWS CLI. Pour utiliser cette commande, remplacez les espaces réservés à la saisie utilisateur par vos propres informations.

Requête :

aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn arn:aws::s3express:region:444455556666:bucket/prefix--use1-az4--x-s3 \
--tags "Key=key1,Value=value1"

Réponse :

{
  "ResponseMetadata": {
      "RequestId": "EXAMPLE123456789",
      "HTTPStatusCode": 200,
      "HTTPHeaders": {
          "date": "Wed, 19 Jun 2025 10:30:00 GMT",
          "content-length": "0"
      },
      "RetryAttempts": 0
  }
}