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.
Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
gcloud init
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:
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.
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):
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
- Pelajari grup instance lebih lanjut.
- Lihat daftar zona dan region yang berlaku.