Membuat dan memperbarui label untuk project

Dokumen ini memberikan detail tentang cara membuat dan memperbarui label untuk project menggunakan gcloud CLI, Cloud Resource Manager API, dan Google Cloud konsol.

Membuat label untuk project

Konsol

Untuk menambahkan label ke satu project:

  1. Buka halaman Labels di Google Cloud konsol.

    Membuka halaman Labels

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

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

  4. Setelah selesai menambahkan label, klik Save.

Untuk menambahkan label untuk lebih dari satu project secara bersamaan:

  1. Buka halaman Manage resources di Google Cloud konsol.

    Membuka halaman Manage resources

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

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

  4. Setelah selesai menambahkan label, klik Save.

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 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 perbarui.
  • 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 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 untuk satu project:

  1. Buka halaman Labels di Google Cloud konsol.

    Membuka halaman Labels

  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 buat perubahan yang diinginkan.
    2. Untuk menghapus label, tahan pointer di atas kunci atau nilai, lalu klik .

  4. Setelah selesai memperbarui label, klik Save.

Untuk memperbarui label untuk lebih dari satu project secara bersamaan:

  1. Buka halaman Manage resources di Google Cloud konsol.

    Membuka halaman Manage resources

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

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

    1. Untuk mengedit label, klik nilai yang ingin Anda edit, lalu buat perubahan yang diinginkan.
    2. Untuk menghapus label, tahan pointer di atas kunci atau nilai, lalu klik .

  4. Setelah selesai memperbarui label, klik Save.

gcloud

Untuk memperbarui label untuk 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 perbarui.