Ajout d'une balise à un point d'accès pour les compartiments de répertoire

Vous pouvez ajouter des balises aux points d'accès Amazon S3 pour les compartiments de répertoire et modifier ces balises. Pour plus d’informations, consultez Utilisation de balises avec des points d'accès S3 pour les compartiments de répertoire.

Autorisations

Pour ajouter une balise à un point d'accès pour les compartiments de répertoire, 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 pour les compartiments de répertoire, vous pouvez effectuer les opérations suivantes :

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

• 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 points d'accès pour les compartiments de répertoire à 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.

Utilisation de la console S3

Pour ajouter des balises à un point d'accès pour les compartiments de répertoire à 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 Access Points (Directory Buckets).

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

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

5. Accédez à la section Tags et choisissez Ajouter un nouveau tag.

6. Cela ouvre la page Ajouter des balises. 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 la valeur de la balise existante.

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

9. Après avoir ajouté le ou les tags, choisissez Enregistrer les modifications.

À l'aide du AWS SDKs

SDK for Java 2.x

Cet exemple montre comment ajouter des balises à un point d'accès pour les compartiments de répertoire à 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: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());
    }
}

Utilisation de l'API REST

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 pour les compartiments de répertoire, consultez la section suivante du manuel Amazon Simple Storage Service API Reference :

• TagResource

En utilisant le AWS CLI

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 bucket de répertoire à l'aide du AWS CLI. Pour utiliser la commande, remplacez les user input placeholders 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
  }
}