Melihat kebijakan beban kerja

Dokumen ini menjelaskan cara melihat kebijakan beban kerja.

Setelah membuat dan menerapkan kebijakan workload ke grup instance terkelola (MIG), Anda dapat melihat detail konfigurasi kebijakan tersebut. Melihat kebijakan workload membantu Anda mendapatkan ringkasan semua kebijakan workload dalam project Anda, atau memverifikasi detail konfigurasi kebijakan tertentu.

Untuk mempelajari lebih lanjut persyaratan dan batasan yang Anda terapkan saat membuat kebijakan workload, lihat artikel Tentang kebijakan workload.

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    gcloud

    1. Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  • Tetapkan region dan zona default.

    • REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk melihat kebijakan workload, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat kebijakan workload. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat kebijakan workload:

  • Untuk melihat daftar kebijakan workload Anda: compute.resourcePolicies.list on the project
  • Untuk melihat detail kebijakan workload: compute.resourcePolicies.get on the project

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Melihat kebijakan workload Anda

Untuk melihat kebijakan workload yang ada di project Anda, gunakan salah satu metode berikut:

Melihat daftar kebijakan beban kerja Anda

Untuk melihat daftar semua kebijakan workload dalam project Anda, pilih salah satu opsi berikut:

gcloud

Untuk melihat daftar kebijakan beban kerja, gunakan perintah gcloud compute resource-policies list dengan flag --filter yang ditetapkan ke workloadPolicy:*.

gcloud compute resource-policies list \
    --filter="workloadPolicy:*"

Outputnya mirip dengan hal berikut ini:

NAME: workload-policy-01
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2026-03-18T02:20:11.010-07:00

NAME: workload-policy-02
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2026-03-18T09:24:58.281-07:00

Untuk mengetahui informasi selengkapnya tentang penggunaan ekspresi filter untuk mempersempit daftar resource Compute Engine, lihat perintah gcloud topic filters.

REST

Untuk melihat daftar kebijakan beban kerja di region tertentu, buat permintaan GET ke metode resourcePolicies.list. Di URL permintaan, sertakan parameter kueri filter dan tetapkan ke workloadPolicy%3A*.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies?filter=workloadPolicy%3A*

Ganti kode berikut:

  • PROJECT_ID: ID project tempat Anda ingin melihat daftar kebijakan workload.

  • REGION: region tempat satu atau beberapa kebijakan beban kerja berada.

Outputnya mirip dengan hal berikut ini:

{
  "kind": "compute#resourcePolicyList",
  "id": "projects/example-project/regions/us-central1/resourcePolicies",
  "items": [
    {
      "workloadPolicy": {
        "type": "HIGH_THROUGHPUT"
      },
      "kind": "compute#resourcePolicy",
      "id": "7592369487854686373",
      "creationTimestamp": "2026-03-18T02:20:11.010-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-01",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "workload-policy-01",
      "status": "READY"
    },
    {
      "workloadPolicy": {
        "type": "HIGH_THROUGHPUT",
        "maxTopologyDistance": "BLOCK"
      },
      "kind": "compute#resourcePolicy",
      "id": "5947350722329145141",
      "creationTimestamp": "2026-03-18T09:24:58.281-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-02",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "workload-policy-02",
      "status": "READY"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies",
  "etag": "ntWQ-oLKD9MWsxuxLOpT5pDF0To=/2MdxB9oc-_-zK6Z7g0OIqrUQ0BI="
}

Untuk mengetahui informasi selengkapnya tentang penggunaan ekspresi filter untuk mempersempit daftar kebijakan resource menggunakan enkode URL, lihat parameter kueri filter.

Melihat detail kebijakan workload

Untuk melihat detail kebijakan workload, pilih salah satu opsi berikut:

gcloud

Untuk melihat detail kebijakan beban kerja, gunakan perintah gcloud compute resource-policies describe.

gcloud compute resource-policies describe POLICY_NAME \
    --region=REGION

Ganti kode berikut:

  • POLICY_NAME: nama kebijakan workload yang ada.

  • REGION: region tempat kebijakan beban kerja berada.

Outputnya mirip dengan hal berikut ini:

creationTimestamp: '2026-03-18T02:20:11.010-07:00'
id: '7592369487854686373'
kind: compute#resourcePolicy
name: workload-policy-01
region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-01
status: READY
workloadPolicy:
  type: HIGH_THROUGHPUT

REST

Untuk melihat detail kebijakan beban kerja, buat permintaan GET ke metode resourcePolicies.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

Ganti kode berikut:

  • PROJECT_ID: ID project tempat kebijakan beban kerja yang ingin Anda lihat detailnya berada.

  • REGION: region tempat kebijakan beban kerja berada.

  • POLICY_NAME: nama kebijakan workload yang ada.

Outputnya mirip dengan hal berikut ini:

{
  "workloadPolicy": {
    "type": "HIGH_THROUGHPUT"
  },
  "kind": "compute#resourcePolicy",
  "id": "7592369487854686373",
  "creationTimestamp": "2026-03-18T02:20:11.010-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-01",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "workload-policy-01",
  "status": "READY"
}

Langkah berikutnya