REST Resource: projects.operations

Ressource: Betrieb

Diese Ressource stellt einen lang andauernden Vorgang dar, 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 desselben Dienstes eindeutig ist, der ihn ursprünglich zurückgibt. Wenn Sie die Standard-HTTP-Zuordnung verwenden, sollte der name ein Ressourcenname sein, der mit operations/{unique_id} endet.

metadata

object

Dienstspezifische Metadaten, die dem Vorgang zugeordnet sind. Es enthält normalerweise Fortschrittsinformationen und allgemeine Metadaten wie die Erstellungszeit. Einige Dienste stellen solche Metadaten möglicherweise nicht bereit. Jede Methode, die einen lang andauernden Vorgang zurückgibt, sollte gegebenenfalls den Metadatentyp dokumentieren.

Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld "@type" enthält einen URI, der den Typ identifiziert. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" } .

done

boolean

Wenn der Wert false ist, bedeutet dies, dass der Vorgang noch ausgeführt wird. Bei true ist der Vorgang abgeschlossen und es ist entweder error oder response verfügbar.

Union- result . Das Operationsergebnis, das entweder ein error oder eine gültige response sein kann. Wenn done == false , wird weder error noch response gesetzt. Wenn done == true , kann genau entweder error oder response festgelegt werden. Einige Dienste liefern möglicherweise nicht das Ergebnis. result kann nur eines der folgenden sein:
error

object ( Status )

Das Fehlerergebnis des Vorgangs im Falle eines Fehlers oder Abbruchs.

response

object

Die normale, erfolgreiche Reaktion des Vorgangs. Wenn die ursprüngliche Methode keine Erfolgsdaten zurückgibt, z. B. Delete , lautet die Antwort google.protobuf.Empty . Wenn die ursprüngliche Methode die Standardmethode Get / Create / Update ist, sollte die Antwort die Ressource sein. Bei anderen Methoden sollte die Antwort den Typ XxxResponse haben, wobei Xxx der ursprüngliche Methodenname ist. Wenn der ursprüngliche Methodenname beispielsweise TakeSnapshot() lautet, ist der abgeleitete Antworttyp TakeSnapshotResponse .

Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld "@type" enthält einen URI, der den Typ identifiziert. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" } .

Methoden

get

 Ruft den neuesten Status eines lang andauernden Vorgangs ab.