Fehlerfreies Herunterfahren in einer Compute Engine-Instanz ansehen

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite VM-Instanzen auf.

   Zur Seite „VM-Instanzen“

2. Klicken Sie in der Spalte Name auf den Namen Ihrer Compute-Instanz. Die Detailseite der Compute-Instanz wird auf dem Tab Details geöffnet.

3. Wenn Sie die Einstellungen für das ordnungsgemäße Herunterfahren prüfen möchten, sehen Sie sich im Abschnitt Verfügbarkeitsrichtlinien den Wert des Felds Maximale Dauer für ordnungsgemäßes Herunterfahren an. In diesem Feld wird der Zeitraum für das ordnungsgemäße Herunterfahren angezeigt. Wenn ein Bindestrich (-) angezeigt wird, ist das ordnungsgemäße Herunterfahren deaktiviert.

gcloud

Verwenden Sie den Befehl gcloud compute instances describe, um die Einstellungen für das ordnungsgemäße Herunterfahren in einer Compute-Instanz aufzurufen:

gcloud compute instances describe INSTANCE_NAME \
    --zone=ZONE

Ersetzen Sie Folgendes:

• INSTANCE_NAME: Der Name der Compute-Instanz.

• ZONE: die Zone, in der sich die Compute-Instanz befindet.

Wenn das ordnungsgemäße Herunterfahren 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, der die maximale Dauer des ordnungsgemäßen Herunterfahrens in Sekunden angibt. Wenn Sie beim Aktivieren des ordnungsgemäßen Herunterfahrens keine benutzerdefinierte Dauer angegeben haben, lässt Compute Engine das Feld maxDuration weg und verwendet eine Standarddauer von 10 Minuten.

REST

Wenn Sie die Einstellungen für das ordnungsgemäße Herunterfahren in einer Compute-Instanz aufrufen möchten, senden Sie eine GET-Anfrage an die Methode instances.get:

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Projekts, in dem Sie die Compute-Instanz erstellt haben.

• ZONE: die Zone, in der sich die Compute-Instanz befindet.

• INSTANCE_NAME: Der Name der Compute-Instanz.

Wenn das ordnungsgemäße Herunterfahren 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, der die maximale Dauer des ordnungsgemäßen Herunterfahrens in Sekunden angibt. Wenn Sie beim Aktivieren des ordnungsgemäßen Herunterfahrens keine benutzerdefinierte Dauer angegeben haben, lässt Compute Engine das Feld maxDuration weg und verwendet eine Standarddauer von 10 Minuten.

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite VM-Instanzen auf.

   Zur Seite „VM-Instanzen“

2. Klicken Sie in der Spalte Name auf den Namen Ihrer Compute-Instanz. Die Detailseite der Compute-Instanz wird auf dem Tab Details geöffnet.

3. Wenn ein ordnungsgemäßes Herunterfahren im Gange ist, prüfen Sie die folgenden Felder im Abschnitt Grundlegende Informationen:

   • Status: Zeigt den Status Ihrer Compute-Instanz an. Während eines ordnungsgemäßen Herunterfahrens wird Beenden ausstehend mit einem Countdown-Timer angezeigt, der angibt, wann das ordnungsgemäße Herunterfahren endet.

   • Zielstatus: Gibt an, ob Compute Engine die Compute-Instanz beendet (Beendet) oder löscht (Gelöscht).

gcloud

Verwenden Sie den Befehl gcloud compute instances describe, um ein laufendes ordnungsgemäßes Herunterfahren in einer Compute-Instanz zu überwachen:

gcloud compute instances describe INSTANCE_NAME \
    --zone=ZONE

Ersetzen Sie Folgendes:

• INSTANCE_NAME: Der Name der Compute-Instanz.

• ZONE: die Zone, in der sich die Compute-Instanz befindet.

Wenn ein ordnungsgemäßes Herunterfahren im Gange 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:

• MAX_DURATION: die maximale Dauer des ordnungsgemäßen Herunterfahrens in Sekunden. Wenn sich STOP_STATE in STOPPING ändert, löscht Compute Engine das Feld maxDuration.

• REQUEST_TIMESTAMP: Der Zeitstempel, der angibt, wann die STOP_STATE gestartet wurde.

• STOP_STATE: die Beendigungsphase der Compute-Instanz. Der Wert kann einer der folgenden sein:

  • PENDING_STOP: Compute Engine hat das ordnungsgemäße Herunterfahren gestartet. Die Compute-Instanz bleibt in diesem Status, bis Sie das ordnungsgemäße Herunterfahren manuell beenden oder der Timer abläuft.

  • STOPPING: Das ordnungsgemäße Herunterfahren ist beendet und Compute Engine fährt mit dem Beenden oder Löschen fort.

