Affichage des balises des compartiments de répertoires - Amazon Simple Storage Service
AutorisationsRésolution des erreursÉtapes

Affichage des balises des compartiments de répertoires

Vous pouvez afficher ou répertorier les balises appliquées à des compartiments de répertoires S3. Pour en savoir plus sur les balises, consultez Utilisation de balises avec des compartiments de répertoires S3.

Autorisations

Pour afficher les balises appliquées à un compartiment de répertoires, vous devez disposer de l’autorisation suivante :

  • s3express:ListTagsForResource

Résolution des erreurs

Si vous rencontrez une erreur lorsque vous tentez de répertorier ou d’afficher les balises d’un compartiment de répertoires :

  • Vérifiez que vous disposez des Autorisations requises pour afficher ou répertorier les balises du compartiment de répertoires.

Étapes

Vous pouvez afficher les balises appliquées à des compartiments de répertoires à l’aide de la console Amazon S3, de l’AWS Command Line Interface(AWS CLI), de l’API REST Amazon S3 ou des kits AWS SDK.

Pour afficher les balises appliquées à un compartiment 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 Compartiments de répertoires.

  3. Choisissez le nom du compartiment.

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

  5. Faites défiler la section Balises pour afficher toutes les balises appliquées au compartiment de répertoires.

  6. La section Balises affiche les balises définies par l’utilisateur par défaut. Vous pouvez sélectionner l’onglet Balises générées par AWS pour afficher les balises appliquées à votre compartiment de répertoires par les services AWS.

Cette section fournit un exemple illustrant comment afficher les balises appliquées à un compartiment de répertoires à l’aide des kits AWS SDK.

SDK for Java 2.x

L’exemple suivant montre comment afficher les balises d’un compartiment de répertoires à l’aide du AWS SDK for Java 2.x. 

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceRequest;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceResponse;

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

        ListTagsForResourceRequest listTagsForResourceRequest = ListTagsForResourceRequest.builder()
                .resourceArn("arn:aws::s3express:us-west-2:111122223333:bucket/my-directory-bucket--usw2-az1--x-s3")
                .accountId("111122223333")
                .build();

        ListTagsForResourceResponse response = s3Control.listTagsForResource(listTagsForResourceRequest);
        System.out.println("Tags on my resource:");
        System.out.println(response.toString());
    }
}

Pour plus d’informations sur la prise en charge de l’API REST Amazon S3 pour l’affichage des balises appliquées à un compartiment 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 afficher les balises appliquées à un compartiment de répertoires à l’aide de l’interface de ligne de commande. Pour utiliser cette commande, remplacez les espaces réservés à la saisie utilisateur par vos propres informations.

Requête :

aws s3control list-tags-for-resource \
--account-id 111122223333 \
--resource-arn arn:aws::s3express:us-east-1:444455556666:bucket/prefix--use1-az4--x-s3 \

Réponse : balises présentes :

{
  "Tags": [
      {
          "Key": "MyKey1",
          "Value": "MyValue1"
      },
      {
          "Key": "MyKey2",
          "Value": "MyValue2"
      },
      {
          "Key": "MyKey3",
          "Value": "MyValue3"
      }
  ]
}

Réponse : aucune balise présente :

{
  "Tags": []
}