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, notamment les règles de dénomination, les bonnes pratiques et 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.

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

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 plus d’informations, consultez 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. Le tableau ci-dessous répertorie les sous-ressources qui vous permettent de gérer les configurations associées à un compartiment donné. 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 compartiment, un certain temps peut s’écouler avant que vous ne puissiez réutiliser son nom. En outre, un autre Compte AWS peut créer un compartiment portant le même nom avant que vous ne réutilisiez le nom.

Une fois que vous avez supprimé un compartiment à usage général, sachez qu’un autre Compte AWS de la même partition peut attribuer le nom de ce compartiment à un nouveau compartiment, qui 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);
    }
}