Règles de dénomination des compartiments à usage général

Lorsque vous créez un compartiment à usage général, veillez à tenir compte de la longueur, des caractères valides, du formatage et du caractère unique des noms de compartiment. Les sections suivantes fournissent des informations sur la dénomination des compartiments à usage général, y compris les règles de dénomination, les meilleures pratiques et proposent un exemple de création de compartiments dans l'espace de noms régional de votre compte. Un exemple de création d'un compartiment à usage général dont le nom inclut un identifiant unique mondial (GUID).

Pour en savoir plus sur les noms des clés d’objet, consultez Création de noms de clés d’objet.

Pour créer un compartiment à usage général, consultez Création d’un compartiment à usage général.

Règles de dénomination des compartiments à usage général

Les règles de dénomination suivantes s’appliquent aux compartiments à usage général.

Règles de dénomination des espaces de noms régionaux des comptes

Bien que les compartiments à usage général Amazon S3 existent dans un espace de noms global partagé, vous pouvez éventuellement créer des compartiments dans l'espace de noms régional de votre compte. L'espace de noms régional du compte est une subdivision réservée de l'espace de noms de compartiment global dans laquelle seul votre compte peut créer des compartiments à usage général. Les nouveaux compartiments à usage général créés dans l'espace de noms régional de votre compte sont propres à votre compte et ne peuvent jamais être recréés par un autre compte. Ces compartiments prennent en charge toutes les fonctionnalités et AWS services S3 que les compartiments à usage général de l'espace de noms global partagé prennent déjà en charge. Vos applications n'ont pas besoin d'être modifiées pour interagir avec les compartiments de l'espace de noms régional de votre compte.

Les compartiments à usage général de l'espace de noms régional de votre compte doivent respecter une convention de dénomination spécifique. Ces compartiments se composent d'un préfixe de nom de compartiment que vous créez et d'un suffixe contenant votre Compte AWS identifiant à 12 chiffres, le Région AWS code, et se terminant par. -an

bucket-name-prefix-accountId-region-an

Par exemple, le compartiment à usage général suivant existe dans l'espace de noms régional du compte pour Compte AWS 111122223333 dans la région us-west-2 :

amzn-s3-demo-bucket-111122223333-us-west-2-an

Pour créer un compartiment dans l'espace de noms régional de votre compte, vous faites une CreateBucket demande et vous spécifiez l'en-tête de la x-amz-bucket-namespace demande avec la valeur définie account-regional sur En plus de spécifier un nom de compartiment au format de l'espace de noms régional du compte :. customer-chosen-name-AWS-Account-ID-AWS-Region-an Par exemple, vous pouvez spécifier de créer un compartiment nommé : amzn-s3-demo-bucket-111122223333-us-east-1-an où se trouve le suffixe régional de votre compte. -111122223333-us-east-1-an Pour plus d'informations sur les espaces de noms régionaux des comptes, consultezEspaces de noms pour les buckets à usage général.

Exemples de noms de compartiments à usage général

Les exemples suivants montrent les caractères autorisés dans les noms de compartiment à usage général : a-z, 0-9 et trait d’union (-). Le préfixe réservé amzn-s3-demo- n’est utilisé ici qu’à titre d’illustration. Étant donné qu’il s’agit d’un préfixe réservé, vous ne pouvez pas créer de noms de compartiment commençant par amzn-s3-demo-.

Les exemples suivants montrent les noms des compartiments dans l'espace de noms régional de votre compte. Ces compartiments doivent respecter la convention de dénomination des espaces de noms régionaux spécifiques aux comptes : customer-chosen-name-AWS-Account-ID-AWS-Region-an

Les exemples de nom de compartiment ci-dessous sont valides, mais ils ne sont pas recommandés pour un usage autre que l’hébergement de sites web statiques, car ils contiennent des points (.) :

Les exemples de noms de compartiment suivants ne sont pas valides :

Bonnes pratiques

Lorsque vous nommez vos compartiments à usage général, tenez compte des bonnes pratiques de dénomination suivantes.

Créez des compartiments dans l'espace de noms régional de votre compte

Nous vous recommandons de créer des compartiments dans l'espace de noms régional de votre compte afin de vous assurer que seul votre compte pourra être propriétaire de ces noms de compartiments. Grâce aux espaces de noms régionaux des comptes, vous pouvez créer des noms de compartiment prévisibles sur plusieurs comptes en Régions AWS étant assuré qu'aucun autre compte ne peut créer de noms de compartiment dans votre espace de noms.

Choisir un schéma de dénomination de compartiment qui ne risque pas d’entraîner de conflits de nom

