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

Création de compartiments de répertoires avec des balises

Vous pouvez baliser des compartiments de répertoires Amazon S3 lors de leur création. L’utilisation de balises sur des compartiments de répertoires n’occasionne aucun coût supplémentaire, en dehors des tarifs standard des demandes d’API S3. Pour plus d’informations, consultez Tarification Amazon S3. Pour plus d’informations sur le balisage des compartiments de répertoires, consultez Utilisation de balises avec des compartiments de répertoires S3.

Autorisations

Pour créer un compartiment de répertoires avec des balises, vous devez disposer des autorisations suivantes :

  • s3express:CreateBucket

  • s3express:TagResource

Résolution des erreurs

Si vous rencontrez une erreur lorsque vous tentez de créer un compartiments de répertoires avec des balises :

  • Vérifiez que vous disposez des Autorisations requises pour créer le compartiment de répertoires et y ajouter une balise.

  • Vérifiez votre politique utilisateur IAM pour connaître les conditions du contrôle d’accès par attributs (ABAC). Il peut vous être demandé de baliser vos compartiments de répertoires uniquement avec des clés et des valeurs de balise spécifiques. Pour plus d’informations, consultez Utilisation de balises pour le contrôle d’accès par attributs (ABAC).

Étapes

Vous pouvez créer un compartiment de répertoires avec des balises à l’aide de la console Amazon S3, de l’AWS Command Line Interface (AWS CLI), de l’API REST Amazon S3 et des kits AWS SDK.

Pour créer un compartiment de répertoires avec des balises à 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 Créer un compartiment pour créer un compartiment de répertoires.

  4. Vous pouvez créer deux types de compartiments de répertoires :

    Un compartiment de répertoires dans une zone de disponibilité pour les charges de travail à hautes performances. Pour plus d’informations, consultez Charges de travail hautes performances.

    Un compartiment de répertoires dans une zone locale pour les charges de travail de résidence de données. Pour plus d’informations, consultez Charges de travail liées à la résidence des données.

  5. Pour les deux types de compartiments de répertoires, sur la page Créer un compartiment, l’option Balises s’affiche lors de la création d’un compartiment de répertoires.

  6. Nommez le compartiment. Pour plus d’informations, consultez Règles de dénomination des compartiments de répertoires.

  7. Choisissez Ajouter une nouvelle balise pour ouvrir l’éditeur Balises et saisissez une paire clé-valeur de balise. La clé de balise est obligatoire, mais la valeur est facultative.

  8. Pour ajouter une autre balise, sélectionnez à nouveau Ajouter une nouvelle balise. Vous pouvez saisir jusqu’à 50 paires clé-valeur.

  9. Après avoir spécifié les options de votre nouveau compartiment de répertoires, choisissez Créer un compartiment.

SDK for Java 2.x

Cet exemple montre comment créer un compartiment de répertoires avec des balises à 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.s3.S3Client;
import software.amazon.awssdk.services.s3.model.BucketInfo;
import software.amazon.awssdk.services.s3.model.BucketType;
import software.amazon.awssdk.services.s3.model.CreateBucketConfiguration;
import software.amazon.awssdk.services.s3.model.CreateBucketRequest;
import software.amazon.awssdk.services.s3.model.CreateBucketResponse;
import software.amazon.awssdk.services.s3.model.DataRedundancy;
import software.amazon.awssdk.services.s3.model.LocationInfo;
import software.amazon.awssdk.services.s3.model.LocationType;
import software.amazon.awssdk.services.s3.model.Tag;

public class CreateBucketWithTagsExample {
    public static void createBucketWithTagsExample() {
        S3Client s3 = S3Client.builder().region(Region.US_WEST_2).build();

        CreateBucketConfiguration bucketConfiguration = CreateBucketConfiguration.builder()
                .location(LocationInfo.builder()
                        .type(LocationType.AVAILABILITY_ZONE)
                        .name("usw2-az1").build())
                .bucket(BucketInfo.builder()
                        .type(BucketType.DIRECTORY)
                        .dataRedundancy(DataRedundancy.SINGLE_AVAILABILITY_ZONE)
                        .build())
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();

        CreateBucketRequest createBucketRequest = CreateBucketRequest.builder()
                .bucket("amzn-s3-demo-bucket--usw2-az1--x-s3--usw2-az1--x-s3")
                .createBucketConfiguration(bucketConfiguration)
                .build();

        CreateBucketResponse response = s3.createBucket(createBucketRequest);
        System.out.println("Status code (should be 200):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}

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

Lorsque vous créez un compartiment de répertoires, vous devez fournir les détails de configuration et utiliser la convention de dénomination suivante : bucket-base-name--zone-id--x-s3

Requête :

aws s3api create-bucket \
--bucket bucket-base-name--zone-id--x-s3 \
--create-bucket-configuration "Location={Type=AvailabilityZone,Name=zone-id},Bucket={DataRedundancy=SingleAvailabilityZone,Type=Directory},Tags=[{Key=mykey1,Value=myvalue1}, {Key=mykey2,Value=myvalue2}]"

Réponse :

{
  "Location": "http://bucket--use1-az4--x-s3.s3express-use1-az4.us-east-1.amazonaws.com/"
}