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 générale des compartiments, notamment les règles de dénomination, les meilleures pratiques et 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 avec un nom incluant un identifiant unique global (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 du compte

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 compartiments global dans lequel 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 tous les AWS services S3 déjà pris en charge par les compartiments à usage général de l'espace de noms global partagé. Vos applications ne nécessitent aucune modification 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 bucket à 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 bucket 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 sur, account-regional ainsi que le nom du bucket au format d'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 de 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 au compte : 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 buckets 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 pour vous assurer que seul votre compte pourra détenir ces noms de compartiments. Avec les espaces de noms régionaux des comptes, vous pouvez créer des noms de compartiments prévisibles sur plusieurs comptes Régions AWS en vous assurant 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 identificateurs uniques globaux (GUIDs) 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.

Ne pas utiliser pas de points (.) 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' virtual-host-styleadressage via HTTPS, sauf si vous validez vous-même le 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 plus d'informations sur l' virtual-host-styleadressage, consultezHé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. Une fois que vous avez supprimé un bucket dans l'espace de noms global partagé, il peut s'écouler un certain temps avant que vous puissiez réutiliser le nom. En outre, un autre Compte AWS utilisateur peut créer un bucket portant le même nom avant que vous puissiez le réutiliser.

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 bucket dans l'espace de noms régional de votre compte

Les exemples suivants vous montrent comment créer un bucket à 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