Membuat dan memperbarui label untuk project

Dokumen ini memberikan detail tentang cara membuat dan memperbarui label untuk project menggunakan Resource Manager API dan Konsol Google Cloud. Panduan ini memberikan detail tentang cara memahami biaya menggunakan label dan layanan yang 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 Pilih project.

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

  4. Setelah selesai menambahkan label, klik Simpan.

Untuk menambahkan label ke lebih dari satu project secara bersamaan:

  1. Buka halaman Manage resources di Konsol Google Cloud.

    Buka halaman Kelola resource

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

  3. Di panel info, di tab Label, klik + Tambahkan label, lalu masukkan kunci label dan nilai untuk setiap label yang ingin ditambahkan.

  4. Setelah selesai menambahkan label, klik Simpan.

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

REST

Untuk membuat project baru dengan label, tetapkan kolom labels saat membuat project.

Permintaan:

POST https://cloudresourcemanager.googleapis.com/v3/projects

{
 "labels": {
  "color": "red"
 },
 "name": "myproject",
 "projectId": "our-project-123"
}

Respons:

{
 "projectNumber": "333197460082",
 "projectId": "our-project-123",
 "lifecycleState": "ACTIVE",
 "name": "myproject",
 "labels": {
  "color": "red"
 },
 "createTime": "2016-01-12T22:18:28.633Z",
}

Untuk menambahkan label ke project yang sudah ada:

Setelah menambahkan label, Anda dapat memfilter project berdasarkan label. Untuk mengetahui detail tentang penggunaan label untuk memfilter project, lihat Listingan Project.

Memperbarui label untuk project

Konsol

Untuk memperbarui label untuk satu project:

  1. Buka halaman Label di Konsol Google Cloud.

    Buka halaman Label

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

  3. Perbarui label untuk project Anda:

    1. Untuk mengedit label, klik nilai yang ingin diedit, lalu buat perubahan yang diinginkan.
    2. Untuk menghapus label, tahan kursor ke kunci atau nilai, lalu klik .
  4. Setelah selesai memperbarui label, klik Simpan.

Untuk memperbarui label di 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 labelnya ingin Anda perbarui.

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

    1. Untuk mengedit label, klik nilai yang ingin diedit, lalu buat perubahan yang diinginkan.
    2. Untuk menghapus label, tahan kursor ke kunci atau nilai, lalu klik .
  4. Setelah selesai memperbarui label, klik Simpan.

REST

Untuk memperbarui label project, lakukan langkah berikut:

  • Dapatkan objek project menggunakan metode projects.get().

  • Ubah label yang ingin Anda perbarui.

  • Panggil metode projects.patch.

Contoh berikut memperbarui label color:blue:

Cuplikan kode berikut mengubah nilai label color dari blue menjadi red.

Permintaan:

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NAME
{
  updateMask=labels
}

Dengan PROJECT_NAME adalah nama project yang ingin Anda perbarui.

Meminta isi JSON:

{
    "labels":
      {
        "color": "red"
      }
}

Respons:

{
    "projects": [
    {
        "name": "projects/123456789012",
        "parent": "folders/123456789012",
        "projectId": "my-project",
        "state": "ACTIVE",
        "displayName": "PROJECT_NAME"
        "createTime": "2013-11-13T20:31:53.308Z"
        "updateTime": "2013-11-13T20:35:42.308Z"
        "etag": "BwWUlZ6XEfY="
        "labels": {
            "color": "red"
        },
    }
    ]
}