Création de compartiments de répertoire avec des balises - Amazon Simple Storage Service
AutorisationsRé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.

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

Vous pouvez baliser les compartiments de répertoire Amazon S3 lorsque vous les créez. L'utilisation de balises sur des compartiments de répertoire est gratuite, 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 compartiments de répertoire, consultez. Utilisation de balises avec des compartiments de répertoire S3

Autorisations

Pour créer un bucket de répertoire 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 bucket de répertoire avec des balises, vous pouvez effectuer les opérations suivantes :

  • Vérifiez que vous disposez des informations nécessaires Autorisations pour créer le bucket de répertoire et y ajouter une balise.

  • Vérifiez votre politique utilisateur IAM pour connaître toutes les conditions de contrôle d'accès basé sur les attributs (ABAC). Il se peut que vous deviez étiqueter vos compartiments de répertoire uniquement avec des clés et des valeurs de balise spécifiques. Pour de plus amples informations, veuillez consulter Utilisation de balises pour le contrôle d'accès basé sur les attributs (ABAC).

Étapes

Vous pouvez créer un compartiment de répertoire avec des balises appliquées à l'aide de la console Amazon S3, du AWS Command Line Interface (AWS CLI), de l'API REST Amazon S3 et AWS SDKs.

Pour créer un compartiment de répertoire 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 des compartiments de répertoire.

  3. Choisissez Create Bucket pour créer un nouveau bucket de répertoire.

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

    Créez un bucket d'annuaire dans une zone de disponibilité pour une charge de travail à hautes performances. Pour de plus amples informations, veuillez consulter Charges de travail hautes performances.

    Créez un compartiment de répertoire dans une zone locale pour une charge de travail de résidence de données. Pour de plus amples informations, veuillez consulter Charges de travail liées à la résidence des données.

  5. Pour les deux types de compartiments de répertoire, sur la page Créer un compartiment, l'option Tags est une option lors de la création d'un nouveau compartiment de répertoire.

  6. Entrez un nom pour le compartiment. Pour de plus amples informations, veuillez consulter .

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

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

  9. Après avoir défini les options de votre nouveau compartiment de répertoire, choisissez Create bucket.

SDK for Java 2.x

Cet exemple montre comment créer un bucket de répertoire avec des balises à 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.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épertoire avec des balises, 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 montre comment créer un compartiment de répertoire avec des balises à l'aide du AWS CLI. Pour utiliser la commande, remplacez les user input placeholders 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/"
}