Halaman ini membahas kolom metadata yang disimpan bersama dengan bucket di Cloud Storage.
Pengantar
Bucket Cloud Storage memiliki metadata yang terkait dengannya. Metadata
mengidentifikasi properti bucket dan menentukan cara bucket ditangani
saat diakses.
Metadata disimpan sebagai pasangan key: value, dengan value dapat mengambil berbagai
bentuk, termasuk string, array, atau bahkan pasangan key:value yang disusun secara bertingkat. Misalnya, nama bucket adalah string, sedangkan konfigurasi Pengelolaan Siklus Proses Objek
bucket adalah array aturan yang setiap aturannya berisi beberapa pasangan
key: value turunan.
Metadata memiliki mutabilitas yang bervariasi:
Beberapa metadata hanya dapat Anda lihat.
Beberapa metadata hanya dapat ditetapkan saat bucket pertama kali dibuat, dan tidak dapat diedit atau dihapus.
Beberapa metadata dapat Anda tambahkan dan edit, tetapi tidak dapat dihapus.
Beberapa metadata dapat Anda tambahkan, edit, dan hapus kapan saja.
Metadata yang tidak dapat diedit
Metadata berikut ditetapkan selama pembuatan bucket, dan tidak dapat diedit atau
dihapus:
Nomor pembuatan bucket mengidentifikasi versi
bucket secara unik meskipun lebih dari satu versi bucket memiliki nama yang sama.
Nilai pembuatan bucket tidak akan berubah.
Tidak ada jaminan bahwa nomor generasi untuk versi berikutnya akan meningkat, hanya saja setiap versi baru akan memiliki nomor generasi yang unik.
Tidak ada hubungan antara nomor generasi dari bucket yang tidak saling berkaitan.
Nomor metagenerasi
Nomor metageneration bucket secara unik mengidentifikasi status metadata
bucket. Nomor metageneration adalah 1 pada saat pembuatan bucket dan bertambah setiap kali Anda mengubah metadata bucket.
Metadata yang dapat diedit
Metadata bucket yang dapat diedit adalah metadata yang nilainya biasanya dapat Anda ubah
kapan saja. Dalam beberapa kasus, seperti bucket yang dikenai batasan kebijakan organisasi, ada pembatasan terhadap pengubahan nilai metadata tertentu.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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)."]]
