Création de compartiments à usage général avec des étiquettes - Amazon Simple Storage Service
PermissionsRé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 à usage général avec des étiquettes

Vous pouvez étiqueter les compartiments à usage général Amazon S3 lorsque vous les créez. L'utilisation de balises sur des buckets n'entraîne aucun frais supplémentaire 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 buckets, consultez. Utilisation de balises avec des compartiments S3 à usage général

Permissions

Pour créer un bucket avec des balises, vous devez disposer des autorisations suivantes :

  • s3:CreateBucket

  • s3:TagResource

Amazon S3 Console et utilisez CloudFormation désormais cette fonctionnalité pour créer des buckets avec des balises.

Résolution des erreurs

Si vous rencontrez une erreur lorsque vous tentez de créer un bucket avec des balises, vous pouvez effectuer les opérations suivantes :

  • Vérifiez que vous disposez des éléments nécessaires Permissions pour créer le bucket et y ajouter une étiquette.

  • Vérifiez votre politique IAM pour les aws:TagKeys clés de aws:RequestTag/key-name condition. Il se peut que vous deviez étiqueter vos compartiments 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 par attributs (ABAC).

Note

Amazon S3 utilise CloudFormation désormais cette fonctionnalité pour créer des buckets avec des balises. Lorsque vous créez des buckets avec des balises, notez que les conditions basées sur les balises pour accéder à votre bucket à l'aide aws:ResourceTag de clés de s3:BucketTag condition ne sont applicables qu'une fois que vous avez activé ABAC sur le bucket. Pour en savoir plus, veuillez consulter la section Activation de l'ABAC dans les compartiments à usage général.

Étapes

Vous pouvez créer un compartiment 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 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 buckets.

  3. Choisissez Create bucket pour créer un nouveau bucket.

  4. Créez un bucket à usage général comme vous le feriez normalement ; voirCréation d’un compartiment à usage général.

  5. Sur la page Créer un compartiment, l'option Tags est disponible lors de la création d'un nouveau compartiment.

  6. Nommez le compartiment. Pour de plus amples informations, veuillez consulter Règles de dénomination des compartiments à usage général.

  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 défini les options de votre nouveau compartiment, choisissez Create bucket.

SDK for Java 2.x

Cet exemple montre comment créer un bucket à usage général 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.BucketLocationConstraint;
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.Tag;

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

        CreateBucketConfiguration bucketConfiguration = CreateBucketConfiguration.builder()
                .locationConstraint(BucketLocationConstraint.US_WEST_2)
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();

        CreateBucketRequest createBucketRequest = CreateBucketRequest.builder()
                .bucket("mybucket")
                .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 bucket à usage général 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 vous montre comment créer un bucket 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 bucket, vous devez fournir les détails de configuration et utiliser la convention de dénomination suivante : amzn-s3-demo-bucket

Requête :

aws s3api create-bucket \
--bucket mybucket \
--create-bucket-configuration 'LocationConstraint=us-west-2,Tags=[{Key=MyTagKey,Value=MyTagValue}]' --region us-west-2"

Réponse :

{
  "Location": "http://mybuckets3.amazonaws.com/"
}