Wenn Sie eine Compute Engine API aufrufen, mit der eine Ressource mutiert wird, fügt 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 unvollständiger Vorgänge sehen möchten, sollten Sie diese nicht wiederholt aufrufen. Stattdessen sollten Sie auf den Abschluss von Vorgängen warten.
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 wie folgt bei Compute Engine authentifizieren.
Wählen Sie den Tab für die Verwendung der Beispiele auf dieser Seite aus:
Console
Wenn Sie über die Google Cloud Console auf Google Cloud-Dienste und -APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.
gcloud
-
Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:
gcloud init
- Legen Sie eine Standardregion und -zone fest.
REST
Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.
Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:
gcloud init
-
Aufbewahrungsdauer für Vorgänge
Beachten Sie beim Abfragen von Vorgängen, dass abgeschlossene Vorgänge nach einem bestimmten Zeitraum automatisch aus der Datenbank entfernt werden.
Compute Engine speichert abgeschlossene Vorgänge mindestens für die Mindestaufbewahrungsdauer von 1 Stunde und bis zur maximalen Aufbewahrungsdauer von 14 Tagen. 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 Aufbewahrungsdauer gilt nicht für Vorgänge, die von Nutzern mit der Methode Operations.delete gelöscht werden.
Vorgänge anzeigen
Führen Sie die folgenden Schritte aus, um eine Liste der Vorgänge für Ihr Projekt aufzurufen:
Console
Öffnen Sie in der Google Cloud Console die Seite Vorgänge.
Klicken Sie für weitere Informationen zu einem Vorgang auf die Vorgangszusammenfassung. Wenn Sie beispielsweise die Migrationsdetails für die VM
my-instancesehen möchten, klicken Sie auf den Vorgang Automatically migrate an instance (Instanz automatisch migrieren).
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 AnfrageZONE: 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"
}