Melihat perujuk ke instance Compute Engine

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

    1. 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:

Instance komputasi adalah anggota grup instance di zona yang sama.

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.

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

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):

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

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