REST-Ressource: projects.locations.operations

Ressource: Vorgang

Diese Ressource steht für einen lange laufenden Vorgang, der das Ergebnis eines Netzwerk-API-Aufrufs ist.

JSON-Darstellung

{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // Union field result can be only one of the following:
  "error": {
    object(Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field result.
}
Felder
name

string

Der vom Server zugewiesene Name, der nur innerhalb des Dienstes eindeutig ist, der ihn ursprünglich zurückgibt. Falls Sie die Standard-HTTP-Zuordnung nutzen, sollte der name folgendes Format haben: operations/some/unique/name.

metadata

object

{

createTime: Zeitpunkt der Erstellung des Vorgangs.

endTime: Zeitpunkt, zu der die Ausführung des Vorgangs abgeschlossen war.

target: Serverdefinierter Ressourcenpfad für das Ziel des Vorgangs.

verb: Name des vom Vorgang ausgeführten Verbs.

statusDetail: Lesbarer Status des Vorgangs, falls vorhanden.

cancelRequested: Gibt an, ob der Nutzer einen Abbruch angefordert hat. Vorgänge, die erfolgreich abgebrochen wurden, haben den Wert Operation.error mit einem google.rpc.Status.code von 1, was Code.CANCELLED entspricht.

apiVersion: Zum Starten des Vorgangs verwendete API-Version.

}

done

boolean

Ist der Wert false, heißt das, dass der Vorgang noch läuft. Beim Wert true ist der Vorgang abgeschlossen und es stehen die Optionen error oder response zur Verfügung.

Union-Feld result: Das Ergebnis des Vorgangs kann entweder ein error oder eine gültige response sein. Wenn done == false, ist weder error noch response festgelegt. Wenn done == true ist, gilt entweder error oder response. result kann jeweils nur Folgendes sein:
error

object(Status)

Das Fehlerergebnis des Vorgangs im Fall eines Fehlers oder Abbruchs.

response

object

Die normale Antwort des Vorgangs im Erfolgsfall. Falls die ursprüngliche Methode im Erfolgsfall keine Daten zurückgibt, wie z. B. Delete, lautet die Antwort google.protobuf.Empty. Ist die ursprüngliche Methode standardmäßig Get/Create/Update, sollte die Antwort die Ressource sein. Bei anderen Methoden sollte die Antwort vom Typ XxxResponse sein, wobei Xxx der Name der ursprünglichen Methode ist. Wenn zum Beispiel der Name der ursprünglichen Methode TakeSnapshot() ist, ist der gefolgerte Antworttyp TakeSnapshotResponse.

Methoden

cancel

Startet den asynchronen Abbruch eines lang andauernden Vorgangs.

delete

Löscht einen lang andauernden Vorgang.

get

Ruft den letzten Status eines lang andauernden Vorgangs ab.

list

Listet Vorgänge, die zu dem angegebenen Filter in der Anfrage passen, auf.