Melihat perujuk ke instance VM

Jika Anda ingin melihat hubungan antara instance VM dan resource Compute Engine lainnya, gunakan metode REST API listReferrers.

Saat Anda menggunakan REST, Compute Engine akan menampilkan daftar referensi yang menjelaskan:

  • Resource sumber: resource yang mengarah ke resource target
  • Resource target: resource yang dimaksud
  • Jenis referensi: hubungan antara dua resource

Misalnya, Anda dapat menggunakan REST untuk melihat daftar grup instance tempat instance VM berada dengan mudah.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

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

      Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init

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

Batasan

  • Anda hanya dapat mencantumkan hubungan antara instance VM dan grup instance (terkelola dan tidak terkelola).
  • Anda hanya dapat mencantumkan perujuk menggunakan REST.

Mencantumkan satu perujuk

Perujuk adalah resource yang merujuk ke resource lain. Untuk instance VM, perujuk umum adalah grup instance.

Misalnya, Anda memiliki instance VM bernama example-ig-a1 di zona us-central1-a. Instance VM adalah anggota grup instance yang disebut example-ig di zona yang sama, seperti yang ditunjukkan pada diagram di bawah:

Instance virtual machine adalah anggota grup instance di zona yang sama.

Untuk melihat hubungan ini, panggil metode listReferrers di example-ig-a1 dengan permintaan HTTP berikut:

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1/referrers

Server menampilkan respons daftar standar yang berisi item berikut:

"items": [
  {
    "target": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1,
    "referenceType": MEMBER_OF,
    "referrer": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig
  }
]

Dalam hal ini, target adalah example-ig-a1, yang merupakan MEMBER_OF referrer, grup example-ig instance.

Mencantumkan beberapa perujuk

Jika resource memiliki lebih dari satu perujuk, respons akan menampilkan daftar semua perujuk untuk resource target. Jika instance termasuk dalam dua grup instance, respons akan berisi kedua grup instance.

Jika instance virtual machine adalah anggota dari dua grup instance, respons akan berisi kedua grup instance.

Misalnya, respons berikut menunjukkan bahwa instance bernama example-instance-a2 termasuk dalam dua grup instance, example-ig dan example-ig-2:

"items": [
  {
    "target": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2,
    "referenceType": MEMBER_OF,
    "referrer": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig
  },
  {
    "target": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2,
    "referenceType": MEMBER_OF,
    "referrer": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2
  }
]

Mencantumkan perujuk lintas cakupan

Metode listReferrers juga menampilkan informasi tentang perujuk yang ada di dalam cakupan lain, seperti region atau zona lain. Misalnya, anggaplah Anda memiliki instance VM yang termasuk dalam grup instance terkelola regional (MIG regional):

Di region us-central1, instance new-instance-a3 di zona us-central1-a adalah anggota grup instance regional example-rmig.

Anda memanggil metode listReferrers yang menargetkan instance ini dengan permintaan HTTP berikut:

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3/referrers

Server menampilkan respons daftar standar yang berisi item berikut:

"items": [
  {
    "target": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3,
    "referenceType": MEMBER_OF,
    "referrer": https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rmig
  }
]

Respons menampilkan grup instance regional dalam daftar perujuk.

Mencantumkan perujuk ke semua resource dalam koleksi

Dengan menggunakan karakter pengganti (-), Anda dapat meminta daftar semua perujuk ke semua instance VM dalam zona tertentu. Permintaan dapat dibuat dengan permintaan HTTP yang mirip dengan berikut ini:

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/-/referrers

Server menampilkan respons yang berisi daftar instance VM di zona dan referensi ke instance. Contoh:

"items": [
  {
    "target": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1,
    "referenceType": MEMBER_OF,
    "referrer": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig
  },
  {
    "target": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2,
    "referenceType": MEMBER_OF,
    "referrer": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig
  },
  {
    "target": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2,
    "referenceType": MEMBER_OF,
    "referrer": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2
  },
  {
    "target": https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3,
    "referenceType": MEMBER_OF,
    "referrer": https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rmig
  }
]

Langkah berikutnya