

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
<a name="bucket-create-tag"></a>

Vous pouvez baliser 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](https://docs.aws.amazon.com/s3/pricing/). Pour plus d'informations sur le balisage des buckets, consultez. [Utilisation de balises avec des compartiments S3 à usage général](buckets-tagging.md)

## Permissions
<a name="bucket-create-tag-permissions"></a>

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
<a name="bucket-create-tag-troubleshooting"></a>

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](#bucket-create-tag-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)](tagging.md#using-tags-for-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](buckets-tagging-enable-abac.md). 

## Étapes
<a name="bucket-create-tag-steps"></a>

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.

## Utilisation de la console S3
<a name="bucket-create-tag-console"></a>

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/](https://console.aws.amazon.com/s3/).

1. Dans le volet de navigation de gauche, choisissez **buckets**.

1. Choisissez **Create bucket** pour créer un nouveau bucket.

1. Créez un bucket à usage général comme vous le feriez normalement ; voir[Création d’un compartiment à usage général](create-bucket-overview.md).

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

1. Nommez le compartiment. Pour de plus amples informations, veuillez consulter [Règles de dénomination des compartiments à usage général](bucketnamingrules.md). 

1. 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. 

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

1. Après avoir défini les options de votre nouveau compartiment, choisissez **Create bucket**. 

## En utilisant le AWS SDKs
<a name="bucket-create-tag-sdks"></a>

------
#### [ 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());
    }
}
```

------

## Utilisation de l'API REST
<a name="bucket-tag-delete-api"></a>

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* :
+ [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)

## À l'aide du AWS CLI
<a name="bucket-create-tag-cli"></a>

Pour installer la AWS CLI, reportez-vous à la section [Installation de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 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/"
}
```