En esta página, se analizan los campos de metadatos que se almacenan junto con buckets en Cloud Storage.
Introducción
Los buckets de Cloud Storage tienen metadatos asociados a ellos. Los metadatos identifican las propiedades del bucket y especifican cómo se debe manejar cuando se accede a él.
Los metadatos se almacenan como pares key: value, en los que value puede tomar una variedad de formas, incluidas strings, arrays o incluso pares key:value anidados. Por ejemplo, el nombre del bucket es una string, mientras que una configuración de Administración del ciclo de vida de los objetos del bucket es un array de reglas en el que cada regla contiene varios pares key: value secundarios.
La mutabilidad de los metadatos varía:
Solo puedes ver algunas.
Algunos solo se pueden configurar cuando se crea el bucket por primera vez y no se pueden editar ni quitar.
Algunos se pueden agregar y editar, pero no pueden quitarse.
Algunos se pueden agregar, editar y quitar en cualquier momento.
Metadatos no editables
Los siguientes metadatos se configuran durante la creación del bucket y no se pueden editar ni quitar:
El número de generación de un bucket identifica de forma única la versión del bucket, incluso si más de una versión del bucket comparte el mismo nombre.
El valor de generación de un bucket nunca cambia.
Ten en cuenta que no hay garantía de que los números de generación aumenten para las versiones sucesivas, solo que cada versión nueva tiene un número de generación único.
No existe una relación entre los números de generación de buckets no relacionados.
Número de metageneración
El número de metageneración de un bucket identifica de forma única el estado de los metadatos del bucket. El número de metageneración es 1 en el momento de la creación del bucket y aumenta cada vez que modificas los metadatos del bucket.
Metadatos editables
Los metadatos de bucket editables son metadatos cuyos valores puedes modificar en cualquier momento normalmente. En algunos casos, como cuando el bucket está sujeto a una restricción de políticas de la organización, existen restricciones para modificar ciertos valores de metadatos.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)."]]
