Lihat kebijakan penempatan

Dokumen ini menjelaskan cara melihat kebijakan penempatan. Secara khusus, dokumen ini menjelaskan cara melihat kebijakan penempatan yang tersedia dalam project tertentu, atau melihat detail konfigurasi salah satu kebijakan tersebut.

Sebelum memulai

  • Tinjau batasan untuk kebijakan penempatan.
  • Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

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

    gcloud

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init
    2. Menetapkan 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, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init

Peran yang diperlukan

Agar mendapatkan izin yang Anda perlukan untuk melihat atau menghapus kebijakan penempatan, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

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

Izin yang diperlukan

Izin berikut diperlukan untuk melihat atau menghapus kebijakan penempatan:

  • Untuk melihat daftar kebijakan penempatan Anda: compute.resourcePolicies.list di project
  • Untuk melihat detail kebijakan penempatan: compute.resourcePolicies.get di project

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

Melihat kebijakan penempatan Anda

Untuk melihat kebijakan penempatan yang tersedia dalam project tertentu, pilih salah satu metode berikut:

Lihat daftar kebijakan penempatan Anda

Anda dapat melihat daftar semua kebijakan penempatan dalam project tertentu menggunakan gcloud CLI dan REST.

gcloud

Untuk melihat daftar kebijakan penempatan, gunakan perintah gcloud compute resource-policies list dengan tanda --filter ditetapkan ke groupPlacementPolicy:*.

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

Outputnya mirip dengan hal berikut ini:

NAME: policy-1
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2023-07-15T02:10:51.958-08:00

NAME: policy-2
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2023-07-15T02:11:16.826-08: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 penempatan yang berada di wilayah tertentu, buat permintaan GET ke metode resourcePolicies.list. Dalam URL permintaan, sertakan parameter kueri filter dan tetapkan ke groupPlacementPolicy%3A*.

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

Ganti kode berikut:

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

  • REGION: wilayah tempat satu atau beberapa kebijakan penempatan berada.

Outputnya mirip dengan hal berikut ini:

{
  "kind": "compute#resourcePolicyList",
  "id": "projects/example-project/regions/us-central1/resourcePolicies",
  "items": [
    {
      "kind": "compute#resourcePolicy",
      "id": "637231102400797797",
      "creationTimestamp": "2023-07-28T04:12:11.072-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/policy-1",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "policy-1",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED"
      },
      "status": "READY"
    },
    {
      "kind": "compute#resourcePolicy",
      "id": "1228789480840827204",
      "creationTimestamp": "2023-07-15T02:10:51.958-08:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/policy-2",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "policy-2",
      "groupPlacementPolicy": {
        "availabilityDomainCount": 2
      },
      "status": "READY"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies",
  "etag": "-L7XCupTQ5V9__TOJ8G5RDcR2cY=/g_xt0udkOM_tU7jSL0z9I2Sivis="
}

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

Melihat detail kebijakan penempatan

Anda dapat melihat detail kebijakan penempatan dalam project tertentu menggunakan gcloud CLI dan REST.

gcloud

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

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

Ganti kode berikut:

  • POLICY_NAME: nama kebijakan penempatan yang ada.

  • REGION: region tempat kebijakan penempatan berada.

Outputnya mirip dengan hal berikut ini:

creationTimestamp: '2023-07-15T02:10:51.958-08:00'
groupPlacementPolicy:
  availabilityDomainCount: 2
id: '1228789480840827204'
kind: compute#resourcePolicy
name: pp2
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/example-policy
status: READY

REST

Untuk melihat detail kebijakan penempatan, 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 penempatan yang ingin Anda lihat detailnya berada.

  • REGION: region tempat kebijakan penempatan berada.

  • POLICY_NAME: nama kebijakan penempatan yang ada.

Outputnya mirip dengan hal berikut ini:

{
  "kind": "compute#resourcePolicy",
  "id": "637231102400797797",
  "creationTimestamp": "2023-07-28T04:12:11.072-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "policy-1",
  "groupPlacementPolicy": {
      "availabilityDomainCount": 2
  },
  "status": "READY"
}

Apa langkah selanjutnya?