Mengelola label

Halaman ini menunjukkan cara menggunakan label dengan instance Filestore. Artikel ini juga menjelaskan cara menambahkan, memperbarui, dan menghapus label untuk sebuah instance. Label dapat digunakan untuk mengelompokkan instance terkait dan menyimpan metadata tentang suatu instance.

Apa itu label?

Label adalah pasangan nilai kunci yang dapat Anda tetapkan ke instance Google Cloud Filestore. Label membantu Anda mengatur resource ini dan mengelola biaya dalam skala besar, dengan perincian yang Anda butuhkan. Anda dapat melampirkan label ke setiap resource, lalu memfilter resource berdasarkan labelnya. Informasi tentang label diteruskan ke sistem penagihan, yang memungkinkan Anda mengelompokkan tagihan menurut 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 masing-masing 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 instance Filestore yang dimiliki oleh tim yang berbeda (misalnya, team:research dan team:analytics). Anda dapat menggunakan jenis label ini untuk penghitungan biaya atau penganggaran.

  • 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.

Sebaiknya jangan membuat label unik dalam jumlah besar, seperti untuk stempel waktu atau nilai individual untuk setiap panggilan API. Masalah dari pendekatan ini adalah ketika nilai sering berubah atau dengan kunci yang mengacaukan katalog, ini akan menyulitkan pemfilteran dan pelaporan resource secara efektif.

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.

Menambahkan atau memperbarui label instance

Anda dapat menambahkan label ke instance Filestore saat membuat instance. Setelah instance dibuat, Anda dapat menambahkan lebih banyak label ke instance tersebut, serta memperbarui atau menghapus label yang ada.

Konsol

  1. Di konsol Google Cloud, buka halaman Instance Filestore.

    Buka halaman instance Filestore

  2. Pilih kotak centang di samping setiap instance yang labelnya ingin Anda ubah.

  3. Klik Tampilkan panel info.

  4. Tambahkan dan perbarui label sesuai kebutuhan:

    Operasi Petunjuk
    Menambahkan label Klik Tambahkan label, lalu ketik kunci dan nilai untuk label.
    Memperbarui label Perbarui kolom Nilai. Anda tidak dapat memperbarui Kunci dari label yang ada.
    Menghapus label Klik Hapus item di sebelah label.

  5. Klik Simpan untuk menyimpan perubahan setelah selesai melakukan update.

gcloud

Anda dapat mengedit label instance Filestore dengan menjalankan perintah instances update. Untuk menambahkan label baru atau mengubah nilai label yang ada, gunakan flag --update-labels. Untuk menghapus satu atau beberapa label, gunakan flag --remove-labels. Flag --clear-labels akan menghapus semua label dari instance.

gcloud filestore instances update instance-id \
    --project=project-id \
    --zone=zone \
    --update-labels key=value,[key=value,…] \
    --remove-labels key,[key,…] \
    --clear-labels

dengan:

  • instance-id adalah ID instance instance yang ingin Anda edit.

  • project-id adalah project ID dari project Google Cloud yang berisi instance Filestore. Anda dapat melewati flag ini jika instance Filestore berada dalam project default gcloud. Anda dapat menetapkan project default dengan menjalankan:

     gcloud config set project project-id

  • zone adalah zona tempat instance Filestore berada. Jalankan perintah gcloud filestore zones list untuk mendapatkan daftar zona yang didukung. Anda dapat melewati flag ini jika instance Filestore berada di zona default gcloud. Anda dapat menetapkan zona default dengan menjalankan:

     gcloud config set filestore/zone zone

  • key adalah label baru, atau label yang ada yang ingin Anda ubah atau hapus.

  • value adalah nilai untuk label.

Contoh

Contoh berikut mengupdate instance nfs-server dengan menambahkan label status, memperbarui nilai label dept, dan menghapus label admin.

gcloud filestore instances update nfs-server \
    --project=myproject \
    --zone=us-central1-c \
    --update-labels status=active \
    --update-labels dept=accounting \
    --remove-labels admin

Layanan yang saat ini mendukung label

Layanan Google Cloud berikut kini mendukung label:

  • AI Platform
  • App Engine (lingkungan Fleksibel dan Standar)
  • Artifact Registry
  • BigQuery
  • Certificate Authority Service
  • Cloud Composer
  • Bigtable
  • Cloud Deployment Manager
  • Cloud Functions
  • Cloud Healthcare API
  • Cloud Key Management Service
  • Cloud Run
  • Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Dataflow
  • Dataproc
  • Filestore
  • Google Kubernetes Engine
  • Networking
  • Pub/Sub
  • Resource Manager (khusus project)

Langkah selanjutnya

Pelajari cara mengedit properti lain dari instance Filestore.