Cette page traite des champs de métadonnées stockés avec des buckets dans Cloud Storage.
Introduction
Les buckets Cloud Storage sont associés à des métadonnées. Les métadonnées identifient les propriétés du bucket et spécifient la manière dont celui-ci doit être géré lorsqu'on y accède.
Les métadonnées sont stockées sous forme de paires key: value, où la value peut prendre différentes formes, y compris des chaînes, des tables ou même des paires key:value imbriquées. Par exemple, le nom du bucket est une chaîne, tandis qu'une configuration de gestion du cycle de vie des objets du bucket est un tableau de règles dans lesquelles chaque règle contient plusieurs paires key: value enfants.
La mutabilité des métadonnées varie :
Certaines ne peuvent être que consultées.
Certaines ne peuvent être définies que lors de la création du bucket, et ne peuvent pas être modifiées ni supprimées.
Certaines peuvent être ajoutées et modifiées, mais pas supprimées.
Certaines peuvent être ajoutées, modifiées et supprimées à tout moment.
Métadonnées non modifiables
Les métadonnées suivantes sont définies lors de la création du bucket, et ne peuvent être ni modifiées, ni supprimées :
Le numéro de génération d'un bucket identifie de manière unique la version du bucket, même si plusieurs versions d'un bucket portent le même nom.
La valeur de génération d'un bucket ne change jamais.
Rien ne garantit que les numéros de génération augmentent pour les versions successives, mais uniquement que chaque nouvelle version possède un numéro de génération unique.
Il n'existe aucun lien entre les numéros de génération de buckets non liés.
Numéro de métagénération
Le numéro de métagénération d'un bucket identifie de manière unique l'état des métadonnées de celui-ci. Le numéro de métagénération est 1 au moment de la création du bucket et augmente chaque fois que vous modifiez les métadonnées du bucket.
Métadonnées modifiables
Les métadonnées de bucket modifiables sont des métadonnées dont vous pouvez généralement modifier les valeurs à tout moment. Dans certains cas, par exemple lorsque le bucket est soumis à une contrainte de règle d'administration, il existe des restrictions concernant la modification de certaines valeurs de métadonnées.
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,["# Bucket metadata\n\n[Get metadata](/storage/docs/getting-bucket-metadata)\n\n[Get bucket size](/storage/docs/getting-bucket-size)\n\nThis page discusses the metadata fields that are stored along with [buckets](/storage/docs/buckets)\nin Cloud Storage.\n\nIntroduction\n------------\n\nCloud Storage buckets have *metadata* associated with them. Metadata\nidentifies properties of the bucket and specifies how the bucket should be\nhandled when it's accessed.\n\nMetadata is stored as `key: value` pairs, where the `value` can take a variety\nof forms, including strings, arrays, or even nested `key:value` pairs. For\nexample, the bucket name is a string, while a bucket Object Lifecycle Management\nconfiguration is an array of rules in which each rule contains several child\n`key: value` pairs.\n\nThe mutability of metadata varies:\n\n- Some you can only view.\n\n- Some you can only set when the bucket is first [created](/storage/docs/creating-buckets), and cannot edit\n or remove.\n\n- Some you can add and edit, but not remove.\n\n- Some you can add, edit, and remove at any time.\n\nNon-editable metadata\n---------------------\n\nThe following metadata is set during bucket creation, and cannot be edited or\nremoved:\n\n- [Bucket name](/storage/docs/buckets#naming)\n\n- The [project](/storage/docs/projects) the bucket is a part of\n\n- Generation number\n\n - A bucket's generation number uniquely identifies the version of the\n bucket even if more than one version of a bucket share the same name.\n\n - A bucket's generation value never changes.\n\n - There is no guarantee that generation numbers increase for successive\n versions, only that each new version has a unique generation number.\n\n - There is no relationship between generation numbers of unrelated buckets.\n\n- Metageneration number\n\n - A bucket's metageneration number uniquely identifies the metadata state of the bucket. The metageneration number is `1` at the time of bucket creation and increases each time you modify the bucket's metadata.\n\nEditable metadata\n-----------------\n\nEditable bucket metadata is metadata whose values you can typically modify at\nany time. In some cases, such as the bucket being subject to an\n[organization policy constraint](/storage/docs/org-policy-constraints), there are restrictions on modifying\ncertain metadata values.\n\n^1^ This metadata cannot be viewed or managed using the XML API.\n\n^2^ You can use the XML API to set this metadata during bucket\ncreation, but not to view or manage this metadata.\n\nWhat's next\n-----------\n\n- Learn how to [view bucket metadata](/storage/docs/getting-bucket-metadata).\n- Read more about [object metadata](/storage/docs/metadata)."]]