• TARGET_STATE: Gibt an, ob die Compute Engine-Instanz von Compute Engine beendet (STOPPED) oder gelöscht (DELETED) wird.

Wenn Compute Engine die Compute-Instanz beendet hat, ändert Compute Engine den Status der Compute-Instanz in TERMINATE und löscht das Feld shutdownDetails.

REST

Wenn Sie ein laufendes ordnungsgemäßes Herunterfahren in einer Compute-Instanz überwachen möchten, senden Sie eine GET-Anfrage an die Methode instances.get:

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Projekts, in dem Sie die Compute-Instanz erstellt haben.

• ZONE: die Zone, in der sich die Compute-Instanz befindet.

• INSTANCE_NAME: Der Name der Compute-Instanz.

Wenn ein ordnungsgemäßes Herunterfahren im Gange 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:

• MAX_DURATION: die maximale Dauer des ordnungsgemäßen Herunterfahrens in Sekunden. Wenn sich STOP_STATE in STOPPING ändert, löscht Compute Engine das Feld maxDuration.

• REQUEST_TIMESTAMP: Der Zeitstempel, der angibt, wann die STOP_STATE gestartet wurde.

• STOP_STATE: die Beendigungsphase der Compute-Instanz. Der Wert kann einer der folgenden sein:

  • PENDING_STOP: Compute Engine hat das ordnungsgemäße Herunterfahren gestartet. Die Compute-Instanz bleibt in diesem Status, bis Sie das ordnungsgemäße Herunterfahren manuell beenden oder der Timer abläuft.

  • STOPPING: Das ordnungsgemäße Herunterfahren ist beendet und Compute Engine fährt mit dem Beenden oder Löschen fort.

• TARGET_STATE: Gibt an, ob die Compute Engine-Instanz von Compute Engine beendet (STOPPED) oder gelöscht (DELETED) wird.

Wenn Compute Engine die Compute-Instanz beendet hat, ändert Compute Engine den Status der Compute-Instanz in TERMINATE und löscht das Feld shutdownDetails.

Linux

1. Stellen Sie eine Verbindung zu Ihrer Linux-Compute-Instanz her.

2. Führen Sie den folgenden Befehl mit dem curl-Tool aus, um den Metadatenschlüssel shutdown-details abzufragen:

   user@myinst:~$ curl -s -H "Metadata-Flavor: Google" http://metadata.google.internal/computeMetadata/v1/instance/shutdown-details
   

   Wenn ein ordnungsgemäßes Herunterfahren im Gange 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 des ordnungsgemäßen Herunterfahrens in Sekunden. Nachdem Compute Engine STOP_STATE auf STOPPING gesetzt hat, wird das Feld maxDuration gelöscht.

   • REQUEST_TIMESTAMP: der Zeitstempel, der angibt, wann die STOP_STATE gestartet wurde.

   • STOP_STATE: die Beendigungsphase der Compute-Instanz. Der Wert kann einer der folgenden sein:

     • PENDING_STOP: Compute Engine hat das ordnungsgemäße Herunterfahren gestartet. Die Compute-Instanz bleibt in diesem Zustand, bis Sie das ordnungsgemäße Herunterfahren manuell beenden oder der Timer abläuft.

     • STOPPING: Das ordnungsgemäße Herunterfahren ist beendet und Compute Engine fährt mit dem Beenden oder Löschen fort.

   • TARGET_STATE: Gibt an, ob die Compute Engine-Instanz von Compute Engine beendet (STOPPED) oder gelöscht (DELETED) wird.

Windows

1. Stellen Sie eine Verbindung zu Ihrer Windows-Compute-Instanz her.

2. Verwenden Sie das Invoke-RestMethod-Cmdlet, um den Metadatenschlüssel shutdown-details abzufragen:

   PS C:\> 
   $value = (Invoke-RestMethod `
           -Headers @{'Metadata-Flavor' = 'Google'} `
           -Uri "http://metadata.google.internal/computeMetadata/v1/instance/shutdown-details")
   $value
   

   Wenn ein ordnungsgemäßes Herunterfahren im Gange 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 des ordnungsgemäßen Herunterfahrens in Sekunden. Nachdem Compute Engine STOP_STATE auf STOPPING gesetzt hat, wird das Feld maxDuration gelöscht.

   • REQUEST_TIMESTAMP: der Zeitstempel, der angibt, wann die STOP_STATE gestartet wurde.

   • STOP_STATE: die Beendigungsphase der Compute-Instanz. Der Wert kann einer der folgenden sein:

     • PENDING_STOP: Compute Engine hat das ordnungsgemäße Herunterfahren gestartet. Die Compute-Instanz bleibt in diesem Zustand, bis Sie das ordnungsgemäße Herunterfahren manuell beenden oder der Timer abläuft.

     • STOPPING: Das ordnungsgemäße Herunterfahren ist beendet und Compute Engine fährt mit dem Beenden oder Löschen fort.

   • TARGET_STATE: Gibt an, ob die Compute Engine-Instanz von Compute Engine beendet (STOPPED) oder gelöscht (DELETED) wird.

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite Log-Explorer auf:

   Zum Log-Explorer

