Melihat perujuk ke instance VM

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

Saat Anda menggunakan metode API ini, Compute Engine akan menampilkan daftar referensi yang menjelaskan:

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

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

Sebelum memulai

Batasan

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

Mencantumkan satu perujuk

Perujuk adalah resource yang mengacu pada resource lain. Untuk instance VM, perujuk yang 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 ini:

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 akan 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 yang 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 tersebut. 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