Melihat kebijakan penempatan

Dokumen ini menjelaskan cara melihat kebijakan penempatan.

Melihat kebijakan penempatan berguna untuk melihat semua kebijakan penempatan yang ada dalam project, atau memverifikasi detail konfigurasi kebijakan penempatan tertentu.

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau contoh 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

Agar mendapatkan izin yang Anda perlukan untuk melihat kebijakan penempatan, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) pada 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 penempatan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat kebijakan penempatan:

  • Untuk melihat daftar kebijakan penempatan Anda: compute.resourcePolicies.list pada project
  • Untuk melihat detail kebijakan penempatan: compute.resourcePolicies.get pada 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, pilih salah satu metode berikut yang dijelaskan dalam dokumen ini:

Melihat daftar kebijakan penempatan Anda

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

gcloud

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

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

Outputnya mirip dengan hal berikut ini:

NAME: example-compact-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:09:24.588-07:00

NAME: example-spread-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:08:13.404-07:00

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

REST

Untuk melihat daftar kebijakan penempatan yang berlokasi di region tertentu, buat permintaan GET ke resourcePolicies.list metode. Di 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: region 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": "5587673659722509355",
      "creationTimestamp": "2024-05-09T02:09:24.588-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "example-compact-policy",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED"
      },
      "status": "READY"
    },
    {
      "kind": "compute#resourcePolicy",
      "id": "5970772604948130963",
      "creationTimestamp": "2024-05-09T02:08:13.404-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "example-spread-policy",
      "groupPlacementPolicy": {
        "availabilityDomainCount": 5
      },
      "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 cara menggunakan ekspresi filter untuk mempersempit daftar kebijakan resource menggunakan encoding URL, lihat filter parameter kueri.

Melihat detail kebijakan penempatan

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

gcloud

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

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:

  • Jika Anda melihat detail kebijakan penempatan ringkas:

    creationTimestamp: '2024-05-09T02:09:24.588-07:00'
groupPlacementPolicy:
  collocation: COLLOCATED
id: '5587673659722509355'
kind: compute#resourcePolicy
name: example-compact-policy
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-compact-policy
status: READY

  • Jika Anda melihat detail kebijakan penempatan spread:

    creationTimestamp: '2024-05-09T02:08:13.404-07:00'
groupPlacementPolicy:
  availabilityDomainCount: 5
id: '5970772604948130963'
kind: compute#resourcePolicy
name: example-spread-policy
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-spread-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 detailnya ingin Anda lihat berada.

  • REGION: region tempat kebijakan penempatan berada.

  • POLICY_NAME: nama kebijakan penempatan yang ada.

Outputnya mirip dengan hal berikut ini:

  • Jika Anda melihat detail kebijakan penempatan ringkas:

    {
  "kind": "compute#resourcePolicy",
  "id": "5587673659722509355",
  "creationTimestamp": "2024-05-09T02:09:24.588-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "example-compact-policy",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED"
  },
  "status": "READY"
}

  • Jika Anda melihat detail kebijakan penempatan spread:

    {
  "kind": "compute#resourcePolicy",
  "id": "5970772604948130963",
  "creationTimestamp": "2024-05-09T02:08:13.404-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "example-spread-policy",
  "groupPlacementPolicy": {
    "availabilityDomainCount": 5
  },
  "status": "READY"
}

Apa langkah selanjutnya?