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,则表示写入已完成。如果后续发送任何 WriteRequest,但 finishWrite 为 true,则会导致错误。

data

string (bytes format)

资源的一部分数据。对于任何给定的 WriteRequest,客户端可以将 data 留空。这样,客户端可以在服务运行某项操作以生成更多数据时通知服务请求仍有效。

使用 base64 编码的字符串。