2. Geben Sie im Bereich „Abfrage“ die folgende Abfrage ein:

   resource.type="gce_instance"
   protoPayload.serviceName="compute.googleapis.com"
   protoPayload.methodName:"compute.instances.gracefulShutdown"
   

3. Klicken Sie auf Abfrage ausführen.

gcloud

Wenn Sie Cloud-Audit-Logs nach dem Start eines ordnungsgemäßen Herunterfahrens aufrufen möchten, verwenden Sie einen der folgenden gcloud logging read-Befehle:

• Führen Sie den folgenden Befehl aus, um das ordnungsgemäße Herunterfahren aller Compute-Instanzen zu überwachen, die ordnungsgemäß heruntergefahren werden:

  gcloud logging read 'resource.type="gce_instance" AND protoPayload.serviceName="compute.googleapis.com" AND protoPayload.methodName:"compute.instances.gracefulShutdown"'
  

• Führen Sie den folgenden Befehl aus, um das ordnungsgemäße Herunterfahren einer einzelnen Compute-Instanz zu überwachen:

  gcloud logging read 'resource.type="gce_instance" AND protoPayload.serviceName="compute.googleapis.com" AND protoPayload.methodName:"compute.instances.gracefulShutdown" AND "INSTANCE_NAME"'
  

  Ersetzen Sie INSTANCE_NAME durch den Namen der Compute-Instanz.

Die Ausgabe sieht etwa so aus:

insertId: -gvb9n5drmdg
labels:
  compute.googleapis.com/root_trigger_id: e23093bc-2c55-4ee4-b7cf-ea8b295f0d9a
logName: projects/example-project/logs/cloudaudit.googleapis.com%2Fsystem_event
operation:
  id: gracefulShutdown-1783417965660-656025a544aa5-0eefacb0-38dc7152
  last: true
  producer: compute.instances.gracefulShutdown
protoPayload:
  '@type': type.googleapis.com/google.cloud.audit.AuditLog
  authenticationInfo:
    principalEmail: system@google.com
  methodName: compute.instances.gracefulShutdown
  request:
    '@type': type.googleapis.com/compute.instances.gracefulShutdown
  resourceName: projects/example-project/zones/us-central1-a/instances/vm-01
  serviceName: compute.googleapis.com
  status:
    message: Instance graceful shutdown completed.
receiveTimestamp: '2026-07-07T10:04:06.109088155Z'
resource:
  labels:
    instance_id: '4210316577417032387'
    project_id: example-project
    zone: us-central1-a
  type: gce_instance
severity: INFO
timestamp: '2026-07-07T10:04:05.846992Z'

REST

Wenn Sie Cloud-Audit-Logs nach dem Start eines ordnungsgemäßen Herunterfahrens aufrufen möchten, senden Sie eine POST-Anfrage an die Methode entries.list:

POST https://logging.googleapis.com/v2/entries:list

{
  "resourceNames": [
    "projects/PROJECT_ID"
  ],
  "filter": "resource.type=\"gce_instance\" AND protoPayload.serviceName=\"compute.googleapis.com\" AND protoPayload.methodName:\"compute.instances.gracefulShutdown\""
}

Ersetzen Sie PROJECT_ID durch die ID des Projekts, in dem sich Ihre Compute-Instanz befindet.

Die Ausgabe sieht etwa so aus:

{
  "insertId": "-gvb9n5drmdg",
  "labels": {
    "compute.googleapis.com/root_trigger_id": "e23093bc-2c55-4ee4-b7cf-ea8b295f0d9a"
  },
  "logName": "projects/example-project/logs/cloudaudit.googleapis.com%2Fsystem_event",
  "operation": {
    "id": "gracefulShutdown-1783417965660-656025a544aa5-0eefacb0-38dc7152",
    "last": true,
    "producer": "compute.instances.gracefulShutdown"
  },
  "protoPayload": {
    "@type": "type.googleapis.com/google.cloud.audit.AuditLog",
    "authenticationInfo": {
      "principalEmail": "system@google.com"
    },
    "methodName": "compute.instances.gracefulShutdown",
    "request": {
      "@type": "type.googleapis.com/compute.instances.gracefulShutdown"
    },
    "resourceName": "projects/example-project/zones/us-central1-a/instances/vm-01",
    "serviceName": "compute.googleapis.com",
    "status": {
      "message": "Instance graceful shutdown completed."
    }
  },
  "receiveTimestamp": "2026-07-07T10:04:06.109088155Z",
  "resource": {
    "labels": {
      "instance_id": "4210316577417032387",
      "project_id": "example-project",
      "zone": "us-central1-a"
    },
    "type": "gce_instance"
  },
  "severity": "INFO",
  "timestamp": "2026-07-07T10:04:05.846992Z"
}

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite Vorgänge auf.

   Zur Seite "Vorgänge"

