Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Referrer zu VM-Instanzen ansehen

Verwenden Sie die gcloud CLI oder REST, um die Beziehungen zwischen VM-Instanzen und anderen Compute Engine-Ressourcen aufzurufen.

Wenn Sie Referrer zu VM-Instanzen auflisten, gibt Compute Engine eine Liste von Referenzen zurück, die Folgendes beschreiben:

Die Quellressource: die Ressource, die auf die Zielressource zeigt
Die Zielressource: die betreffende Ressource
Den Referenztyp: die Beziehung zwischen den beiden Ressourcen

Sie können beispielsweise Referrer auflisten, um eine Liste der Instanzgruppen aufzurufen, zu denen eine VM-Instanz gehört.

Hinweis

Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud Dienste und APIs überprüft. Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:
Wählen Sie den Tab für die gewünschte Verwendung der Beispiele auf dieser Seite aus:
gcloud
1. Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit dem folgenden Befehl:
  gcloud init
  Hinweis: Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie gcloud components update ausführen.
Legen Sie eine Standardregion und -zone fest.

REST

Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.

Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.

Beschränkungen

Sie können nur Beziehungen zwischen VM-Instanzen und Instanzgruppen auflisten. Es werden sowohl verwaltete als auch nicht verwaltete Instanzgruppen unterstützt.

Einzelne Referrer auflisten

Ein Referrer ist eine Ressource, die auf eine andere Ressource verweist. Ein gängiger Referrer für VM-Instanzen ist eine Instanzgruppe.

Angenommen, Sie haben eine VM-Instanz mit dem Namen example-ig-a1 in der Zone us-central1-a. Die VM-Instanz ist Mitglied einer Instanzgruppe namens example-ig in derselben Zone, wie im folgenden Diagramm dargestellt:

Eine VM-Instanz ist Mitglied einer Instanzgruppe in derselben Zone.

Verwenden Sie die gcloud CLI oder REST, um diese Beziehung aufzurufen:

gcloud

Führen Sie den Befehl gcloud compute instances list-referrers aus:

gcloud compute instances list-referrers INSTANCE_NAME \
    --zone=ZONE

Ersetzen Sie Folgendes:

INSTANCE_NAME: der Name der VM-Instanz, für die Sie Referrer auflisten möchten.
ZONE: die Zone, in der sich die VM-Instanz befindet.

Führen Sie beispielsweise den folgenden Befehl aus, um die Verweise für die Instanz example-ig-a1 in der Zone us-central1-a aufzulisten:

gcloud compute instances list-referrers example-ig-a1 \
    --zone=us-central1-a

Die Ausgabe sieht etwa so aus:

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

Stellen Sie eine GET-Anfrage an die Methode instances.listReferrers.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/referrers

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Projekts, in dem sich die VM-Instanz befindet.
ZONE: die Zone, in der sich die VM-Instanz befindet.
INSTANCE_NAME: der Name der VM-Instanz, für die Sie Referrer auflisten möchten.

Wenn Sie beispielsweise die Referrer für die Instanz example-ig-a1 in der Zone us-central1-a auflisten möchten, stellen Sie die folgende HTTP-Anfrage:

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

Der Server gibt eine Standardliste zurück, die folgende Elemente enthält:

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

In diesem Fall ist die Zielressource example-ig-a1, die ein MEMBER_OF der Verweisressource ist, nämlich der Instanzgruppe example-ig.

Mehrere Referrer auflisten

Wenn eine Ressource mehr als eine Verweis-URL hat, gibt die Antwort eine Liste aller Verweis-URLs für die Zielressource zurück. Wenn eine Instanz zu zwei Instanzgruppen gehört, enthält die Antwort beide Instanzgruppen.

Wenn eine VM-Instanz Mitglied von zwei Instanzgruppen ist, enthält die Antwort beide Instanzgruppen.

Angenommen, die Instanz mit dem Namen example-instance-a2 in der Zone us-central1-a gehört zu zwei Instanzgruppen, example-ig und example-ig-2:

gcloud

Führen Sie den Befehl gcloud compute instances list-referrers aus:

gcloud compute instances list-referrers INSTANCE_NAME \
    --zone=ZONE

Ersetzen Sie Folgendes:

INSTANCE_NAME: der Name der VM-Instanz, für die Sie Referrer auflisten möchten.
ZONE: die Zone, in der sich die VM-Instanz befindet.

Führen Sie beispielsweise den folgenden Befehl aus, um die Verweise für die Instanz example-instance-a2 in der Zone us-central1-a aufzulisten:

gcloud compute instances list-referrers example-instance-a2 \
    --zone=us-central1-a

