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 menu 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 ditambahkan.

  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 Kelola resource, 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 ditambahkan.

  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 agar Anda dapat melihat pratinjau hasilnya.

REST

Untuk membuat project baru dengan label, tetapkan kolom labels saat Anda 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 untuk project yang sudah ada:

Setelah menambahkan label, Anda dapat memfilter project berdasarkan label. Untuk mengetahui detail tentang penggunaan label untuk memfilter project, lihat Mencantumkan 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 menu 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 untuk lebih dari satu project sekaligus:

  1. Buka halaman Manage resources di konsol Google Cloud.

    Buka halaman Kelola resource

  2. Di halaman Kelola resource, 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 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.

REST

Untuk memperbarui label project, lakukan hal 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 update.

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"
        },
    }
    ]
}