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

Di konsol Google Cloud, buka halaman Instance Filestore.

Buka halaman instance Filestore
Pilih kotak centang di samping setiap instance yang labelnya ingin Anda ubah.
Klik Tampilkan panel info.

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.

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.