WriteRequest

ByteStream.Write 的请求对象。

JSON 表示法
{
  "resourceName": string,
  "writeOffset": string,
  "finishWrite": boolean,
  "data": string
}
字段
resourceName

string

要写入的资源的名称。每个 Write() 操作的第一个 WriteRequest 都必须设置此属性。如果在后续调用中设置此属性,则必须与第一个请求的值匹配。

writeOffset

string (int64 format)

应写入数据时的资源开头偏移量。所有 WriteRequest 都必须提供该字段。

Write() 操作的第一个 WriteRequest 中,表示 Write() 调用的初始偏移量。该值必须等于对 QueryWriteStatus() 的调用返回的 committedSize

在后续调用中,此值必须设置并且必须等于第一个 writeOffset 以及之前在此数据流中发送的所有 data 软件包的大小总和。

错误的值将导致错误。

finishWrite

boolean

如果为 true,则表示写入已完成。在 finishWritetrue 之后发送任何 WriteRequest 都会导致错误。

data

string (bytes format)

资源的数据的一部分。对于任何给定的 WriteRequest,客户端可以data 留空。这使客户端能够在该服务执行操作以生成更多数据时通知服务仍存在该请求。

使用 base64 编码的字符串。