Compute Engine-Vorgänge ansehen

Wenn Sie eine Compute Engine API aufrufen, bei der eine Ressource mutiert wird, fügt die Compute Engine der Liste der Vorgänge einen Eintrag hinzu. Wenn Sie beispielsweise eine Aktualisierung einer VM vornehmen, bei der Daten mutiert (geändert) werden, oder wenn ein Hostereignis auftritt, das den Status einer VM ändert, werden Vorgänge erstellt. Auf dieser Seite wird beschrieben, wie Sie eine Liste der Compute Engine-Vorgänge mithilfe der Google Cloud Console, der Google Cloud CLI oder von REST aufrufen können.

Beachten Sie, dass das Abschließen von Vorgängen einige Zeit in Anspruch nehmen kann. Daher werden während der Anzeige möglicherweise unvollständige Vorgänge angezeigt. Wenn Sie den endgültigen Status von nicht abgeschlossenen Vorgängen sehen möchten, wird nicht empfohlen, die Vorgänge wiederholt aufzurufen. Stattdessen sollten Sie warten, bis die Vorgänge abgeschlossen sind.

Hinweise

  • 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 so bei Compute Engine authentifizieren.

    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

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. 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.

Aufbewahrungsdauer des Vorgangs

Beachten Sie beim Abfragen von Vorgängen, dass abgeschlossene Vorgänge nach einem bestimmten Zeitraum automatisch aus der Datenbank entfernt werden.

In der Compute Engine werden abgeschlossene Vorgänge mindestens 1 Stunde und maximal 14 Tage aufbewahrt. Obwohl Projekte häufig eine längere Aufbewahrungsdauer als das Minimum von 1 Stunde für abgeschlossene Vorgänge vorsehen, wird eine zusätzliche Aufbewahrungsdauer nicht empfohlen.

Die Aufbewahrungsfristen gelten nicht für Vorgänge, die von Nutzern über die Methode Operations.delete gelöscht wurden.

Vorgänge anzeigen

Führen Sie die folgenden Schritte aus, um eine Liste der Vorgänge für Ihr Projekt aufzurufen:

Console

  1. Öffnen Sie in der Google Cloud Console die Seite Vorgänge.

    Zur Seite "Vorgänge"

  2. Klicken Sie für weitere Informationen zu einem Vorgang auf die Vorgangszusammenfassung. Wenn Sie beispielsweise die Migrationsdetails für die VM my-instance sehen möchten, klicken Sie auf den Vorgang Automatically migrate an instance (Instanz automatisch migrieren).

Die Seite "Vorgänge" mit einer Live-Migration Details der Live-Migration

gcloud

Verwenden Sie den Unterbefehl operations list, um mit gcloud compute eine Liste der Vorgänge für Ihr Projekt anzusehen.

Wenn Sie die Liste der Vorgänge in einer bestimmten Zone ansehen möchten, fügen Sie das Flag --filter hinzu.

gcloud compute operations list --filter="zone:(ZONE)"

Ersetzen Sie ZONE durch die Zone, in der Sie die Liste der Vorgänge ansehen möchten. Führen Sie beispielsweise den folgenden Befehl aus, um die Liste der Vorgänge in us-cental1-c anzusehen:

gcloud compute operations list --filter="zone:(us-central1-c)"

Die Ausgabe sieht in etwa so aus: 

NAME                            TYPE                                        TARGET                                HTTP_STATUS  STATUS  TIMESTAMP
systemevent-1543845145000...    compute.instances.migrateOnHostMaintenance  us-central1-c/instances/my-instance   200          DONE    2018-12-03T05:52:25.000-08:00

REST

API-Anfragen für Vorgänge müssen entweder auf globaler, regionaler oder zonaler Ebene angegeben werden. Die Live-Migration, die Beendigung der VM und die automatischen Neustarts sind Vorgänge auf Zonenebene.

Stellen Sie für Zonenvorgänge eine GET-Anfrage an die Methode zoneOperations.list.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/operations

Ersetzen Sie dabei Folgendes:

  • PROJECT_ID: die Projekt-ID für diese Anfrage
  • ZONE: die Zone für diese Anfrage

Lassen Sie den Anfragetext leer.

Das folgende Beispiel zeigt die Ausgabe für eine Zonenvorgangsanfrage. In dieser Ausgabe sind Details zu einer Hostmigration angegeben.

{
 "kind": "compute#operation",
 "id": "3216798767364213712",
 "name": "systemevent-1543845145000-57c1e7574b840-a195b637-5ff74d9b",
 "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c",
 "operationType": "compute.instances.migrateOnHostMaintenance",
 "targetLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/instances/my-instance",
 "targetId": "3070988523247098025",
 "status": "DONE",
 "statusMessage": "Instance migrated during Compute Engine maintenance.",
 "user": "system",
 "progress": 100,
 "insertTime": "2018-12-03T05:52:25.000-08:00",
 "startTime": "2018-12-03T05:52:25.000-08:00",
 "endTime": "2018-12-03T05:52:25.000-08:00",
 "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/operations/systemevent-1543845145000-57c1e7574b840-a195b637-5ff74d9b"
}