Ringkasan

Dokumen ini memberikan ringkasan singkat tentang label dan fiturnya.

Apa yang dimaksud dengan label?

Label adalah pasangan nilai kunci yang dapat Anda tetapkan ke resource Google Cloud . Label membantu Anda mengatur resource ini dan mengelola biaya dalam skala besar, dengan perincian yang Anda butuhkan. Anda dapat menghubungkan label ke tiap resource, lalu memfilter resource menurut labelnya. Informasi tentang label akan diteruskan ke sistem penagihan, sehingga Anda dapat mengelompokkan tagihan biaya berdasarkan label. Dengan laporan penagihan bawaan, Anda dapat memfilter dan mengelompokkan biaya berdasarkan label resource. Anda juga dapat menggunakan label untuk membuat kueri ekspor data penagihan.

Persyaratan untuk label

Label yang diterapkan ke resource harus memenuhi persyaratan berikut:

  • Setiap resource dapat memiliki maksimal 64 label.
  • Setiap label harus berupa pasangan nilai kunci.
  • Kunci memiliki panjang minimum 1 karakter dan panjang maksimum 63 karakter, serta tidak boleh kosong. Nilai boleh kosong dan memiliki panjang maksimum 63 karakter.
  • Kunci dan nilai hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda pisah. Semua karakter harus menggunakan encoding UTF-8, dan boleh menggunakan karakter internasional. Kunci harus diawali dengan huruf kecil atau karakter internasional.
  • Bagian kunci label harus unik dalam satu resource. Namun, Anda dapat menggunakan kunci yang sama dengan beberapa resource.

Batasan ini berlaku untuk kunci dan nilai untuk setiap label, serta untuk setiap resource Google Cloud yang memiliki label. Tidak ada batasan jumlah label yang dapat diterapkan di semua resource dalam satu project.

Penggunaan label secara umum

Berikut adalah beberapa kasus penggunaan umum untuk label:

  • Label tim atau pusat biaya: Tambahkan label berdasarkan tim atau pusat biaya untuk membedakan resource yang dimiliki oleh tim yang berbeda (misalnya, team:research dan team:analytics). Anda dapat menggunakan jenis label ini untuk akuntansi atau penganggaran biaya.

  • Label komponen: Misalnya, component:redis, component:frontend, component:ingest, dan component:dashboard.

  • Label lingkungan atau tahap: Misalnya, environment:production dan environment:test.

  • Label status: Misalnya, state:active, state:readytodelete, dan state:archive.

  • Label kepemilikan: Digunakan untuk mengidentifikasi tim yang bertanggung jawab atas operasi, misalnya: team:shopping-cart.

  • Label jaringan: Label dapat dilampirkan ke virtual machine. Tag jaringan yang Anda tentukan sebelumnya akan muncul sebagai label tanpa nilai.

Sebaiknya Anda tidak membuat label unik dalam jumlah besar, seperti untuk stempel waktu atau nilai individu bagi tiap panggilan API. Masalah dari pendekatan ini adalah ketika nilai sering berubah atau dengan adanya kunci yang mengacaukan katalog, pemfilteran dan pelaporan resource secara efektif akan sulit dilakukan.

Label dan tag

Label dapat digunakan sebagai anotasi yang dapat dikueri untuk resource, tetapi tidak dapat digunakan untuk menetapkan kondisi pada kebijakan. Tag menyediakan cara untuk mengizinkan atau menolak kebijakan secara bersyarat berdasarkan apakah resource memiliki tag tertentu, dengan memberikan kontrol terperinci atas kebijakan. Untuk informasi selengkapnya, lihat Ringkasan tag.

Izin

Izin berikut diperlukan saat Anda perlu menambahkan, mengubah, dan melihat label untuk project:

  • Anda dapat menambahkan atau mengubah label dengan memanggil metode projects.patch(). Tindakan ini memerlukan izin resourcemanager.projects.update.
  • Anda dapat melihat label project dengan memanggil metode projects.get(). Tindakan ini memerlukan izin resourcemanager.projects.get.

Memahami biaya menggunakan label

Anda dapat melampirkan label ke resource, lalu memfilter resource berdasarkan labelnya. Informasi tentang label diteruskan ke sistem penagihan, sehingga Anda dapat mengelompokkan tagihan biaya berdasarkan label.

Berikut adalah beberapa cara Anda dapat menggunakan label untuk memahami biaya:

  • Anda dapat menambahkan label seperti costcenter=cost_center_name, service=service_name, dan environment=environment_name ke VM atau bucket Cloud Storage Anda. Hal ini memungkinkan Anda memahami tempat deployment resource, tujuannya, dan pusat biaya yang harus ditagih.
  • Anda dapat mengaktifkan ekspor data penagihan ke BigQuery. Label diekspor ke BigQuery dengan resource Google Cloud yang sesuai dan penggunaannya. Dengan begitu, Anda dapat memantau aspek seperti biaya untuk menjalankan layanan keranjang belanja di aplikasi atau biaya mesin pengujian developer.
  • Anda dapat menggunakan BigQuery bersama dengan label untuk memahami biaya semua resource sistem pengujian dibandingkan dengan resource produksi atau biaya layanan tertentu.

Contoh

Dalam contoh ini, biaya layanan playlist untuk project ditentukan dengan mengekspor penggunaan dan label ke BigQuery. Untuk melakukannya, mulai dengan mengaktifkan ekspor penagihan ke BigQuery. labels-demo-prj adalah sumber penggunaan resource Anda dan labels_demo_bqexport adalah set data tujuan tempat data penggunaan disimpan. Setelah mengekspor penggunaan dan label ke BigQuery, Anda dapat menentukan biaya layanan playlist.

Berikut adalah detail penggunaan Compute Engine dan biaya terkaitnya di BigQuery.

.