檢視 VM 執行個體的參照網址

本頁說明如何使用 List Referrers API 來檢視不同資源之間的關係;具體而言,您可以檢視 VM 執行個體與其他 Compute Engine 資源之間的關係。

當您使用這個 API 時,Compute Engine 會傳回一份參考資料清單,當中會說明:

  • 來源資源:指向目標資源的資源。
  • 目標資源:相關資源。
  • 參照類型:兩個資源之間的關係。

舉例來說,這個 API 可讓您輕鬆檢視某個 VM 執行個體所屬的代管執行個體群組清單。

事前準備

限制

  • 您只能列出 VM 執行個體與執行個體群組 (包含代管和未代管) 之間的關係。
  • 您無法列出使用 gcloud 工具或 Google Cloud Platform 主控台的參照網址清單。

列出單一參照網址

參照網址是指參照其他資源的資源。對 VM 執行個體來說,共用參照網址就是執行個體群組。

舉例來說,假設您在 us-central1-a 區域有個名為 example-ig-a1 的 VM 執行個體。該 VM 執行個體是同一區域中「example-ig」執行個體群組的成員,如下圖所示:

如要查看它們之間的關係,請透過以下 HTTP 要求對 example-ig-a1 呼叫 listReferrers 方法

GET https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1/referrers

伺服器會傳回標準清單回應,其中包含以下項目:

"items": [
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig
  }
]

在這個範例中,target 就是 example-ig-a1,也就是 example-ig 執行個體群組 (即參照網址 referrer) 的成員 (MEMBER_OF)。

列出多個參照網址

如果某個資源的參照網址不只一個,回應會傳回目標資源的所有參照網址清單。如果某個執行個體屬於兩個執行個體群組,回應就會包含這兩個執行個體群組。

舉例來說,下列回應指出名為 example-instance-a2 的執行個體屬於「example-ig」和「example-ig-2」這兩個執行個體群組:

"items": [
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig
  },
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2
  }
]

列出跨範圍的參照網址

listReferrers 方法也會傳回位於其他範圍的參照網址相關資訊,例如其他地區或區域。舉例來說,假設您設有一個 VM 執行個體,隸屬於地區代管的執行個體群組:

您透過以下 HTTP 要求針對這個執行個體呼叫 listReferrers 方法:

GET https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3/referrers

伺服器會傳回標準清單回應,其中包含以下項目:

"items": [
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rig
  }
]

回應會在參照網址清單中顯示地區代管執行個體群組。

列出集合中所有資源的參照網址

只要使用萬用字元 (-),您就能要求特定區域內所有 VM 執行個體的所有參照網址清單。您可以透過 HTTP 要求發出這項要求,格式如下:

GET https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/-/referrers

伺服器會傳回回應,其中包含區域中的 VM 執行個體清單,以及執行個體的參考資料。範例如下:

"items": [
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig
  },
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig
  },
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2
  },
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rig
  }
]

後續步驟

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Compute Engine 說明文件