Untuk melihat hubungan antara instance Compute Engine dan resource Compute Engine lainnya, gunakan gcloud CLI atau REST.
Saat Anda mencantumkan perujuk ke instance komputasi, 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 mencantumkan perujuk untuk melihat daftar grup instance tempat instance komputasi berada.
Sebelum memulai
-
Siapkan autentikasi jika Anda belum melakukannya.
Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud 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
-
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
-
- 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, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .
Batasan
- Anda hanya dapat mencantumkan hubungan antara instance komputasi dan grup instance. Grup instance terkelola dan tidak terkelola didukung.
Mencantumkan satu perujuk
Perujuk adalah resource yang merujuk ke resource lain. Untuk instance komputasi, perujuk yang umum adalah grup instance.
Misalnya, asumsikan bahwa Anda memiliki instance komputasi bernama example-ig-a1 di
zona us-central1-a. Instance komputasi adalah anggota grup instance bernama example-ig di zona yang sama, seperti yang ditunjukkan dalam diagram berikut:
Untuk melihat hubungan ini, gunakan gcloud CLI atau REST:
gcloud
Guakan perintah
gcloud compute instances list-referrers:
gcloud compute instances list-referrers INSTANCE_NAME \
--zone=ZONE
Ganti kode berikut:
INSTANCE_NAME: nama instance komputasi yang ingin Anda cantumkan perujuknya.ZONE: zona tempat instance komputasi berada.
Misalnya, untuk mencantumkan perujuk untuk instance example-ig-a1 di zona us-central1-a, jalankan perintah berikut:
gcloud compute instances list-referrers example-ig-a1 \
--zone=us-central1-a
Outputnya mirip dengan hal berikut ini:
REFERRER REFERENCE_TYPE TARGET
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig MEMBER_OF https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1
REST
Buat permintaan GET ke metode
instances.listReferrers:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/referrers
Ganti kode berikut:
PROJECT_ID: ID project tempat instance komputasi berada.ZONE: zona tempat instance komputasi berada.INSTANCE_NAME: nama instance komputasi yang ingin Anda cantumkan perujuknya.
Misalnya, untuk mencantumkan perujuk untuk instance example-ig-a1 di zona us-central1-a, buat 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, resource target adalah example-ig-a1, yang merupakan MEMBER_OF
resource perujuk, grup instance example-ig.
Membuat daftar beberapa perujuk
Jika resource memiliki lebih dari satu perujuk, respons akan menampilkan daftar semua perujuk untuk resource target. Jika sebuah instance termasuk dalam dua grup instance, respons akan berisi kedua grup instance tersebut.
Misalnya, asumsikan bahwa instance bernama example-instance-a2 di zona us-central1-a termasuk dalam dua grup instance, example-ig dan example-ig-2:
gcloud
Guakan perintah
gcloud compute instances list-referrers:
gcloud compute instances list-referrers INSTANCE_NAME \
--zone=ZONE
Ganti kode berikut:
INSTANCE_NAME: nama instance komputasi yang ingin Anda cantumkan perujuknya.ZONE: zona tempat instance komputasi berada.
Misalnya, untuk mencantumkan perujuk untuk instance example-instance-a2 di zona us-central1-a, jalankan perintah berikut:
gcloud compute instances list-referrers example-instance-a2 \
--zone=us-central1-a
Outputnya mirip dengan hal berikut ini:
REFERRER REFERENCE_TYPE TARGET
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig MEMBER_OF https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2 MEMBER_OF https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2
REST
Buat permintaan GET ke metode
instances.listReferrers:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/referrers
Ganti kode berikut:
PROJECT_ID: ID project tempat instance komputasi berada.ZONE: zona tempat instance komputasi berada.INSTANCE_NAME: nama instance komputasi yang ingin Anda cantumkan perujuknya.
Misalnya, untuk mencantumkan perujuk untuk instance example-instance-a2 di zona us-central1-a, buat permintaan HTTP berikut:
GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2/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-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
Anda juga dapat melihat informasi tentang perujuk yang ada di dalam cakupan lain, seperti region atau zona lain. Misalnya, asumsikan bahwa Anda memiliki instance komputasi yang termasuk dalam grup instance terkelola regional (MIG regional):
Untuk melihat perujuk yang menargetkan instance ini, gunakan gcloud CLI atau REST:
gcloud
Guakan perintah
gcloud compute instances list-referrers:
gcloud compute instances list-referrers INSTANCE_NAME \
--zone=ZONE
Ganti kode berikut:
INSTANCE_NAME: nama instance komputasi yang ingin Anda cantumkan perujuknya.ZONE: zona tempat instance komputasi berada.
Misalnya, untuk mencantumkan perujuk untuk instance new-instance-a3 di zona us-central1-a, jalankan perintah berikut:
gcloud compute instances list-referrers new-instance-a3 \
--zone=us-central1-a
Outputnya mirip dengan hal berikut ini:
REFERRER REFERENCE_TYPE TARGET
https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rmig MEMBER_OF https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3
REST
Buat permintaan GET ke metode
instances.listReferrers:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/referrers
Ganti kode berikut:
PROJECT_ID: ID project tempat instance komputasi berada.ZONE: zona tempat instance komputasi berada.INSTANCE_NAME: nama instance komputasi yang ingin Anda cantumkan perujuknya.
Misalnya, untuk mencantumkan perujuk untuk instance new-instance-a3 di zona us-central1-a, buat 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 komputasi dalam zona tertentu:
gcloud
Gunakan perintah
gcloud compute instances list-referrers
dengan karakter pengganti -:
gcloud compute instances list-referrers - \
--zone=ZONE
Ganti ZONE dengan zona tempat Anda ingin mencantumkan perujuk untuk semua instance komputasi.
Misalnya, untuk mencantumkan perujuk untuk semua instance komputasi di zona us-central1-a, jalankan perintah berikut:
gcloud compute instances list-referrers - \
--zone=us-central1-a
Outputnya mirip dengan hal berikut ini:
REFERRER REFERENCE_TYPE TARGET
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig MEMBER_OF https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig MEMBER_OF https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2 MEMBER_OF https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2
https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rmig MEMBER_OF https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3
REST
Buat permintaan GET ke metode
instances.listReferrers
dengan karakter pengganti -:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/-/referrers
Ganti kode berikut:
PROJECT_ID: ID project tempat Anda ingin mencantumkan perujuk.ZONE: zona tempat Anda ingin mencantumkan perujuk untuk semua instance komputasi.
Misalnya, untuk mencantumkan perujuk untuk semua instance komputasi di zona us-central1-a, buat permintaan HTTP berikut:
GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/-/referrers
Server menampilkan respons yang berisi daftar instance komputasi di zona dan referensi ke setiap 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
- Pelajari grup instance lebih lanjut.
- Lihat daftar zona dan region yang berlaku.