Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 dans lesquels sont stockées vos données sous forme d'objets.
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.
Il n'est pas possible de modifier le nom d'un bucket existant. À la place, vous pouvez créer un bucket avec le nom souhaité 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.
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".
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)
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 quelqu'un réutilise le nom de votre bucket, vous ne pourrez pas le restaurer, même si la suppression réversible est activée.
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.
Si quelqu'un réutilise le nom de votre bucket, il peut recevoir par inadvertance des données ou des requêtes destinées à votre bucket d'origine supprimé. Pour atténuer ce risque, tenez compte des bonnes pratiques suivantes :
Lorsque vous créez des buckets, utilisez une convention de dénomination forte, difficile à deviner ou à prédire.
Lorsque vous supprimez des buckets, veillez à supprimer toutes les références au nom du bucket supprimé, par exemple dans la documentation externe ou les dépôts Open Source.
Si vous n'avez plus besoin d'un bucket, envisagez de vider tous les objets du bucket et de le conserver au lieu de le supprimer.
Vous pouvez utiliser un nom de bucket dans un enregistrement DNS dans le cadre d'une redirection CNAME ou A.
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.
Accéder aux données dans des buckets à l'aide de dossiers ou de répertoires
Bien que Cloud Storage stocke les données non structurées sous forme d'objets, certaines fonctionnalités vous permettent d'accéder à vos données et de les gérer à l'aide de dossiers ou de répertoires.
Espace de noms hiérarchique
Lorsque vous créez des buckets, vous pouvez éventuellement activer l'espace de noms hiérarchique pour le bucket, ce qui vous permet d'utiliser des dossiers pour stocker vos objets comme dans un système de fichiers. Organiser vos objets dans des dossiers facilite l'exécution d'opérations sur de grands ensembles de données, ce qui améliore les performances, la cohérence et la facilité de gestion. L'utilisation de buckets avec l'espace de noms hiérarchique activé est particulièrement utile lorsque vous travaillez avec des charges de travail à forte intensité de données et orientées fichiers.
Cloud Storage FUSE est un adaptateur FUSE qui vous permet d'installer des buckets en tant que systèmes de fichiers locaux et d'y accéder. Ainsi, les applications peuvent lire et écrire des objets dans votre bucket à l'aide d'une sémantique standard de système de fichiers. Cloud Storage FUSE vous permet de stocker vos données dans Cloud Storage en profitant de tous les avantages du service, tout en conservant la possibilité d'accéder à ces données à l'aide du code de votre application sans avoir à le modifier.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/05 (UTC)."],[],[],null,["# About Cloud Storage buckets\n\nThis page describes buckets, a resource in Cloud Storage. For a general\noverview of how Cloud Storage works, see the\n[Cloud Storage product overview](/storage/docs/introduction).\n\nBuckets\n-------\n\nBuckets are the basic containers that hold your data as [objects](/storage/docs/objects).\nEverything that you store in Cloud Storage must be contained in a\nbucket. You can use buckets to organize your data and control access to your\ndata, but unlike directories and folders, you cannot nest buckets.\n\n- There is no limit to the number of buckets you can have in a project or\n [location](/storage/docs/locations).\n\n - There are, however, [limits to the rate you can create or delete buckets](/storage/quotas).\n- When you [create a bucket](/storage/docs/creating-buckets), you give it a [globally-unique name](#naming) and a\n [geographic location](/storage/docs/locations) where the bucket and its contents are stored.\n\n - You cannot change the name of an existing bucket. Instead, you can create a new bucket with the name you want and move the contents from the old bucket to the new bucket. See [Move and rename buckets](/storage/docs/moving-buckets) for a step-by-step guide.\n\n\u003c!-- --\u003e\n\n- Pricing (such as charges for data storage, data processing, and network outbound data transfer) depends on factors such as the bucket's location and the storage classes of objects within it. For more details, see [Cloud Storage pricing](/storage/pricing).\n\n\u003c!-- --\u003e\n\n- You can use [Identity and Access Management (IAM)](/storage/docs/access-control/iam) to control access to individual buckets.\n\nBucket names\n------------\n\nYour bucket names must meet the following requirements:\n\n- Bucket names can only contain lowercase letters, numeric characters, dashes (`-`), underscores (`_`), and dots (`.`). Spaces are not allowed. Names containing dots require [verification](/storage/docs/domain-name-verification).\n- Bucket names must start and end with a number or letter.\n- Bucket names must contain 3-63 characters. Names containing dots can contain up to 222 characters, but each dot-separated component can be no longer than 63 characters.\n- Bucket names cannot be represented as an IP address in dotted-decimal notation (for example, 192.168.5.4).\n- Bucket names cannot begin with the \"goog\" prefix.\n- Bucket names cannot contain \"google\" or close misspellings, such as \"g00gle\".\n\n### Example bucket names\n\nThe following are examples of valid bucket names:\n\n- `my-travel-maps`\n- `0f75d593-8e7b-4418-a5ba-cb2970f0b91e`\n- `test.example.com` (Requires [verification of ownership for `example.com`](/storage/docs/domain-name-verification))\n\nThe following are examples of invalid bucket names:\n\n- `My-Travel-Maps` (contains uppercase letters)\n- `my_google_bucket` (contains \"google\")\n- `test bucket` (contains a space)\n\n### Bucket name considerations\n\n- Bucket names reside in a single namespace that is shared by all\n Cloud Storage users. This means that:\n\n - Every bucket name must be globally unique.\n\n If you try to create a bucket with a name that already belongs to an\n existing bucket, such as `example-bucket`, Cloud Storage\n responds with an error message.\n - Bucket names are publicly visible.\n\n Don't use user IDs, email addresses, project names, project numbers, or\n any personally identifiable information (PII) in bucket names because\n anyone can probe for the existence of a bucket.\n- Once you delete a bucket, anyone can reuse its name for a new bucket.\n\n - The time it takes a deleted bucket's name to become available again is\n typically on the order of seconds; however, keep in mind the following:\n\n - If you delete the project that contains the bucket, which effectively\n deletes the bucket as well, the bucket name may not be released for weeks\n or longer.\n\n - If someone reuses your bucket's name, you cannot restore your deleted\n bucket even if the bucket has soft delete enabled.\n\n - If a new bucket with the same name is created in a different location and\n within 10 minutes of the old bucket's deletion, requests made to the new\n bucket during this 10 minute timeframe might fail with a\n `404-Bucket Not Found` error.\n\n - If your requests go through the [XML API](/storage/docs/xml-api), attempts to create a bucket\n that reuses a name in a new location might fail with a\n `404-Bucket Not Found` error for up to 10 minutes after the old bucket's\n deletion.\n\n - If someone reuses your bucket's name, they could inadvertently\n receive data or requests intended for your original deleted bucket. To\n mitigate this risk, consider the following best practices:\n\n - When creating buckets, use a strong naming convention that's not easy to\n guess or predict.\n\n - When deleting buckets, make sure to remove all references of the\n deleted bucket's name, such as from external documentation or open\n source repositories.\n\n - If you no longer need a bucket, consider emptying all objects from\n the bucket and keeping the bucket instead of deleting it.\n\n- You can use a bucket name in a DNS record as part of a `CNAME` or `A`\n redirect.\n\n In order to do so, your bucket name should conform to standard DNS naming\n conventions. This means that your bucket name shouldn't use underscores\n (`_`) or have a period next to another period or dash. For example, `..`,\n `-.`, and `.-` are invalid character combinations within DNS names.\n\nAccess data in buckets by using folders or directories\n------------------------------------------------------\n\nAlthough Cloud Storage stores unstructured data in the form of objects,\nsome features let you access and manage your data using folders or directories.\n\n### Hierarchical namespace\n\nWhen you create buckets, you can optionally enable [hierarchical namespace](/storage/docs/hns-overview)\nfor the bucket, which lets you use [folders](/storage/docs/folders-overview) to store your objects in\na file system manner. Organizing your objects into folders makes it easier to\nrun operations on large scales of data, improving performance, consistency,\nand ease of management. Using buckets with hierarchical namespace enabled is\nespecially beneficial when working with data-intensive and file-oriented\nworkloads.\n\nTo get started using hierarchical namespace, see\n[Create buckets with hierarchical namespace enabled](/storage/docs/create-hns-bucket).\n\n### Cloud Storage FUSE\n\n[Cloud Storage FUSE](/storage/docs/cloud-storage-fuse/overview#overview) is a FUSE adapter that lets you mount and access buckets as\nlocal file systems, so applications can read and write objects in your bucket\nusing standard file system semantics. Cloud Storage FUSE lets you store your data\nin Cloud Storage with all the service's benefits, all while retaining\nthe ability to access that data using your application's code without needing\nchanges.\n\nTo learn how to use Cloud Storage FUSE, see the [Cloud Storage FUSE quickstart](/storage/docs/cloud-storage-fuse/quickstart-mount-bucket).\n\nWhat's next\n-----------\n\n- [Create Cloud Storage buckets](/storage/docs/creating-buckets).\n- [Rename an existing bucket](/storage/docs/moving-buckets).\n- Learn about the [metadata associated with a bucket](/storage/docs/bucket-metadata).\n- [Upload an object](/storage/docs/uploading-objects)."]]
