Tag dan label

Anda dapat menggunakan Google Cloud tag dan label bucket Cloud Storage untuk mengatur bucket Cloud Storage, mengelola akses, dan menganalisis biaya.

Tag memungkinkan Anda mengelola kontrol akses dan menganalisis data biaya di level bucket, dan di level hierarki resource yang lebih tinggi di seluruh Google Cloud. Anda dapat menggunakan tag untuk memberikan akses bersyarat ke resource dengan mereferensikan tag di binding kebijakan IAM. Anda mengelola tag menggunakan Resource Manager.

Label memungkinkan Anda menerapkan metadata kustom ke bucket menggunakan alat Cloud Storage.

Tag dan label berfungsi secara independen, dan Anda dapat menerapkan keduanya ke bucket yang sama.

Tag

Tag adalah key-value pair yang dapat Anda terapkan ke resource untuk kontrol akses yang terperinci dan data biaya terperinci di level bucket.

Tag dibuat di level organisasi atau project dan dikelola melalui Resource Manager, yang digunakan di seluruh Google Cloud. Setelah melampirkan tag ke bucket Cloud Storage, Anda dapat menggunakan tag dengan IAM Conditions untuk memberikan akses ke resource atau dengan kebijakan organisasi untuk menerapkan batasan pada resource. Anda juga dapat menggunakan tag untuk menganalisis data biaya penggunaan mendetail yang diekspor ke Penagihan Cloud.

Saat menggunakan tag, perhatikan batasan berikut:

  • Tag dapat dilampirkan ke bucket hanya setelah bucket dibuat.

  • Tag tidak dapat diterapkan ke objek.

  • Anda dapat memiliki maksimal 50 binding tag per bucket.

Izin yang diperlukan

Meskipun tag dikelola melalui Resource Manager, Anda memerlukan izin IAM berikut untuk menetapkan dan mengelola tag di bucket:

  • storage.buckets.listTagBindings
  • storage.buckets.listEffectiveTags
  • storage.buckets.createTagBinding
  • storage.buckets.deleteTagBinding

Izin ini dapat diwarisi melalui peran khusus atau peran bawaan, seperti peran Tag User (roles/resourcemanager.tagUser) atau peran Storage Admin (roles/storage.admin).

Contoh untuk melampirkan tag ke bucket Cloud Storage

Setelah membuat dan menentukan tag, Anda dapat melampirkan tag tersebut ke bucket.

Pertimbangkan skenario berikut:

  • Nilai tag memiliki nama 815471563813/color/blue dengan namespace.
  • Bucket Anda diberi nama my-bucket.
  • Bucket Anda berada di us-central1.

Perintah gcloud berikut melampirkan tag ke my-bucket:

gcloud resource-manager tags bindings create \
--tag-value=815471563813/color/blue \
--parent=//storage.googleapis.com/projects/_/buckets/my-bucket \
--location=us-central1

Perintah gcloud berikut melepaskan tag dari my-bucket:

gcloud resource-manager tags bindings delete \
--tag-value=815471563813/color/blue \
--parent=//storage.googleapis.com/projects/_/buckets/my-bucket \
--location=us-central1

Perintah gcloud berikut mencantumkan semua tag yang langsung dilampirkan ke my-bucket, kecuali tag yang diwarisi my-bucket:

gcloud resource-manager tags bindings list \
    --parent=//storage.googleapis.com/projects/_/buckets/my-bucket \
    --location=us-central1

Untuk mendapatkan petunjuk yang lebih mendetail, lihat Melampirkan tag ke resource.

Label bucket

Label bucket memungkinkan Anda membuat pasangan nilai kunci arbitrer yang disimpan sebagai bagian dari metadata bucket. Anda dapat menggunakan label untuk mengatur bucket bersama dengan resource Google Cloud lainnya, seperti instance virtual machine. Misalnya, Anda menginginkan kunci bernama team yang memiliki nilai alpha, beta, dan delta, yang akan digunakan untuk menunjukkan tim mana yang terkait dengan resource Google Cloud tertentu. Anda dapat menerapkan label team:alpha, team:beta, dan team:delta ke resource untuk mencapai hal ini.

Perhatikan hal-hal berikut saat menggunakan label bucket:

  • Panjang kunci dan nilai masing-masing tidak boleh lebih dari 63 karakter.
  • Kunci dan nilai hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda pisah. Karakter internasional diperbolehkan.
  • Kunci label harus diawali dengan huruf kecil dan karakter internasional diperbolehkan.
  • Kunci label tidak boleh kosong.
  • Setiap bucket dapat memiliki maksimum 64 label yang diterapkan secara aktif.
  • Seperti umumnya untuk metadata bucket, label bucket tidak terkait dengan masing-masing objek atau metadata objek.

Untuk contoh umum cara menggunakan label guna mengatur resource Anda untuk penagihan, lihat Contoh kueri untuk ekspor data Penagihan Cloud.

Langkah berikutnya