Die Ausgabe sieht etwa so aus:

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

Stellen Sie eine GET-Anfrage an die Methode instances.listReferrers.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/referrers

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Projekts, in dem sich die VM-Instanz befindet.
ZONE: die Zone, in der sich die VM-Instanz befindet.
INSTANCE_NAME: der Name der VM-Instanz, für die Sie Referrer auflisten möchten.

Wenn Sie beispielsweise die Referrer für die Instanz example-instance-a2 in der Zone us-central1-a auflisten möchten, stellen Sie die folgende HTTP-Anfrage:

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

Der Server gibt eine Standardliste zurück, die folgende Elemente enthält:

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

Querverweis-Referrer auflisten

Sie können auch Informationen zu Referrern aufrufen, die in anderen Bereichen vorhanden sind, z. B. in anderen Regionen oder Zonen. Angenommen, Sie haben eine VM-Instanz, die zu einer regionalen verwalteten Instanzgruppe (regionale MIG) gehört:

Grafik: In der Region "us-central1" ist die Instanz "new-instance-a3" in der Zone "us-central1-a" Mitglied der regionalen Instanzgruppe "example-rmig".

Verwenden Sie die gcloud CLI oder REST, um Referrer aufzurufen, die auf diese Instanz verweisen:

gcloud

Führen Sie den Befehl gcloud compute instances list-referrers aus:

gcloud compute instances list-referrers INSTANCE_NAME \
    --zone=ZONE

Ersetzen Sie Folgendes:

INSTANCE_NAME: der Name der VM-Instanz, für die Sie Referrer auflisten möchten.
ZONE: die Zone, in der sich die VM-Instanz befindet.

Führen Sie beispielsweise den folgenden Befehl aus, um die Verweise für die Instanz new-instance-a3 in der Zone us-central1-a aufzulisten:

gcloud compute instances list-referrers new-instance-a3 \
    --zone=us-central1-a

Die Ausgabe sieht etwa so aus:

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

Stellen Sie eine GET-Anfrage an die Methode instances.listReferrers.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/referrers

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Projekts, in dem sich die VM-Instanz befindet.
ZONE: die Zone, in der sich die VM-Instanz befindet.
INSTANCE_NAME: der Name der VM-Instanz, für die Sie Referrer auflisten möchten.

Wenn Sie beispielsweise die Referrer für die Instanz new-instance-a3 in der Zone us-central1-a auflisten möchten, stellen Sie die folgende HTTP-Anfrage:

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

Der Server gibt eine Standardliste zurück, die folgende Elemente enthält:

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

Die Antwort zeigt die regionale Instanzgruppe in der Referrer-Liste.

Referrer auf alle Ressourcen in einer Sammlung auflisten

Mit dem Platzhalterzeichen (-) können Sie eine Liste aller Verweise auf alle VM-Instanzen in einer bestimmten Zone anfordern:

gcloud

Führen Sie den Befehl gcloud compute instances list-referrers mit dem Platzhalterzeichen - aus:

gcloud compute instances list-referrers - \
    --zone=ZONE

Ersetzen Sie ZONE durch die Zone, in der Sie Referrer für alle VM-Instanzen auflisten möchten.

Führen Sie beispielsweise den folgenden Befehl aus, um Referrer für alle VM-Instanzen in der Zone us-central1-a aufzulisten:

gcloud compute instances list-referrers - \
    --zone=us-central1-a

Die Ausgabe sieht etwa so aus:

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

Stellen Sie eine GET-Anfrage an die Methode instances.listReferrers mit dem Platzhalterzeichen -:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/-/referrers

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Projekts, in dem Sie Referrer auflisten möchten.
ZONE: die Zone, in der Sie Referrer für alle VM-Instanzen auflisten möchten.

Wenn Sie beispielsweise Referrer für alle VM-Instanzen in der Zone us-central1-a auflisten möchten, stellen Sie die folgende HTTP-Anfrage:

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

Der Server gibt eine Antwort mit einer Liste der VM-Instanzen in der Zone und Verweisen auf die einzelnen Instanzen zurück. Beispiel:

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

Nächste Schritte

Mehr über Instanzgruppen erfahren
Liste der geltenden Zonen und Regionen

Referrer zu VM-Instanzen ansehen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweis

gcloud

REST

Beschränkungen

Einzelne Referrer auflisten

gcloud

REST

Mehrere Referrer auflisten

gcloud

REST

Querverweis-Referrer auflisten

gcloud

REST

Referrer auf alle Ressourcen in einer Sammlung auflisten

gcloud

REST

Nächste Schritte

Referrer zu VM-Instanzen ansehen