Auf dieser Seite werden die Metadatenfelder erläutert, die zusammen mit Buckets in Cloud Storage gespeichert werden.
Einführung
Mit Cloud Storage-Buckets sind Metadaten verknüpft. Metadaten identifizieren Eigenschaften des Buckets und geben an, wie der Bucket behandelt werden soll, wenn auf ihn zugegriffen wird.
Metadaten werden als key: value-Paare gespeichert, wobei der value eine Vielzahl von Formen annehmen kann, einschließlich Strings, Arrays oder sogar verschachtelter key:value-Paare. Der Bucket-Name ist beispielsweise ein String, während eine Bucket-Konfiguration für die Objektlebenszyklus-Verwaltungs ein Array von Regeln ist, in dem jede Regel mehrere untergeordnete key: value-Paare enthält.
Die Veränderbarkeit von Metadaten variiert:
Einige können nur ansehen.
Einige können Sie nur festlegen, wenn der Bucket erstellt wird, und können nicht bearbeitet oder entfernt werden.
Einige können zwar hinzugefügt und bearbeitet, aber nicht entfernt werden.
Einige können jederzeit hinzugefügt, bearbeitet oder entfernt werden.
Nicht editierbare Metadaten
Die folgenden Metadaten werden während der Bucket-Erstellung festgelegt und können weder bearbeitet noch entfernt werden:
Die Generierungsnummer eines Buckets identifiziert die Version des Buckets eindeutig, auch wenn mehrere Versionen eines Buckets denselben Namen haben.
Der Generationswert eines Buckets ändert sich nie.
Es gibt keine Garantie dafür, dass die Generierungsnummern für aufeinanderfolgende Versionen erhöht werden, nur dass jede neue Version eine eindeutige Generierungsnummer hat.
Zwischen den Generierungsnummern unabhängiger Buckets besteht keinerlei Zusammenhang.
Metagenerierungsnummer
Die Metagenerierungsnummer eines Buckets identifiziert den Metadatenstatus des Buckets eindeutig. Die Meta-Generierungsnummer lautet zum Zeitpunkt der Bucket-Erstellung 1 und erhöht sich jedes Mal, wenn Sie die Metadaten des Buckets ändern.
Editierbare Metadaten
Bearbeitbare Bucket-Metadaten sind Metadaten, deren Werte Sie normalerweise jederzeit ändern können. In einigen Fällen, z. B. wenn der Bucket einer Organisationsrichtlinieneinschränkung unterliegt, bestehen Einschränkungen beim Ändern bestimmter Metadatenwerte.
1 Diese Metadaten können nicht mit der XML API angezeigt oder verwaltet werden.
2 Sie können die XML API verwenden, um diese Metadaten während der Bucket-Erstellung festzulegen, jedoch nicht zum Anzeigen oder Verwalten dieser Metadaten.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-18 (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)."]]
