Operations

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Stellt eine Vorgangsressource dar.

Die Google Compute Engine hat drei Betriebsressourcen:


Mit einer Vorgangsressource können Sie asynchrone API-Anfragen verwalten. Weitere Informationen finden Sie unter API-Antworten verarbeiten.

Vorgänge können global, regional oder zonal sein.
  • Verwenden Sie für globale Vorgänge die Ressource „globalOperations“.
  • Verwenden Sie für regionale Vorgänge die Ressource „regionOperations“.
  • Verwenden Sie für zonale Vorgänge die Ressource „zonalOperations“.


Weitere Informationen finden Sie unter Globale, regionale und zonale Ressourcen.

{
  "kind": "deploymentmanager#operation",
  "id": unsigned long,
  "creationTimestamp": string,
  "name": string,
  "zone": string,
  "clientOperationId": string,
  "operationType": string,
  "targetLink": string,
  "targetId": unsigned long,
  "status": string,
  "statusMessage": string,
  "user": string,
  "progress": integer,
  "insertTime": string,
  "startTime": string,
  "endTime": string,
  "error": {
    "errors": [
      {
        "code": string,
        "location": string,
        "message": string
      }
    ]
  },
  "warnings": [
    {
      "code": string,
      "message": string,
      "data": [
        {
          "key": string,
          "value": string
        }
      ]
    }
  ],
  "httpErrorStatusCode": integer,
  "httpErrorMessage": string,
  "selfLink": string,
  "region": string,
  "description": string
}
Eigenschaft Wert Beschreibung Hinweise
clientOperationId string [Nur Ausgabe] Der Wert von „requestId“, sofern Sie ihn in der Anfrage angegeben haben. Andernfalls nicht vorhanden.
creationTimestamp string [Deprecated] Die Verwendung dieses Feldes wurde eingestellt.
description string [Nur Ausgabe] Eine Textbeschreibung des Vorgangs, die bei der Erstellung des Vorgangs festgelegt wird.
endTime string [Nur Ausgabe] Der Zeitpunkt, zu dem dieser Vorgang abgeschlossen wurde. Dieser Wert hat das Textformat RFC3339.
error object [Nur Ausgabe] Wenn während der Verarbeitung des Vorgangs Fehler auftreten, erfolgt in diesem Feld eine Ausgabe.
error.errors[] list [Nur Ausgabe] Die Reihe der Fehler, die erkannt wurden, während dieser Vorgang verarbeitet wird.
error.errors[].code string [Nur Ausgabe] Die Fehlertypkennung für diesen Fehler.
error.errors[].location string [Nur Ausgabe] Gibt das Feld in der Anfrage an, das den Fehler verursacht hat. Diese Eigenschaft ist optional.
error.errors[].message string [Nur Ausgabe] Eine optionale, menschenlesbare Fehlermeldung.
httpErrorMessage string [Nur Ausgabe] Wenn der Vorgang fehlschlägt, enthält dieses Feld die zurückgegebene HTTP-Fehlermeldung, z. B. „NICHT GEFUNDEN“.
httpErrorStatusCode integer [Nur Ausgabe] Wenn der Vorgang fehlschlägt, enthält dieses Feld den zurückgegebenen HTTP-Fehlerstatuscode. Ein „404“ bedeutet beispielsweise, dass die Ressource nicht gefunden wurde.
id unsigned long [Nur Ausgabe] Die eindeutige Kennung für den Vorgang. Diese Kennung wird durch den Server definiert.
insertTime string [Nur Ausgabe] Der Zeitpunkt, zu dem dieser Vorgang angefordert wurde. Dieser Wert hat das Textformat RFC3339.
kind string [Nur Ausgabe] Typ der Ressource. Für Vorgangsressourcen immer „compute#operation“.
name string [Nur Ausgabe] Name des Vorgangs.
operationType string [Nur Ausgabe] Der Vorgangstyp, z. B. „insert“, „update“ oder „delete“.
progress integer [Nur Ausgabe] Eine optionale Fortschrittsanzeige von 0 bis 100. Es gibt keine Voraussetzung, dass dies linear sein oder eine Granularität von Vorgängen unterstützen muss. Dies sollte nicht verwendet werden, um zu erraten, wann der Vorgang abgeschlossen ist. Diese Zahl sollte entsprechend dem Ablauf des Vorgangs kontinuierlich größer werden.
region string [Nur Ausgabe] Die URL des Bereichs, in dem sich der Vorgang befindet. Gilt nur für regionale Vorgänge.
startTime string [Nur Ausgabe] Der Zeitpunkt, zu dem dieser Vorgang durch den Server gestartet wurde. Dieser Wert hat das Textformat RFC3339.
status string [Nur Ausgabe] Der Status des Vorgangs. Mögliche Werte: „AUSFÜHREND“, „AUSGEFÜHRT“ oder „AUSGEFÜHRT“.
statusMessage string [Nur Ausgabe] Eine optionale Beschreibung des aktuellen Status des Vorgangs.
targetId unsigned long [Nur Ausgabe] Die eindeutige Ziel-ID, durch die eine bestimmte Inkarnation der Zielressource identifiziert wird.
user string [Nur Ausgabe] Der Nutzer, der den Vorgang angefordert hat, z. B. „nutzer@beispiel.de“.
warnings[] list [Nur Ausgabe] Wenn während der Verarbeitung dieses Vorgangs Warnmeldungen angezeigt werden, erfolgt eine Ausgabe in diesem Feld.
warnings[].code string [Nur Ausgabe] Ein Warncode, falls zutreffend. Zum Beispiel gibt Compute Engine NO_RESULTS_ON_PAGE zurück, wenn die Antwort keine Ergebnisse enthält.
warnings[].data[] list [Nur Ausgabe] Metadaten zu dieser Warnung im key: value-Format. Beispiel: 
"data": [ { "key": "scope", "value": "zones/us-east1-d" }
warnings[].data[].key string [Nur Ausgabe] Ein Schlüssel, der weitere Details zur zurückgegebenen Warnung enthält. Bei Warnungen, bei denen in einer Listenanfrage für eine bestimmte Zone keine Ergebnisse zurückgegeben werden, könnte dieser Schlüssel beispielsweise scope und der Schlüsselwert der Zonenname sein. Andere Beispiele sind ein Schlüssel, der auf eine veraltete Ressource und einen Ersetzungsvorschlag verweist, und eine Warnung zu ungültigen Netzwerkeinstellungen (wenn zum Beispiel in einer Instanz versucht wird, IP-Weiterleitung durchzuführen, ohne dass sie für IP-Weiterleitung aktiviert ist).
warnings[].data[].value string [Nur Ausgabe] Ein Warndatenwert entsprechend dem Schlüssel.
warnings[].message string [Nur Ausgabe] Eine für Menschen lesbare Beschreibung des Warncodes.
zone string [Nur Ausgabe] Die URL der Zone, in der sich der Vorgang befindet. Gilt nur für zonenspezifische Vorgänge.

Methoden

get
Ruft Informationen zu einem bestimmten Vorgang ab.
list
Listet alle Vorgänge für ein Projekt auf.