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.
Règles de dénomination des compartiments à usage général
Lorsque vous créez un bucket à usage général, assurez-vous de prendre en compte la longueur, les caractères valides, le formatage et le caractère unique des noms de bucket. 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 plus d'informations sur les noms de clés d'objets, consultez la section Création de noms de clés d'objets.
Pour créer un bucket à usage général, voirCréation d'un bucket à usage général.
Rubriques
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.
-
Les noms de compartiment peuvent comporter entre 3 (min.) et 63 (max.) caractères.
-
Les noms de compartiments ne peuvent être composés que de lettres minuscules, de chiffres, de points (
.
) et de tirets ().-
-
Les noms de compartiment doivent commencer et se terminer par une lettre ou un chiffre.
-
Les noms de compartiment ne doivent pas contenir deux points consécutifs.
-
Les noms des compartiments ne doivent pas être formatés en tant qu'adresse IP (par exemple,
192.168.5.4
). -
Les noms de compartiment ne doivent pas commencer par le préfixe
xn--
. -
Les noms de compartiment ne doivent pas commencer par le préfixe
sthree-
. -
Les noms de compartiment ne doivent pas commencer par le préfixe
amzn-s3-demo-
. -
Les noms de compartiment ne doivent pas se terminer par le suffixe
-s3alias
. Ce suffixe est réservé aux noms d’alias de point d’accès. Pour plus d’informations, consultez Alias de point d'accès. -
Les noms de compartiment ne doivent pas se terminer par le suffixe
--ol-s3
. Ce suffixe est réservé aux noms d’alias de point d’accès Object Lambda. Pour de plus amples informations, veuillez consulter Comment utiliser un alias de type compartiment pour votre point d’accès Object Lambda de compartiment S3. -
Les noms de compartiment ne doivent pas se terminer par le suffixe
.mrap
. Ce suffixe est réservé aux noms de point d’accès multi-régions. Pour de plus amples informations, veuillez consulter Règles relatives à l'attribution de noms pour les points d'accès multi-Régions Amazon S3. -
Les noms de compartiment ne doivent pas se terminer par le suffixe
--x-s3
. Ce suffixe est réservé aux compartiments de répertoires. Pour de plus amples informations, veuillez consulter Règles de dénomination des compartiments de répertoires. -
Les noms de compartiment ne doivent pas se terminer par le suffixe
--table-s3
. Ce suffixe est réservé aux buckets S3 Tables. Pour de plus amples informations, veuillez consulter Règles de dénomination des compartiments de tables, des tables et des espaces de noms Amazon S3. -
Les buckets utilisés avec Amazon S3 Transfer Acceleration ne peuvent pas avoir de points (
.
) dans leur nom. Pour plus d’informations sur Transfer Acceleration, consultez Configuration de transferts de fichiers rapides et sécurisés à l’aide d’Amazon S3 Transfer Acceleration.
Important
-
Les noms des compartiments doivent être uniques Comptes AWS dans tous les compartiments Régions AWS d'une partition. Une partition est un regroupement de régions. AWS possède actuellement trois partitions :
aws
(Régions commerciales),aws-cn
(Régions de Chine) etaws-us-gov
(AWS GovCloud (US) Régions). -
Le nom d'un bucket ne peut pas être utilisé par un autre Compte AWS utilisateur de la même partition tant que le bucket n'est pas supprimé. Après avoir supprimé un bucket, sachez qu'un autre Compte AWS de la même partition peut utiliser le même nom de bucket pour un nouveau bucket et peut donc potentiellement recevoir des demandes destinées au bucket supprimé. Si vous souhaitez empêcher cela, ou si vous souhaitez continuer à utiliser le même nom de bucket, ne supprimez pas le bucket. Nous vous recommandons de vider le compartiment et de le conserver, et de bloquer toutes les demandes de compartiment selon les besoins. Pour les seaux qui ne sont plus utilisés activement, nous recommandons de vider le seau de tous les objets afin de minimiser les coûts tout en conservant le seau lui-même.
-
Lorsque vous créez un bucket à usage général, vous choisissez son nom et le nom dans lequel le Région AWS créer. Une fois le compartiment à usage général créé, vous ne pouvez plus changer son nom ni sa région.
-
N'incluez pas d'informations sensibles dans le nom du bucket. Le nom du compartiment est visible en pointant vers les objets URLs qu'il contient.
Note
Avant le 1er mars 2018, les compartiments créés dans la région USA Est (Virginie du Nord) pouvaient comporter des noms incluant jusqu’à 255 caractères et comprenant des lettres majuscules et des traits de soulignement. À compter du 1er mars 2018, les nouveaux compartiments de la région USA Est (Virginie du Nord) doivent être conformes aux règles appliquées dans toutes les autres régions.
Exemples de noms de compartiments à usage général
Les noms de compartiment suivants présentent des exemples de caractères autorisés dans les noms de compartiments à usage général : a-z, 0-9 et tirets (). -
Le préfixe amzn-s3-demo-
réservé n'est utilisé ici qu'à titre d'illustration. Comme il s'agit d'un préfixe réservé, vous ne pouvez pas créer de noms de bucket commençant par. amzn-s3-demo-
-
amzn-s3-demo-bucket1-a1b2c3d4-5678-90ab-cdef-example11111
-
amzn-s3-demo-bucket
Les exemples de noms de bucket suivants sont valides mais déconseillés pour des utilisations autres que l'hébergement statique de sites Web, car ils contiennent des points (.
) :
-
example.com
-
www.example.com
-
my.example.s3.bucket
Les exemples de noms de compartiment suivants ne sont pas valides :
-
amzn_s3_demo_bucket
(contient des traits de soulignement) -
AmznS3DemoBucket
(contient des lettres majuscules) -
amzn-s3-demo-bucket-
(commence par unamzn-s3-demo-
préfixe et se termine par un trait d'union) -
example..com
(contient deux points d'affilée) -
192.168.5.4
(correspond au format d'une adresse IP)
Bonnes pratiques
Lorsque vous nommez vos compartiments à usage général, tenez compte des meilleures pratiques suivantes en matière de dénomination des compartiments.
Choisissez un schéma de dénomination des compartiments peu susceptible de provoquer des conflits de dénomination
Si votre application crée automatiquement des compartiments, choisissez un schéma de dénomination des compartiments peu susceptible de provoquer des conflits de dénomination. 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 compartiments imprévisibles. N'écrivez pas de code en supposant que le nom de compartiment que vous avez choisi est disponible, sauf si vous l'avez déjà créé. Une méthode pour créer des noms de compartiment imprévisibles consiste à ajouter un identifiant global unique (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 des points (.
) dans les noms de compartiments
Pour une compatibilité optimale, nous vous recommandons d'éviter d'utiliser des points (.
) dans les noms de bucket, sauf pour les buckets utilisés uniquement pour l'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 des buckets ne fonctionnent pas pour les buckets dont le nom contient des points.
Cette limitation n'affecte pas les compartiments utilisés pour l'hébergement de sites Web statiques, car l'hébergement de sites Web statiques n'est disponible que via HTTP. Pour plus d'informations sur l' virtual-host-styleadressage, consultezHébergement virtuel de buckets à 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 bucket, nous vous recommandons de choisir un nom pertinent pour vous ou pour 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 supprimez pas de compartiments afin de pouvoir réutiliser les noms des compartiments
Si un compartiment est vide, vous pouvez le supprimer. Une fois qu’un compartiment a été supprimé, son nom peut être réutilisé. Cependant, il n'est pas garanti que vous puissiez réutiliser le nom immédiatement, ou pas du tout. Après avoir supprimé un bucket, 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, sachez qu'un autre Compte AWS compartiment de la même partition peut utiliser le même nom de compartiment pour un nouveau compartiment et peut donc potentiellement recevoir des demandes destinées au compartiment à usage général supprimé. Si vous souhaitez empêcher cela, ou si vous souhaitez continuer à utiliser le même nom de bucket à usage général, ne supprimez pas le bucket à usage général. Nous vous recommandons de vider le compartiment et de le conserver, et de bloquer toutes les demandes de compartiment selon les besoins.
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.
L' AWS CLI exemple suivant crée un bucket à usage général dans la région USA Ouest (Californie du Nord) (us-west-1
) avec un exemple de nom de bucket qui utilise un identifiant global unique (GUID). Pour utiliser cet exemple de commande, remplacez
par vos propres informations.user input placeholders
aws s3api create-bucket \ --bucket
amzn-s3-demo-bucket1
$(uuidgen | tr -d - | tr '[:upper:]' '[:lower:]' ) \ --regionus-west-1
\ --create-bucket-configuration LocationConstraint=us-west-1
L'exemple suivant vous montre comment créer un avec un GUID à la fin du nom du compartiment dans la région USA Est (Virginie du Nord) (us-east-1
) en utilisant le AWS SDK pour Java. Pour utiliser cet exemple, remplacez
par vos propres informations. Pour plus d'informations sur les autres AWS SDKs, voir Outils sur lesquels s'appuyer AWSuser input placeholders
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); } }