Melihat perujuk ke instance VM

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

Saat Anda menggunakan REST, Compute Engine 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 dengan mudah melihat daftar grup instance yang memiliki instance VM.

Sebelum memulai

  • 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.

    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 (baik yang terkelola maupun tidak terkelola).
  • Anda hanya dapat membuat daftar perujuk dengan menggunakan REST.

Mencantumkan satu perujuk

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

Misalnya, anggap 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 tersebut. Jika sebuah instance berada dalam dua grup instance, respons akan berisi kedua grup instance tersebut.

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.

Panggil 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 tersebut 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 selanjutnya