Tag dan label

Halaman ini berisi penjelasan mengenai tag dan label yang dapat Anda tetapkan pada resource Cloud Storage.

Ringkasan

Tag Google Cloud dan label bucket Cloud Storage adalah dua cara untuk mengatur resource Cloud Storage.

Tag dan label berfungsi secara independen satu sama lain, dan Anda dapat menggunakan keduanya di bucket yang sama.

Tag

Tag adalah key-value pair yang dapat diterapkan ke resource Anda untuk kontrol akses yang mendetail 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 guna menerapkan batasan pada resource. Anda juga dapat menggunakan tag tersebut 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 tetap memerlukan izin IAM berikut untuk menetapkan dan mengelola tag pada bucket:

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

Izin ini dapat diwarisi melalui peran khusus atau peran standar, 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.

Detail harga untuk tag

Tag yang dilampirkan ke bucket dikenai biaya bulanan.

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 dan persistent disk. Misalnya, Anda menginginkan kunci bernama team yang memiliki nilai alpha, beta, dan delta, yang akan digunakan untuk menunjukkan tim mana yang terkait dengan tim resource Google Cloud tertentu. Anda dapat menerapkan label team:alpha, team:beta, dan team:delta ke resource yang diinginkan 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 penggunaan label guna mengatur resource Anda dalam penagihan, lihat Ekspor Penagihan ke Contoh Kueri BigQuery.

Detail harga untuk label

Label yang ditetapkan pada bucket tidak dikenai biaya bulanan.

Langkah selanjutnya