WriteRequest

Anfrageobjekt für ByteStream.Write.

JSON-Darstellung
{
  "resourceName": string,
  "writeOffset": string,
  "finishWrite": boolean,
  "data": string
}
Felder
resourceName

string

Der Name der zu schreibenden Ressource. Er muss beim ersten WriteRequest jeder Write()-Aktion festgelegt werden. Wenn sie für nachfolgende Aufrufe festgelegt wird, muss sie dem Wert der ersten Anfrage entsprechen.

writeOffset

string (int64 format)

Der Offset vom Anfang der Ressource, an der die Daten geschrieben werden sollen. Er ist für alle WriteRequest erforderlich.

In der ersten WriteRequest einer Write()-Aktion gibt sie den anfänglichen Offset für den Write()-Aufruf an. Der Wert muss dem committedSize entsprechen, den ein Aufruf von QueryWriteStatus() zurückgeben würde.

Bei nachfolgenden Aufrufen muss dieser Wert festgelegt werden und muss der Summe der ersten writeOffset und der Größe aller data-Bundles entsprechen, die zuvor in diesem Stream gesendet wurden.

Ein falscher Wert führt zu einem Fehler.

finishWrite

boolean

Der Wert true gibt an, dass der Schreibvorgang abgeschlossen ist. Das Senden von WriteRequesten nach einem, in dem finishWrite true ist, führt zu einem Fehler.

data

string (bytes format)

Ein Teil der Daten für die Ressource. Der Client darf data für einen bestimmten WriteRequest leer lassen. Der Client kann dem Dienst so mitteilen, dass die Anfrage noch aktiv ist, während ein Vorgang ausgeführt wird, um mehr Daten zu generieren.

Ein base64-codierter String.