Membuat dan memperbarui label untuk project

Label memungkinkan Anda mengatur project Google Cloud dan melacak biaya di seluruh tim atau lingkungan. Untuk mengelola label project, Anda dapat menggunakan konsolGoogle Cloud , Google Cloud CLI, atau Cloud Resource Manager API.

Label hanya berlaku untuk project. Folder dan resource organisasi tidak mendukung label, dan label yang Anda lampirkan ke project tidak otomatis diterapkan ke resource turunan. Untuk menerapkan atau memperbarui label pada resource layanan tertentu seperti instance Compute Engine atau bucket Cloud Storage, lihat dokumentasi resource atau Layanan yang mendukung label. Misalnya, Pub/Sub mendukung label untuk penagihan throughput topik dan langganan, tetapi SKU penagihan egress tidak mendukung label.

Membuat label untuk project

Konsol

Untuk menambahkan label ke satu project:

  1. Buka halaman Label di konsol Google Cloud .

    Buka halaman Label

  2. Pilih project Anda dari drop-down Select a project.

  3. Untuk menambahkan entri label baru, klik + Tambahkan label, lalu masukkan kunci dan nilai label untuk setiap label yang ingin Anda tambahkan.

  4. Setelah selesai menambahkan label, klik Simpan.

Untuk menambahkan label untuk lebih dari satu project sekaligus:

  1. Buka halaman Manage resources di konsol Google Cloud .

    Buka halaman Kelola resource

  2. Di halaman Manage resources, pilih project yang ingin Anda tambahi label.

  3. Di panel info, di tab Labels, klik + Add label dan masukkan kunci dan nilai label untuk setiap label yang ingin Anda tambahkan.

  4. Setelah selesai menambahkan label, klik Simpan.

Setelah menambahkan label, Anda dapat memfilter project dengan mengetik kunci atau nilai label di kotak filter di atas daftar project. Kotak filter akan menyarankan kunci dan nilai sehingga Anda dapat melihat pratinjau hasilnya.

gcloud

Untuk membuat project baru dengan label menggunakan gcloud CLI, gunakan perintah gcloud projects create dengan flag --labels:

gcloud projects create PROJECT_ID \
    --labels=KEY1=VALUE1,KEY2=VALUE2

Untuk menambahkan label ke project yang sudah ada, gunakan perintah gcloud projects update dengan flag --update-labels:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

Dengan:

  • PROJECT_ID adalah ID project yang ingin Anda buat atau update.
  • KEY1=VALUE1 adalah pasangan nilai kunci untuk label yang ingin Anda tambahkan.

REST

Untuk membuat project baru dengan label, sertakan kolom labels saat Anda membuat permintaan POST ke metode projects.create:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "PROJECT_ID",
    "displayName": "PROJECT_NAME",
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects"

Untuk menambahkan label ke project yang sudah ada, gunakan metode projects.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

Memperbarui label untuk project

Konsol

Untuk memperbarui label satu project:

  1. Buka halaman Label di konsol Google Cloud .

    Buka halaman Label

  2. Pilih project Anda dari drop-down Select a project.

  3. Perbarui label untuk project Anda:

    1. Untuk mengedit label, klik nilai yang ingin Anda edit, lalu lakukan perubahan yang diinginkan.
    2. Untuk menghapus label, arahkan kursor ke kunci atau nilai, lalu klik .

  4. Setelah selesai memperbarui label, klik Simpan.

Untuk memperbarui label pada beberapa project sekaligus:

  1. Buka halaman Manage resources di konsol Google Cloud .

    Buka halaman Kelola resource

  2. Di halaman Manage resources, pilih project yang ingin Anda perbarui labelnya.

  3. Di panel info, klik tab Labels dan perbarui label untuk project yang dipilih:

    1. Untuk mengedit label, klik nilai yang ingin Anda edit, lalu lakukan perubahan yang diinginkan.
    2. Untuk menghapus label, arahkan kursor ke kunci atau nilai, lalu klik .

  4. Setelah selesai memperbarui label, klik Simpan.

gcloud

Untuk memperbarui label project menggunakan gcloud CLI, gunakan perintah gcloud projects update dengan flag --update-labels, --remove-labels, atau --clear-labels.

Untuk menambahkan atau memperbarui label:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

Untuk menghapus label tertentu:

gcloud projects update PROJECT_ID \
    --remove-labels=KEY1,KEY2

Untuk menghapus semua label dari project:

gcloud projects update PROJECT_ID \
    --clear-labels

REST

Untuk memperbarui label project menggunakan API, kirim permintaan PATCH ke metode projects.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "color": "red"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

Dengan PROJECT_ID adalah ID project yang ingin Anda update.