In diesem Dokument wird beschrieben, wie Sie die Einstellungen und den Fortschritt eines ordnungsgemäßen Herunterfahrens in einer Compute Engine-Instanz aufrufen. Weitere Informationen zum ordnungsgemäßen Herunterfahren finden Sie unter Ordnungsgemäßes Herunterfahren.
In den Details einer Instanz haben Sie folgende Möglichkeiten:
Einstellungen für die ordnungsgemäße Abschaltung ansehen Sie können prüfen, ob das geplante Herunterfahren aktiviert ist und wie lange es dauert.
Ordnungsgemäßes Herunterfahren beobachten Während eines ordnungsgemäßen Herunterfahrens können Sie Folgendes prüfen:
Wenn beim ordnungsgemäßen Herunterfahren eine Zeitüberschreitung auftritt.
Wenn ein Stopp- oder Löschvorgang läuft.
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.
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:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Klicken Sie in der Spalte Name auf den Namen Ihrer Instanz.
Die Detailseite der Instanz wird auf dem Tab Details geöffnet.
Um die Einstellungen für das geplante Herunterfahren zu prüfen, sehen Sie im Abschnitt Verfügbarkeitsrichtlinien nach, welchen Wert das Feld Maximale Dauer des geplanten Herunterfahrens hat. In diesem Feld wird der Zeitraum für die ordnungsgemäße Abschaltung angezeigt. Wenn ein Bindestrich (-) angezeigt wird, ist die ordnungsgemäße Abschaltung deaktiviert.
INSTANCE_NAME
: der Name der Instanz.ZONE
: Die Zone, in der sich die Instanz befindet.PROJECT_ID
: die ID des Projekts, in dem Sie die Instanz erstellt haben.ZONE
: Die Zone, in der sich die Instanz befindet.INSTANCE_NAME
: der Name der Instanz.Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Klicken Sie in der Spalte Name auf den Namen Ihrer Instanz.
Die Detailseite der Instanz wird auf dem Tab Details geöffnet.
Wenn ein ordnungsgemäßer Herunterfahrvorgang gerade ausgeführt wird, prüfen Sie im Bereich Grundlegende Informationen die folgenden Felder:
Status: In diesem Feld sehen Sie den Status Ihrer Instanz. Während eines ordnungsgemäßen Herunterfahrens wird in diesem Feld Ausstehendes Stoppen und ein Countdown-Timer angezeigt. Der Timer läuft bis zum Ende des ordnungsgemäßen Herunterfahrens.
Zielstatus: In diesem Feld sehen Sie, ob die Compute Engine die Instanz beendet (Beendet) oder löscht (Gelöscht).
INSTANCE_NAME
: der Name der Instanz.ZONE
: Die Zone, in der sich die Instanz befindet.MAX_DURATION
: die Dauer der ordnungsgemäßen Abschaltung in Sekunden. Nachdem die Compute EngineSTOP_STATE
aufSTOPPING
gesetzt hat, löscht sie das FeldmaxDuration
.REQUEST_TIMESTAMP
: Der Zeitstempel, zu dem dieSTOP_STATE
gestartet wurde.STOP_STATE
: die Phase des Beendens der Instanz. Der Wert kann einer der folgenden sein:PENDING_STOP
: Die Compute Engine hat den ordnungsgemäßen Herunterfahren gestartet. Die Instanz bleibt in diesem Status, bis Sie den ordnungsgemäßen Herunterfahren manuell beenden oder die Zeitüberschreitung für den ordnungsgemäßen Herunterfahren abgelaufen ist.STOPPING
: Das geplante Herunterfahren ist beendet und die Compute Engine fährt mit dem Beenden oder Löschen fort.
TARGET_STATE
: Ob die Compute Engine die Instanz beendet (STOPPED
) oder löscht (DELETED
).PROJECT_ID
: die ID des Projekts, in dem Sie die Instanz erstellt haben.ZONE
: Die Zone, in der sich die Instanz befindet.INSTANCE_NAME
: der Name der Instanz.MAX_DURATION
: die Dauer der ordnungsgemäßen Abschaltung in Sekunden. Nachdem die Compute EngineSTOP_STATE
aufSTOPPING
gesetzt hat, löscht sie das FeldmaxDuration
.REQUEST_TIMESTAMP
: Der Zeitstempel, zu dem dieSTOP_STATE
gestartet wurde.STOP_STATE
: die Phase des Beendens der Instanz. Der Wert kann einer der folgenden sein:PENDING_STOP
: Die Compute Engine hat den ordnungsgemäßen Herunterfahren gestartet. Die Instanz bleibt in diesem Status, bis Sie den ordnungsgemäßen Herunterfahren manuell beenden oder die Zeitüberschreitung für den ordnungsgemäßen Herunterfahren abgelaufen ist.STOPPING
: Das geplante Herunterfahren ist beendet und die Compute Engine fährt mit dem Beenden oder Löschen fort.
TARGET_STATE
: Ob die Compute Engine die Instanz beendet (STOPPED
) oder löscht (DELETED
).eine Verbindung zur Instanz herstellen
Metadatenserver abfragen:
curl "http://metadata.google.internal/computeMetadata/v1/instance/shutdown-details/?recursive=true?alt=json" \-H "Metadata-Flavor: Google"
Wenn ein ordnungsgemäßer Herunterfahrvorgang in Bearbeitung ist, sieht die Ausgabe in etwa so aus:
{ "maxDuration": "MAX_DURATION", "requestTimestamp": "REQUEST_TIMESTAMP", "stopState": "STOP_STATE", "targetState": "TARGET_STATE" }
Die Ausgabe enthält die folgenden Werte:
MAX_DURATION
: Die Dauer der ordnungsgemäßen Abschaltung in Sekunden. Nachdem die Compute EngineSTOP_STATE
aufSTOPPING
gesetzt hat, löscht sie das FeldmaxDuration
.REQUEST_TIMESTAMP
: Der Zeitstempel, zu dem dieSTOP_STATE
gestartet wurde.STOP_STATE
: die Phase des Beendens der Instanz. Der Wert kann einer der folgenden sein:PENDING_STOP
: Die Compute Engine hat die ordnungsgemäße Deaktivierung gestartet. Die Instanz bleibt in diesem Status, bis Sie den ordnungsgemäßen Herunterfahrvorgang manuell beenden oder das Zeitlimit für den ordnungsgemäßen Herunterfahrvorgang abläuft.STOPPING
: Die geplante Deaktivierung ist beendet und die Compute Engine fährt mit dem Beenden oder Löschen fort.
TARGET_STATE
: Ob die Compute Engine die Instanz beendet (STOPPED
) oder löscht (DELETED
).
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.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-Instanzadministrator (v1) (
roles/compute.instanceAdmin.v1
) für Ihr Projekt zu gewähren, um die Berechtigung zum Aufrufen des ordnungsgemäßen Herunterfahrens einer Compute-Instanz zu erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.Diese vordefinierte Rolle enthält die Berechtigung
compute.instances.get
on the projectSie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Einstellungen für die ordnungsgemäße Abschaltung ansehen
Wählen Sie eine der folgenden Optionen aus, um die Einstellungen für den ordnungsgemäßen Herunterfahren in einer Compute-Instanz aufzurufen:
Console
gcloud
Verwenden Sie den Befehl
gcloud beta compute instances describe
, um die Einstellungen für das geplante Herunterfahren in einer Instanz aufzurufen:gcloud beta compute instances describe INSTANCE_NAME \ --zone=ZONE
Ersetzen Sie Folgendes:
Wenn der geplante Ablauf aktiviert ist, sieht die Ausgabe in etwa so aus:
... scheduling: ... gracefulShutdown: enabled: true maxDuration: seconds: 'MAX_DURATION' ... ...
Die Ausgabe enthält den Wert
MAX_DURATION
. Dieser Wert gibt an, wie lange die Graceful Shutdown-Phase in Sekunden dauert. Wenn Sie beim Aktivieren des ordnungsgemäßen Herunterfahrens in der Instanz keinen benutzerdefinierten Zeitraum angegeben haben, lässt Compute Engine das FeldmaxDuration
aus und setzt den Zeitraum für das ordnungsgemäße Herunterfahren auf 10 Minuten.REST
Wenn Sie die Einstellungen für das ordnungsgemäße Herunterfahren einer Instanz aufrufen möchten, senden Sie eine
GET
-Anfrage an die beta-Methodeinstances.get
:GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
Ersetzen Sie Folgendes:
Wenn der geplante Ablauf aktiviert ist, sieht die Ausgabe in etwa so aus:
{ ... "scheduling": { ... "gracefulShutdown": { "enabled": true, "maxDuration": { "seconds": "MAX_DURATION" } } }, ... }
Die Ausgabe enthält den Wert
MAX_DURATION
. Dieser Wert gibt an, wie lange die Graceful Shutdown-Phase in Sekunden dauert. Wenn Sie beim Aktivieren des ordnungsgemäßen Herunterfahrens in der Instanz keinen benutzerdefinierten Zeitraum angegeben haben, lässt Compute Engine das FeldmaxDuration
aus und setzt den Zeitraum für das ordnungsgemäße Herunterfahren auf 10 Minuten.Ordnungsgemäßes Herunterfahren beobachten
Wählen Sie eine der folgenden Optionen aus, um eine laufende geplante Heruntersetzung in einer Compute-Instanz zu überwachen:
Console
gcloud
Verwenden Sie den Befehl
gcloud beta compute instances describe
, um ein laufendes geplantes Herunterfahren in einer Instanz zu überwachen:gcloud beta compute instances describe INSTANCE_NAME \ --zone=ZONE
Ersetzen Sie Folgendes:
Wenn ein ordnungsgemäßer Herunterfahrvorgang in Bearbeitung ist, sieht die Ausgabe in etwa so aus:
... resourceStatus: ... shutdownDetails: maxDuration: seconds: 'MAX_DURATION' requestTimestamp: 'REQUEST_TIMESTAMP' stopState: STOP_STATE targetState: TARGET_STATE ... status: PENDING_STOP ...
Diese Ausgabe enthält die folgenden Werte:
Wenn ein Stoppvorgang ausgeführt wird, löscht Compute Engine das Feld
shutdownDetails
, nachdem das Feldstatus
aufTERMINATE
gesetzt wurde.REST
Wenn Sie einen laufenden ordnungsgemäßen Herunterfahrvorgang in einer Instanz beobachten möchten, senden Sie eine
GET
-Anfrage an die Betamethodeinstances.get
:GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
Ersetzen Sie Folgendes:
Wenn ein ordnungsgemäßer Herunterfahrvorgang in Bearbeitung ist, sieht die Ausgabe in etwa so aus:
{ ... "resourceStatus": { ... "shutdownDetails": { "maxDuration": { "seconds": "MAX_DURATION" }, "requestTimestamp": "REQUEST_TIMESTAMP", "stopState": "STOP_STATE", "targetState": "TARGET_STATE" } }, ... "status": "PENDING_STOP", ... }
Diese Ausgabe enthält die folgenden Werte:
Wenn ein Stoppvorgang ausgeführt wird, löscht Compute Engine das Feld
shutdownDetails
, nachdem das Feldstatus
aufTERMINATE
gesetzt wurde.Metadatenserver
Nächste Schritte
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-02-05 (UTC).
-