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. Dies muss am ersten WriteRequest jeder Write()-Aktion festgelegt werden. Wird er bei nachfolgenden Aufrufen festgelegt, muss er mit dem Wert der ersten Anfrage übereinstimmen.

writeOffset

string (int64 format)

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

In der ersten WriteRequest einer Write()-Aktion gibt er 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ößen aller data-Bundles entsprechen, die zuvor über diesen Stream gesendet wurden.

Ein falscher Wert führt zu einem Fehler.

finishWrite

boolean

Wenn true, zeigt dies an, dass der Schreibvorgang abgeschlossen ist. Werden WriteRequests nach einem finishWrite-Tag gesendet, in dem true steht, wird ein Fehler verursacht.

data

string (bytes format)

Ein Teil der Daten für die Ressource. Der Client kann data für WriteRequest leer lassen. Dadurch kann der Client dem Dienst mitteilen, dass die Anfrage noch aktiv ist, während ein Vorgang zum Generieren weiterer Daten ausgeführt wird.

Ein base64-codierter String.