Nesta página, você encontra informações sobre os campos de metadados que são armazenados junto com buckets
no Cloud Storage.
Introdução
Os buckets do Cloud Storage têm metadados associados a eles. Os metadados identificam propriedades do bucket e especificam como ele será processado quando for acessado.
Os metadados são armazenados como pares de key: value, em que value pode assumir várias
formas, incluindo strings, matrizes ou até mesmo pares de key:value aninhados. Por
exemplo, o nome do bucket é uma string, enquanto uma configuração do Gerenciamento do ciclo de vida de objetos
do bucket é uma matriz de regras em que cada regra contém vários pares de
key: value filhos.
A mutabilidade dos metadados varia:
Alguns só podem ser visualizados.
Alguns deles só podem ser definidos quando o bucket for criado pela primeira vez e não podem ser editados
ou removidos.
Algumas pessoas podem adicionar e editar, mas não remover.
Algumas podem ser adicionadas, editadas e removidas a qualquer momento.
Metadados não editáveis
Os metadados a seguir são definidos durante a criação do bucket e não podem ser editados ou removidos:
O número de geração de um bucket identifica exclusivamente a versão do bucket, mesmo que mais de uma versão de um bucket compartilhe o mesmo nome.
O valor de geração de um bucket nunca muda.
Não há garantia de que os números de geração aumentem para versões sucessivas, apenas que cada nova versão tem um número de geração exclusivo.
Não há relação entre os números de geração de buckets não relacionados.
Número de metageneration
O número de metageneration de um bucket identifica exclusivamente o estado de metadados do
bucket. O número de metageneration é 1 no momento da criação do bucket
e aumenta sempre que você modifica os metadados do bucket.
Metadados editáveis
Os metadados de bucket editáveis são metadados com valores que geralmente podem ser modificados a
qualquer momento. Em alguns casos, como o bucket sujeito a uma
restrição da política da organização, há restrições de modificação
de determinados valores de metadados.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)."]]
