VM インスタンスのリファラーの表示

このページでは、List Referrers API を使用してリソース間の関係を表示する方法について説明します。具体的には、VM インスタンスと他の Compute Engine リソースとの関係を表示できます。

この API を使用すると、Compute Engine は次の事項を説明する参照リストを返します。

  • ソースリソース - ターゲット リソースをポイントするリソース。
  • ターゲット リソース - 目的のリソース。
  • 参照タイプ - 2 つのリソース間の関係。

たとえば、この API を使用して VM インスタンスが属するマネージド インスタンス グループのリストを簡単に表示できます。

始める前に

制限事項

  • 一覧表示できるのは、VM インスタンスとインスタンス グループ(マネージドと非マネージドの両方)の関係のみです。
  • gcloud ツールまたは Google Cloud Platform Console を使用してリファラーを一覧表示することはできません。

単一のリファラーの一覧表示

リファラーは、他のリソースを参照するリソースです。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 で、referrer(example-ig インスタンス グループ)の MEMBER_OF になります。

複数のリファラーを一覧表示する

リソースに複数のリファラーがある場合、レスポンスでターゲット リソースのすべてのリファラーのリストが返されます。インスタンスが 2 つのインスタンス グループに属している場合、レスポンスには両方のインスタンス グループが含まれます。

たとえば、次のレスポンスは、example-instance-a2 というインスタンスが example-ig と example-ig-2 の 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 ドキュメント