查看 VM 執行個體的參照網址

如要查看 VM 執行個體和其他 Compute Engine 資源之間的關係，請使用 listReferrers REST API 方法。

使用 REST 時，Compute Engine 會傳回參照清單，說明：

• 來源資源：指向目標資源的資源
• 目標資源：有問題的資源
• 參照類型：兩個資源之間的關係

舉例來說，您可以使用 REST 輕鬆查看 VM 執行個體所屬的執行個體群組清單。

事前準備

• 如果尚未設定驗證，請先完成設定。 驗證程序會確認您的身分，以便授予 Google Cloud 服務和 API 的存取權。如要從本機開發環境執行程式碼或範例，請選取下列其中一個選項，向 Compute Engine 進行驗證：

  如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

  安裝 Google Cloud CLI。

  如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

  詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」一節。

限制

• 您只能列出 VM 執行個體與執行個體群組 (包含代管和未代管) 之間的關係。
• 您只能使用 REST 列出參照網址。

列出單一參照網址

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

舉例來說，假設您在 us-central1-a 可用區中有一個名為 example-ig-a1 的 VM 執行個體。如下圖所示，VM 執行個體是同一個可用區中名為 example-ig 的執行個體群組成員：

如要查看這項關係，請使用下列 HTTP 要求，在 example-ig-a1 上呼叫 listReferrers 方法：

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

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

"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 是 example-ig-a1，也就是 MEMBER_OF referrer example-ig instance 群組。

列出多個參照網址

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

舉例來說，下列回應表示名為 example-instance-a2 的執行個體屬於兩個執行個體群組：example-ig 和 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
  }
]

列出跨範圍的參照網址

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

您呼叫的 listReferrers 方法會使用下列 HTTP 要求將這個執行個體指定做為目標：

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

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

"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
  }
]

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

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

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

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

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

"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
  }
]

後續步驟

• 進一步瞭解執行個體群組。
• 查看適用的區域和地區清單。