2. Optional: Wenn Sie die Liste der Vorgänge so eingrenzen möchten, dass nur die laufenden ordnungsgemäßen Herunterfahrvorgänge in einer bestimmten Region oder Zone angezeigt werden, geben Sie im Feld filter_list Filter einen der folgenden Filter ein:

   • Verwenden Sie den folgenden Filter, um alle Vorgänge in einer Region aufzurufen:

     Target:https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION
     

   • Verwenden Sie den folgenden Filter, um alle Vorgänge in einer einzelnen Zone aufzurufen:

     Target:https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE
     

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die ID des Projekts, in dem sich Ihre Compute-Instanzen befinden.

   • REGION: die Region, in der sich Ihre Compute-Instanzen befinden.

   • ZONE: die Zone, in der sich Ihre Compute-Instanzen befinden.

3. Wenn Sie die Details eines bestimmten Vorgangs aufrufen möchten, klicken Sie in der Spalte Vorgangszusammenfassung auf die Zusammenfassung des Vorgangs. Eine Seite mit den Details des Vorgangs wird geöffnet.

gcloud

Verwenden Sie den folgenden gcloud compute operations list-Befehl, um alle laufenden oder abgeschlossenen ordnungsgemäßen Herunterfahrvorgänge der Compute-Instanzen in Ihrem Projekt aufzurufen:

gcloud compute operations list \
    --filter="operationType=compute.instances.gracefulShutdown"

Die Ausgabe sieht etwa so aus:

NAME: operation-1782409401831-65517873d8fe0-76bb4c47-978a64be
TYPE: compute.instances.gracefulShutdown
TARGET: vm-01
HTTP_STATUS: 200
STATUS: RUNNING
TIMESTAMP: 2026-07-07T10:04:05.846992Z

NAME: operation-1783420590456-656035b8e9fa0-84dc2a39-1b9c83fe
TYPE: compute.instances.gracefulShutdown
TARGET: vm-02
HTTP_STATUS: 200
STATUS: RUNNING
TIMESTAMP: 2026-07-07T10:04:05.846992Z

Wenn Sie die laufenden ordnungsgemäßen Herunterfahrvorgänge in bestimmten Regionen oder Zonen sehen möchten, verwenden Sie denselben Befehl mit dem Flag --regions oder --zones.

REST

Wenn Sie alle laufenden oder abgeschlossenen ordnungsgemäßen Herunterfahrvorgänge der Compute-Instanzen in Ihrem Projekt aufrufen möchten, stellen Sie eine der folgenden Anfragen:

• Wenn Sie alle laufenden oder abgeschlossenen ordnungsgemäßen Herunterfahrvorgänge in allen Regionen und Zonen aufrufen möchten, senden Sie eine GET-Anfrage an die Methode globalOperations.list:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/operations?filter=operationType=compute.instances.gracefulShutdown
  

• Wenn Sie alle laufenden oder abgeschlossenen ordnungsgemäßen Herunterfahrvorgänge in einer Region aufrufen möchten, senden Sie eine GET-Anfrage an die Methode regionOperations.list:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/operations?filter=operationType=compute.instances.gracefulShutdown
  

• Wenn Sie alle laufenden oder abgeschlossenen ordnungsgemäßen Herunterfahrvorgänge in einer einzelnen Zone aufrufen möchten, senden Sie eine GET-Anfrage an die Methode zoneOperations.list:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/operations?filter=operationType=compute.instances.gracefulShutdown
  

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Projekts, in dem sich Ihre Compute-Instanzen befinden.

• REGION: die Region, in der sich Ihre Compute-Instanzen befinden.

• ZONE: die Zone, in der sich Ihre Compute-Instanzen befinden.

Die Ausgabe sieht etwa so aus:

{
  "kind": "compute#operationList",
  "id": "projects/example-project/zones/us-central1-a/operations",
  "items": [
    {
      "kind": "compute#operation",
      "id": "4210316577417032387",
      "name": "operation-1782409401831-65517873d8fe0-76bb4c47-978a64be",
      "operationType": "compute.instances.gracefulShutdown",
      "targetLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/vm-01",
      "status": "RUNNING",
      "user": "system@google.com",
      "progress": 0,
      "insertTime": "2026-07-07T10:04:05.846992Z",
      "startTime": "2026-07-07T10:04:05.846992Z",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/operations/operation-1782409401831-65517873d8fe0-76bb4c47-978a64be"
    },
    ...
  ]
}