Cette page décrit les buckets, qui sont une ressource dans Cloud Storage. Pour obtenir une présentation générale du fonctionnement de Cloud Storage, consultez la page Présentation du produit Cloud Storage.
Buckets
Les buckets sont les conteneurs de base contenant vos données. Tous les éléments stockés dans Cloud Storage doivent être contenus dans un bucket. Vous pouvez utiliser des buckets pour organiser vos données et en contrôler l'accès, mais contrairement aux répertoires et aux dossiers, vous ne pouvez pas imbriquer des buckets.
Vous pouvez avoir autant de buckets que vous le souhaitez dans un projet ou dans un emplacement.
Lorsque vous créez un bucket, vous lui attribuez un nom unique et un emplacement géographique dans lequel le bucket et son contenu sont stockés.
- Vous ne pouvez pas modifier le nom ou l'emplacement d'un bucket existant. En revanche, vous pouvez créer un bucket avec les propriétés de votre choix et déplacer le contenu de l'ancien bucket vers le nouveau. Pour connaître le détail de la procédure, consultez la page Déplacer et renommer des buckets.
- Les tarifs (tels que les frais de stockage de données, de traitement de données et de transfert de données réseau sortantes) dépendent de facteurs tels que l'emplacement du bucket et les classes de stockage des objets qu'il contient. Pour plus d'informations, consultez la page Tarifs de Cloud Storage.
- Vous pouvez utiliser Identity and Access Management (IAM) pour contrôler l'accès à des buckets individuels.
Noms de buckets
Les noms de vos buckets doivent satisfaire les critères suivants :
- Les noms de buckets ne peuvent contenir que des lettres minuscules, des chiffres, des tirets (
-
), des traits de soulignement (_
) et des points (.
). Les espaces ne sont pas autorisées. Les noms contenant des points doivent être validés. - Les noms de buckets doivent commencer et se terminer par un chiffre ou une lettre.
- Les noms de buckets doivent compter entre 3 et 63 caractères. Ceux qui comportent des points peuvent contenir jusqu'à 222 caractères, mais chaque composant séparé par un point ne peut pas posséder plus de 63 caractères.
- Les noms de buckets ne peuvent pas correspondre à une adresse IP au format décimal à points (par exemple, 192.168.5.4).
- Les noms de buckets ne peuvent pas commencer par le préfixe "goog".
- Les noms de buckets ne peuvent pas contenir "google" ni des termes semblables tels que "g00gle".
Remarques relatives aux noms des buckets
Les noms de buckets se trouvent dans un espace de noms unique partagé par tous les utilisateurs Cloud Storage. Voici ce qui peut se produire :
Le nom de chaque bucket doit être unique.
Si vous tentez de créer un bucket portant un nom déjà attribué à un autre bucket, tel que
example-bucket
, Cloud Storage répond par un message d'erreur.les noms de buckets sont visibles publiquement.
Ne spécifiez pas d'ID utilisateur, d'adresses e-mail, de noms de projets, de numéros de projets ni d'informations personnelles dans les noms de buckets, car tout le monde peut vérifier qu'un bucket existe.
Une fois le bucket supprimé, tout le monde peut réutiliser son nom pour en créer un autre.
Il faut généralement attendre quelques secondes pour que le nom d'un bucket supprimé soit de nouveau disponible. Voici toutefois quelques informations à retenir :
- Si vous supprimez le projet contenant le bucket, qui supprime de fait celui-ci, le nom du bucket ne peut pas être libéré avant plusieurs semaines.
- Si un nouveau bucket portant le même nom est créé à un emplacement différent et dans les 10 minutes suivant la suppression de l'ancien bucket, les requêtes effectuées sur le nouveau bucket pendant cette période de 10 minutes risquent d'échouer en renvoyant une erreur
404-Bucket Not Found
. - Si vos requêtes passent par l'API XML, les tentatives de création d'un bucket qui réutilise un nom dans un nouvel emplacement risquent d'échouer en renvoyant une erreur
404-Bucket Not Found
, pendant un délai maximal de 10 minutes suivant la suppression de l'ancien bucket.
Vous pouvez utiliser un nom de bucket dans un enregistrement DNS dans le cadre d'une redirection
CNAME
ouA
.Pour ce faire, le nom de votre bucket doit être conforme aux conventions de dénomination DNS standards. Pour cette raison, il ne doit pas contenir de trait de soulignement (
_
) ni de point à côté d'un autre point ou d'un trait d'union. Par exemple,..
,-.
et.-
sont des combinaisons de caractères non valides dans les noms DNS.
Exemples de noms de buckets
Voici des exemples de noms de buckets valides :
my-travel-maps
0f75d593-8e7b-4418-a5ba-cb2970f0b91e
test.example.com
(validation de la propriété requise pourexample.com
)
Voici des exemples de noms de buckets non valides :
My-Travel-Maps
(contient des lettres majuscules)my_google_bucket
(contient "google")test bucket
(contient un espace)
Étapes suivantes
- Créez des buckets Cloud Storage.
- Renommez un bucket existant.
- Découvrez les métadonnées associées à un bucket.
- Importez un objet.