Verwenden Sie die Methoden auf dieser Seite, um Informationen zu Ihren verwalteten Instanzgruppen (MIGs) sowie Informationen zu den VM-Instanzen in den einzelnen MIGs aufzurufen.
Hinweise
- Prüfen Sie die Einschränkungen und erstellen Sie eine Gruppe.
-
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.
Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:
Select the tab for how you plan to use the samples on this page:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
REST
Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.
-
Informationen zu MIGs aufrufen
Sie können Informationen zu Gruppen abrufen, um beispielsweise die mit der Gruppe verknüpften Richtlinien zu überprüfen und zu prüfen, ob die Gruppe stabil ist oder ob gerade Änderungen an ihr durchgeführt werden. Weitere Informationen zu den VM-Instanzen in einer MIG finden Sie unter Informationen zu den verwalteten VM-Instanzen in einer MIG anzeigen.
MIGs auflisten
Eine Liste der verwalteten Instanzgruppen können Sie entweder mit der Console, der gcloud CLI oder REST abrufen.
Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
Wenn Sie über Instanzgruppen verfügen, werden die Gruppen auf dieser Seite aufgelistet, einschließlich der verwalteten Instanzgruppen und der nicht verwalteten Instanzgruppen.
In der Spalte Gruppentyp wird angegeben, ob die Gruppe verwaltet, zustandsorientiert oder nicht verwaltet ist. Die zustandsorientierten Gruppentypen sind auch verwaltete Instanzgruppen.
So rufen Sie eine Liste aller verwalteten Instanzgruppen in einem Projekt ab:
gcloud compute instance-groups managed list
Rufen Sie für zonale MIGs die Methode instanceGroupManagers.list
auf:
GET https://compute.googleapis.com/compute/v1/projects/project-id /zones/zone /instanceGroupManagers
Rufen Sie für regionale MIGs die Methode regionInstanceGroupManagers.list
auf:
GET https://compute.googleapis.com/compute/v1/projects/project-id /regions/region /instanceGroupManagers
Attribute einer MIG aufrufen
Zum Aufrufen von Informationen zu einer bestimmten MIG, einschließlich der Richtlinien (z. B. Richtlinien für die automatische Reparatur und Aktualisierung der Gruppe), verwenden Sie die Konsole, die gcloud CLI oder REST.
Zum Ansehen des id
-Werts der Gruppe müssen Sie die gcloud CLI oder die Compute Engine API verwenden.
Erforderliche Berechtigungen für diese Aufgabe
Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen:
compute.instanceGroupManagers.get
für die Instanzgruppe
Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
Wenn Sie bereits Instanzgruppen haben, werden sie auf dieser Seite aufgelistet. Hier werden auch nicht verwaltete Instanzgruppen aufgelistet.
Klicken Sie in der Spalte Name der Liste auf den Namen der Instanzgruppe, die Sie sich genauer ansehen möchten. Es wird eine Seite mit den Attributen der Instanzgruppe und eine Liste der zur Gruppe gehörenden Instanzen angezeigt.
Klicken Sie auf Details, um die Konfiguration der Gruppe aufzurufen.
So erhalten Sie Informationen zu einer bestimmten Gruppe:
gcloud compute instance-groups managed describeinstance-group \ [--zonezone | --regionregion ]
Der Befehl gibt Details zur Gruppe zurück, einschließlich der verknüpften Richtlinien.
Mit dem Flag --format
können Sie die Ausgabe beschränken. Der folgende Befehl gibt beispielsweise nur die Autoscaling-Konfiguration der Gruppe zurück, falls vorhanden.
gcloud compute instance-groups managed describeinstance-group --format="(autoscaler)"
Rufen Sie für zonale MIGs die Methode instanceGroupManagers.get
auf:
Rufen Sie für regionale MIGs die Methode regionInstanceGroupManagers.get
auf:
GET https://compute.googleapis.com/compute/v1/projects/project-id /regions/region /instanceGroupManagers/instance-group
Die Antwort enthält Details zur Gruppe, einschließlich der zugeordneten Richtlinien, mit Ausnahme der Autoscaling-Richtlinie der Gruppe. Obwohl Autoscaling ein Feature von MIGs ist, ist es eine separate REST-Ressource.
Autoscaling-Richtlinie
Wenn der Gruppe Autoscaling zugeordnet ist, wird die Autoscaling-Ressource im Feld status.autoscaler
der Gruppe aufgeführt.
Informationen zum Autoscaling erhalten Sie, wenn Sie die Methode autoscalers.get
für eine zonale MIG oder die Methode regionAutoscalers.get
für eine regionale MIG aufrufen. Die URL der Autoscaling-Ressource enthält deren Namen. Dies ist standardmäßig der Name der Gruppe, der das Autoscaling zugeordnet ist. Sie können beispielsweise die folgende Anfrage für das Autoscaling einer regionalen MIG stellen:
GET https://compute.googleapis.com/compute/v1/projects/project-id /regions/region /regionAutoscalers/mig_name
Stabilität einer MIG prüfen
Sie können mit verschiedenen Befehlen und Anfragen Instanzen in einer verwalteten Instanzgruppe erstellen, löschen und ändern. Diese Vorgänge werden mit dem Status DONE
zurückgegeben, nachdem die Gruppe Aktionen zum Erstellen, Löschen oder Aktualisieren dieser Instanzen geplant hat. Die Instanzen in der Gruppe sind jedoch erst dann erstellt, gelöscht oder aktualisiert, wenn diese zugrunde liegenden Aktionen abgeschlossen sind. Sie müssen den Status der Gruppe überprüfen oder alternativ den Status der entsprechenden Instanzen überprüfen.
Eine verwaltete Instanzgruppe ist stabil, wenn an keinen Instanzen in der verwalteten Instanzgruppe Änderungen vorgenommen werden, keine zukünftigen Änderungen für die Instanzen geplant sind und die Gruppe selbst nicht gerade geändert wird.
Sie möchten z. B. wissen, ob eine Gruppe stabil ist, wenn Sie Abhängigkeiten haben, die voraussetzen, dass alle Instanzen in der Gruppe fehlerfrei ausgeführt werden. Sie können beispielsweise beginnen, Jobs zu planen, Traffic zu senden oder Schlüsselbereiche zuzuweisen, nachdem Sie sich vergewissert haben, dass alle VMs ausgeführt werden und fehlerfrei sind.
Prüfen Sie, ob alle Instanzen in einer verwalteten Instanzgruppe ausgeführt werden und fehlerfrei sind, indem Sie den Wert des Feldes status.isStable
der Gruppe prüfen.
Führen Sie den Befehl describe
aus:
gcloud compute instance-groups managed describeinstance-group-name \ [--zonezone | --regionregion ]
Die gcloud CLI gibt detaillierte Informationen zur MIG zurück, einschließlich des Felds status.isStable
.
Wenn ein Skript pausiert werden soll, bis die MIG stabil ist, verwenden Sie den Befehl wait-until
mit dem Flag --stable
. Beispiel:
gcloud compute instance-groups managed wait-untilinstance-group-name \ --stable \ [--zonezone | --regionregion ] Waiting for group to become stable, current operations: deleting: 4 Waiting for group to become stable, current operations: deleting: 4 ... Group is stable
Der Befehl gibt das Ergebnis zurück, nachdem status.isStable
für die MIG auf true
gesetzt wurde.
Stellen Sie für eine zonale MIG eine GET
-Anfrage an die Methode instanceGroupManagers.get
:
GET https://compute.googleapis.com/compute/v1/projects/project-id /zones/zone /instanceGroupManagers/instance-group-name /get
Ersetzen Sie für regional verwaltete Instanzgruppen zones/zone
durch regions/region
:
GET https://compute.googleapis.com/compute/v1/projects/project-id /regions/region /instanceGroupManagers/instance-group-name /get
Diese Anfragen geben detaillierte Informationen zur MIG zurück, einschließlich des Felds status.isStable
.
Wenn status.isStable
auf false
gesetzt ist, bedeutet das, dass Änderungen aktiv sind, ausstehen oder dass die MIG selbst geändert wird.
Wenn status.isStable
auf true
gesetzt ist, bedeutet das Folgendes:
- Die Instanzen in der MIG werden nicht geändert und die
currentAction
für alle Instanzen istNONE
. - Es gibt keine Änderungen bei Instanzen in der MIG.
- Die MIG selbst wird nicht geändert.
Beachten Sie, dass die Stabilität einer MIG von zahlreichen Faktoren abhängt, da eine MIG auf verschiedene Arten geändert werden kann. Beispiele:
- Sie stellen eine Anfrage, um eine neue Instanzvorlage bereitzustellen.
- Sie stellen eine Anfrage, um in der Gruppe Instanzen zu erstellen, zu löschen, deren Größe anzupassen oder sie zu aktualisieren.
- Durch das Autoscaling wird eine Anfrage gestellt, um die Größe der MIG zu ändern.
- Eine Ressource für die automatische Reparatur ersetzt in der MIG eine oder mehrere fehlerhafte Instanzen.
- In einer regionalen MIG werden einige der Instanzen neu verteilt.
Sobald alle Aktionen abgeschlossen sind, wird status.isStable
wieder auftrue
gesetzt für diese MIG.
Informationen zu einzelnen VM-Instanzen finden Sie unter Status von verwalteten Instanzen überprüfen.
MIG auf Deaktivierung von VM-Reparaturen prüfen
Um zu prüfen, ob die VM-Reparaturen in einer MIG deaktiviert sind, verwenden Sie die Console, die gcloud CLI oder die API.
Erforderliche Berechtigungen für diese Aufgabe
Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen:
compute.instanceGroupManagers.get
für die Instanzgruppecompute.instanceGroupManagers.list
für die Instanzgruppe
- Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
- Klicken Sie auf den Namen der Instanzgruppe, die Sie aufrufen möchten. Ihnen wird eine Seite mit den Attributen der Instanzgruppe und einer Liste der zur Gruppe gehörenden Instanzen angezeigt.
- Klicken Sie auf den Tab Details.
- Aktivieren Sie im Abschnitt Lebenszyklus von VM-Instanzen das Feld Standardaktion bei Fehler. Wenn der Wert
No action
ist, sind die Reparaturen in der MIG deaktiviert.
Verwenden Sie die describe
-Methode so:
gcloud compute instance-groups managed describeinstance-group \ --format="(instanceLifecyclePolicy)"
Suchen Sie im Antworttext nach dem Feld defaultActionOnFailure
. Folgende Werte sind möglich:
REPAIR
: Die MIG erstellt eine fehlgeschlagene oder fehlerhafte VM in derselben Zone neu.DO_NOTHING
: Die Reparaturen sind in der MIG deaktiviert. Die MIG führt für eine fehlgeschlagene oder eine fehlerhafte VM in der Gruppe keine Aktionen aus.
Das folgende Beispiel zeigt, wie die MIG eine VM durch Neuerstellung repariert.
instanceLifecyclePolicy: defaultActionOnFailure: REPAIR forceUpdateOnRepair: NO
Verwenden Sie für eine zonale MIG die Methode instanceGroupManagers.get
oder für eine regionale MIG die Methode regionInstanceGroupManagers.get
.
Mit dem folgenden Aufruf können Sie die MIG-Aktion bei VM-Fehlern in einer zonalen MIG anzeigen lassen:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /zones/ZONE /instanceGroupManagers/INSTANCE_GROUP
Prüfen Sie im Antworttext das Feld instanceLifecyclePolicy.defaultActionOnFailure
. Folgende Werte sind möglich:
REPAIR
: Die MIG erstellt eine fehlgeschlagene oder fehlerhafte VM in derselben Zone neu.DO_NOTHING
: Die Reparaturen sind in der MIG deaktiviert. Die MIG führt für eine fehlgeschlagene oder eine fehlerhafte VM in der Gruppe keine Aktionen aus.
Das folgende Beispiel zeigt, wie die MIG eine VM durch Neuerstellung repariert.
"instanceLifecyclePolicy": { "forceUpdateOnRepair": "NO", "defaultActionOnFailure": "REPAIR" }
Wenn Sie nicht möchten, dass eine MIG eine fehlgeschlagene oder fehlerhafte VM in der Gruppe repariert, können Sie die Reparaturen in der MIG deaktivieren.
Frühere automatische Reparaturvorgänge ansehen
Wenn Sie die automatische Reparatur konfiguriert haben, können Sie vergangene automatische Reparaturereignisse anzeigen.
Rolling Updates beobachten
Wenn Sie ein Rolling Update initiiert haben und wissen möchten, wann das Update abgeschlossen ist, informieren Sie sich unter Updates überwachen.
Zustandsorientierte Konfiguration aufrufen
Wenn Sie eine zustandsorientierte MIG konfiguriert haben und die Konfiguration prüfen möchten, finden Sie unter Zustandsorientierte Konfiguration aufrufen weitere Informationen.
Informationen zu den verwalteten VM-Instanzen in einer MIG aufrufen
Verwaltete Instanzen einer MIG auflisten
Eine Liste der verwalteten Instanzen in einer Gruppe einschließlich ihrer Status und Vorlagen können Sie entweder mit der Console, der gcloud CLI oder REST abrufen.
Erforderliche Berechtigungen für diese Aufgabe
Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen:
compute.instanceGroupManagers.get
für die Instanzgruppecompute.instanceGroupManagers.list
für die Instanzgruppe
Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
Wenn Sie bereits Instanzgruppen haben, werden sie auf dieser Seite aufgelistet. Hier werden auch nicht verwaltete Instanzgruppen aufgelistet.
Klicken Sie in der Spalte Name der Liste auf den Namen der Instanzgruppe, die Sie sich genauer ansehen möchten. Ihnen wird eine Seite mit den Attributen der Instanzgruppe und einer Liste der zur Gruppe gehörenden Instanzen angezeigt.
Verwenden Sie in der gcloud CLI den Unterbefehl list-instances
.
gcloud compute instance-groups managed list-instancesinstance-group \ [--zonezone | --regionregion ]
Dieser Befehl gibt eine Liste der Instanzen und ihrer Details sowie den aktuellen Status, die Instanzvorlage und den letzten Fehler zurück.
Stellen Sie für eine zonale MIG eine GET
-Anfrage an die Methode instanceGroupManagers.listManagedInstances
und geben Sie den Namen einer verwalteten Instanzgruppe an:
GET https://compute.googleapis.com/compute/v1/projects/project-id /zones/zone /instanceGroupManagers/instance-group
Verwenden Sie für regional verwaltete Instanzgruppen mit einer oder mehreren Zonen stattdessen die Ressource regionInstanceGroupManagers
: regionInstanceGroupManagers.list.
GET https://compute.googleapis.com/compute/v1/projects/project-id /regions/region /instanceGroupManagers/instance-group
Die Antwort enthält eine Liste der Instanzen und ihrer Details, einschließlich des aktuellen Status und der Instanzvorlage.
Status von verwalteten Instanzen prüfen
Sie können mit verschiedenen Befehlen und Anfragen Instanzen in einer verwalteten Instanzgruppe erstellen, löschen und ändern. Diese Vorgänge werden mit dem Status DONE
zurückgegeben, nachdem die Gruppe Aktionen zum Erstellen, Löschen oder Aktualisieren dieser Instanzen geplant hat. Die Instanzen in der Gruppe sind jedoch erst dann erstellt, gelöscht oder aktualisiert, wenn diese zugrunde liegenden Aktionen abgeschlossen sind. Prüfen Sie den Status der betreffenden Instanzen oder alternativ den Status der Gruppe selbst.
Verwenden Sie die Google Cloud CLI oder REST, um Details zu den Instanzen in einer verwalteten Instanzgruppe aufzurufen. Die Details enthalten den Instanzstatus und die aktuellen Aktionen, die die Gruppe auf ihren Instanzen ausführt.
Erforderliche Berechtigungen für diese Aufgabe
Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen:
compute.instanceGroupManagers.get
für die Gruppecompute.instanceGroupManagers.list
für die Gruppe
Alle verwalteten Instanzen
Prüfen Sie den Status und die aktuellen Aktionen für alle Instanzen in der Gruppe mit dem Befehl list-instances
.
gcloud compute instance-groups managed list-instancesINSTANCE_GROUP_NAME \ [--zone=ZONE | --region=REGION ]
Der Befehl gibt eine Liste der Instanzen in der Gruppe zurück, einschließlich ihres Status, aktueller Aktionen und weiterer Details:
NAME ZONE STATUS HEALTH_STATE ACTION INSTANCE_TEMPLATE VERSION_NAME LAST_ERROR vm-instances-9pk4 us-central1-f CREATING my-new-template vm-instances-h2r1 us-central1-f STOPPING DELETING my-old-template vm-instances-j1h8 us-central1-f RUNNING NONE my-old-template vm-instances-ngod us-central1-f RUNNING NONE my-old-template
Die Spalte HEALTH_STATE
ist leer, sofern Sie keine Systemdiagnose eingerichtet haben.
Eine bestimmte verwaltete Instanz
Zum Prüfen des Status und der aktuellen Aktion für eine bestimmte Instanz in der Gruppe verwenden Sie den Befehl describe-instance
.
gcloud compute instance-groups managed describe-instanceINSTANCE_GROUP_NAME \ --instanceINSTANCE_NAME \ [--zone=ZONE | --region=REGION ]
Der Befehl liefert Details zur Instanz, einschließlich des Instanzstatus, der aktuellen Aktion und (für zustandsorientierte MIGs) des beibehaltenen Status:
currentAction: NONE id: '6789072894767812345' instance: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-mig-hz41 instanceStatus: RUNNING name: example-mig-hz41 preservedStateFromConfig: metadata: example-key: example-value preservedStateFromPolicy: disks: persistent-disk-0: autoDelete: NEVER mode: READ_WRITE source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-mig-hz41 version: instanceTemplate: https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template
Rufen Sie die Methode listManagedInstances
für eine regionale oder zonale MIG-Ressource auf. Wenn Sie beispielsweise Details zu den Instanzen in einer zonalen MIG-Ressource abrufen möchten, können Sie die folgende Anfrage stellen:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /zones/ZONE /instanceGroupManagers/INSTANCE_GROUP_NAME /listManagedInstances
Der Aufruf gibt eine Liste der Instanzen für die MIG zurück, einschließlich instanceStatus
und currentAction
jeder Instanz.
{ "managedInstances": [ { "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-prvp", "id": "5317605642920955957", "instanceStatus": "RUNNING", "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template", "currentAction": "REFRESHING" }, { "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-pz5j", "currentAction": "DELETING" }, { "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-w2t5", "id": "2800161036826218547", "instanceStatus": "RUNNING", "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template", "currentAction": "REFRESHING" } ] }
Eine Liste der gültigen instanceStatus
-Feldwerte finden Sie unter Lebenszyklus von VM-Instanzen.
Wenn an einer Instanz eine Änderung vorgenommen wird, setzt das verwaltete Feld der Instanz das Feld currentAction
auf eine der folgenden Aktionen, damit Sie den Fortschritt der Änderung verfolgen können. Andernfalls wird das Feld currentAction
auf NONE
gesetzt.
Folgende currentAction
-Werte sind möglich:
ABANDONING
. Die Instanz wird gerade aus der MIG entfernt.CREATING
: Die Instanz wird gerade erstellt.CREATING_WITHOUT_RETRIES
. Die Instanz wird ohne Neuversuche erstellt. Wenn die Instanz beim ersten Versuch nicht erstellt wird, versucht die MIG nicht, die Instanz noch einmal zu ersetzen.DELETING
: Die Instanz wird gerade gelöscht.RECREATING
. Die Instanz wird gerade ersetzt.REFRESHING
: Die Instanz wird aus den aktuellen Zielpools entfernt und anschließend zu den in der Liste enthaltenen Zielpools wieder hinzugefügt. Diese Liste kann mit den bestehenden Zielpools identisch sein oder davon abweichen.RESTARTING
: Die Instanz wird gerade mit den Methodenstop
undstart
neu gestartet.RESUMING
. Die Instanz wird gerade fortgesetzt, nach dem sie vorher gesperrt war.STARTING
. Die Instanz wird gerade gestartet, nachdem sie vorher beendet wurde.STOPPING
: Die Instanz wird beendet.SUSPENDING
: Die Instanz wird angehalten.VERIFYING
: Die Instanz wurde erstellt und wird gerade verifiziert.NONE
: Für die Instanz werden gerade keine Aktionen durchgeführt.
Informationen zum Überprüfen, ob die Gruppe insgesamt stabil ist oder gerade geändert wird, finden Sie unter Status der Gruppe überprüfen.
Systemzustände prüfen
Wenn Sie die automatische Reparatur für Ihre verwaltete Instanzgruppe konfiguriert haben, können Sie jede einzelne VM auf ihren Systemstatus prüfen. Weitere Informationen finden Sie im Abschnitt zur Prüfung des Systemstatus.
Instanzfehler auflisten
Wenn bei Ihren verwalteten Instanzen Fehler aufgetreten sind, können Sie diese aufrufen, um ihre Ursache zu ermitteln und das Problem zu beheben.
Verwenden Sie die Google Cloud Console, die gcloud CLI oder REST, um eine Liste der Fehler aufzurufen.
Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
Klicken Sie in der Spalte Name der Liste auf den Namen der Instanzgruppe, die Sie sich genauer ansehen möchten. Ihnen wird eine Seite mit den Attributen der Instanzgruppe und einer Liste der zur Gruppe gehörenden Instanzen angezeigt.
Klicken Sie auf Fehler.
Verwenden Sie den Befehl instance-groups managed list-errors
, um die neuesten Fehler der Gruppe aufzulisten.
gcloud compute instance-groups managed list-errorsinstance-group-name \ [--zonezone | --regionregion ]
Beispiel:
gcloud compute instance-groups managed list-errors example-group \ --region us-west1
INSTANCE_URL ACTION ERROR_CODE ERROR_MESSAGE TIMESTAMP INSTANCE_TEMPLATE VERSION_NAME https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-v0hl CREATING QUOTA_EXCEEDED Instance 'igm-1-v0hl' creation failed: Quota 'CPUS' exceeded. Limit: 1.0 in zone us-central1-a. 2019-07-11T07:44:40.156-07:00 https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1 https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-qp3d CREATING QUOTA_EXCEEDED Instance 'igm-1-qp3d' creation failed: Quota 'CPUS' exceeded. Limit: 1.0 in zone us-central1-a. 2019-07-11T07:44:40.081-07:00 https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1 ...
Senden Sie für eine zonal oder regional verwaltete Instanzgruppe eine GET
-Anfrage an die Methode listErrors
.
Beispiel:
GET https://compute.googleapis.com/compute/v1/projects/project-id /zones/zone /instanceGroupManagers/instance-group-name /listErrors&maxResults=100
Die Antwort sieht ungefähr so aus:
{ "items": [ { "error": { "code": "QUOTA_EXCEEDED", "message": "Instance 'example-mig-m1sz' creation failed: Quota 'CPUS' exceeded. Limit: 50.0 in zone us-central1-c." }, "timestamp": "2019-01-03T18:47:28.457-08:00", "instanceDetails" : { "instance": "zones/us-central1-c/instances/example-mig-m1sz", "action": "CREATING", "version": { "name": "example-version-name", "instanceTemplate": "global/instanceTemplates/example-template", } } } ], ... "nextPageToken": "Ch0yMDE5LTA3LTI5VDExOjA4OjA2LjYxMi0wNzowMBJ5aHR0cHM6Ly93d3cuZ29vZ2xlYXBpcy5jb20vY29tcHV0ZS9zdGFnaW5nX2FscGhhL3Byb2plY3RzL215cnpha2VyZXltcy1zdGFnaW5nL3pvbmVzL3VzLWNlbnRyYWwxLWlyMS9pbnN0YW5jZXMvaWdtLTEtcXAzZA==" }
Die API listErrors
unterstützt die Listenpaginierung.
Wenn Sie die nächste Ergebnisseite abrufen möchten, verwenden Sie das Feld nextPageToken
aus einer Antwort in einer nachfolgenden Anfrage. Beispiel:
GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/listErrors&maxResults=100&nextPageToken=next-page-token
, wobei next-page-token
durch das Token aus der vorherigen Antwort ersetzt wird.
Die Liste der möglichen Fehler umfasst unter anderem die folgenden Beispiele:
- Eine neue Instanz kann aus folgenden Gründen nicht erstellt werden:
- Kapazität auf Abruf nicht verfügbar.
- Unzureichendes Kontingent, z. B. für CPUs in einer bestimmten Region.
- Das Limit für die Anzahl der VM-Instanzen wurde für das mit der Gruppe verknüpfte Netzwerk erreicht.
- Das im Feld
properties.disks[].initializeParams.sourceImage
der Instanzvorlage angegebene Speicherabbild wurde gelöscht oder seine Berechtigungen wurden geändert. - Mit der im Rechnungskonto hinterlegten Kreditkarte, das mit dem Projekt verknüpft ist, konnte eine Zahlung nicht durchgeführt werden.
- Eine vorhandene Instanz kann aus folgendem Grund nicht gelöscht werden:
- Dem Dienstkonto, das von dieser Gruppe verwendet wird, fehlt die Berechtigung
compute.instances.delete
. - Es wurden zu viele gleichzeitige Löschvorgänge angefordert, wodurch die geltenden Ratenbegrenzungen überschritten wurden.
- Dem Dienstkonto, das von dieser Gruppe verwendet wird, fehlt die Berechtigung
- Eine Instanz kann einem Zielpool nicht hinzugefügt werden, da der Zielpool gelöscht wurde.
Nachdem Sie Fehler dieser Art geprüft haben, können Sie diese beheben. Beispiel:
- Verschieben Sie Ihre Arbeitslast in eine Zone mit Kapazität auf Abruf.
- Fordern Sie eine Kontingenterhöhung für eine bestimmte Region an.
- Fügen Sie dem Dienstkonto, das von der Gruppe verwendet wird, die Berechtigung
compute.instances.delete
hinzu.
Wenn eine von einer verwalteten Instanzgruppe ausgelöste Aktion fehlschlägt (z. B. wenn beim Autoscaling ein Fehler beim Versuch auftritt, die Gruppe zu vergrößern), wird die Aktion möglicherweise sofort wiederholt. Wenn der letzte sofortige Wiederholungsversuch fehlschlägt, wird der Fehler von der MIG aufgezeichnet und Sie können die Instanzfehler auflisten, um ihn anzusehen. Nach einer gewissen Backoff-Zeit wiederholt die Gruppe die fehlgeschlagene Aktion noch einmal. Wenn der Fehler dauerhaft besteht, wird er möglicherweise mehrmals aufgezeichnet.
Compute Engine behält die letzten 500 Fehler der letzten acht Tage bei, auch wenn die zugrunde liegenden Instanzen nicht mehr vorhanden sind oder nicht erstellt werden konnten.
Zugehörigkeit einer VM-Instanz zu einer MIG prüfen
Mit der Console oder REST können Sie prüfen, ob eine bestimmte VM Mitglied einer Gruppe ist.
- Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
- Klicken Sie auf eine Instanz, um die VM-Instanzdetails anzuzeigen.
- Wenn die VM-Instanz Mitglied einer verwalteten Instanzgruppe ist, wird der Name dieser verwalteten Instanzgruppe unter der Überschrift Verwendet von angezeigt. Wenn die VM-Instanz kein Mitglied einer Gruppe ist, wird die Überschrift Verwendet von nicht auf der Detailseite der Instanz angezeigt.
Alternativ können Sie in den Metadaten der Instanz nach den beiden folgenden Metadatenschlüsseln suchen, um zu ermitteln, ob eine VM Mitglied einer verwalteten Instanzgruppe ist oder war:
instance-template
gibt die Vorlage an, aus der die VM erstellt wurde.created-by
gibt die verwaltete Instanzgruppe an, die die VM erstellt hat.
Selbst wenn Sie die VM verwerfen, bleiben die Metadateneinträge erhalten, außer Sie entfernen diese manuell.
Wenn beispielsweise eine VM mit dem Namen random-instance-biy
vorhanden ist und Sie wissen möchten, ob die VM von einer verwalteten Instanzgruppe erstellt wurde, können Sie die Instanz angeben und nach den Metadatenschlüsseln suchen. Beispiel:
gcloud compute instances describe random-instance-biy \ --zone us-central1-f
Die gcloud CLI gibt in etwa folgende Antwort zurück:
canIpForward: false cpuPlatform: Intel Ivy Bridge creationTimestamp: '2016-08-24T14:11:38.012-07:00' ... metadata: items: - key: instance-template value: projects/123456789012/global/instanceTemplates/example-it - key: created-by value: projects/123456789012/zones/us-central1-f/instanceGroupManagers/igm-metadata
Beibehaltenen Status einer verwalteten Instanz aufrufen
Wenn Sie eine zustandsorientierte MIG konfiguriert haben und den beibehaltenen Status jeder verwalteten Instanz aufrufen möchten, finden Sie unter Zustandsorientierte Konfiguration und beibehaltenen Status aufrufen weitere Informationen.
Nächste Schritte
- Verwaltete Instanzgruppen
- Erstellen Sie eine Instanzvorlage, mit der Sie eine verwaltete Instanzgruppe erstellen können.