Si votre application crée les compartiments automatiquement, pensez à choisir un schéma de dénomination qui ne risque pas d’entraîner des conflits de nom. Vous devez veiller à ce que la logique applicative sélectionne un autre nom lorsqu’un nom de compartiment est déjà utilisé.

Ajouter des identifiants uniques globaux (GUID) aux noms de compartiments

Nous vous recommandons de créer des noms de compartiment impossibles à deviner. N’écrivez pas de code en supposant que le nom du compartiment que vous avez choisi est disponible, sauf si vous avez déjà créé ce compartiment. Une méthode pour créer des noms de compartiment impossibles à deviner consiste à ajouter un identificateur unique global (GUID) au nom de votre compartiment, par exemple, amzn-s3-demo-bucket-a1b2c3d4-5678-90ab-cdef-example11111. Pour de plus amples informations, veuillez consulter Création d’un compartiment qui utilise un GUID dans son nom.

Évitez d'utiliser les règles (.) dans les noms des compartiments

Pour une meilleure compatibilité, nous vous déconseillons d’utiliser des points (.) dans les noms des compartiments, à l’exception des compartiments utilisés uniquement à des fins d’hébergement de sites web statiques. Si vous incluez des points dans le nom d'un bucket, vous ne pouvez pas utiliser l'adressage de type hôte virtuel via HTTPS, sauf si vous effectuez vous-même la validation de votre certificat. Les certificats de sécurité utilisés pour l’hébergement virtuel de compartiments ne sont pas compatibles avec les compartiments dont le nom contient un point.

Cette limitation n’affecte pas les compartiments utilisés pour l’hébergement de sites web statiques, car ce type d’hébergement n’est disponible que sur HTTP. Pour en savoir plus sur l’adressage de type hébergement virtuel, consultez Hébergement virtuel des compartiments à usage général. Pour plus d’informations sur l’hébergement de sites web statiques, consultez Hébergement d’un site Web statique à l’aide d’Amazon S3.

Choisir un nom pertinent

Lorsque vous nommez un compartiment, nous vous recommandons de choisir un nom pertinent pour vous ou votre entreprise. Évitez d’utiliser des noms associés à d’autres. Par exemple, évitez d’utiliser AWS ou Amazon dans le nom de votre compartiment.

Ne pas supprimer les compartiments pour pouvoir réutiliser leur nom

Si un compartiment est vide, vous pouvez le supprimer. Une fois qu’un compartiment a été supprimé, son nom peut être réutilisé. Cependant, rien ne garantit que vous pourrez réutiliser ce nom immédiatement, ni même ultérieurement. Après avoir supprimé un bucket dans l'espace de noms global partagé, un certain temps peut s'écouler avant que vous puissiez réutiliser le nom. En outre, un autre Compte AWS utilisateur peut créer un compartiment portant le même nom avant que vous ne puissiez réutiliser ce nom.

Après avoir supprimé un compartiment à usage général dans l'espace de noms global partagé, sachez qu'un autre Compte AWS compartiment de la même partition peut utiliser le même nom de compartiment à usage général pour un nouveau compartiment et peut donc potentiellement recevoir des demandes destinées au compartiment à usage général supprimé. Pour l’éviter, ou si vous souhaitez continuer à utiliser le nom de ce compartiment à usage général, ne supprimez pas le compartiment. Nous vous recommandons de vider et de conserver le compartiment, et de bloquer toutes les demandes adressées au compartiment si nécessaire.

Création d’un compartiment qui utilise un GUID dans son nom

Les exemples suivants vous montrent comment créer un compartiment à usage général incluant un GUID à la fin de son nom.

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket1$(uuidgen | tr -d - | tr '[:upper:]' '[:lower:]' ) \
    --region us-west-1 \
    --create-bucket-configuration LocationConstraint=us-west-1

import com.amazonaws.regions.Regions;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.Bucket;
import com.amazonaws.services.s3.model.CreateBucketRequest;

import java.util.List;
import java.util.UUID;

public class CreateBucketWithUUID {
    public static void main(String[] args) {
        final AmazonS3 s3 = AmazonS3ClientBuilder.standard().withRegion(Regions.US_EAST_1).build();
        String bucketName = "amzn-s3-demo-bucket" +  UUID.randomUUID().toString().replace("-", "");
        CreateBucketRequest createRequest = new CreateBucketRequest(bucketName);
        System.out.println(bucketName);
        s3.createBucket(createRequest);
    }
}                

Création d'un compartiment dans l'espace de noms régional de votre compte

Les exemples suivants vous montrent comment créer un compartiment à usage général dans l'espace de noms régional de votre compte.

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket-012345678910-us-west-1-an \
    --bucket-namespace account-regional
    --region us-west-1 \
    --create-bucket-configuration LocationConstraint=us-west-1