此接口与普通桶的 AppendObject 类似,但仅支持从对象的尾部位置起追加写,不支持通过 ModifyObject 创建对象。此外,ModifyObject 不区分对象类型,普通对象和分片上传对象均支持追加写。
请求消息样式
POST /objectName?modify&offset=Offset HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string <modify data>
该请求使用的公共请求消息头,请参见公共参数。
名称 | 位置 | 参数类型 | 是否必选 | 示例值 | 说明 |
---|---|---|---|---|---|
modify | Query | String | 是 | 代表 ModifyObject 请求的特殊标识。 | |
offset | Query | Integer | 是 | 0 | 指定从何处进行追加。追加成功后,响应消息中的 x-tos-next-modify-offset 头域会带上下一次追加的 offset。 |
x-tos-traffic-limit | Header | String | 否 | 819200 | TOS 提供单链接限速功能,在上传、下载文件等操作中进行流控控制,以保证其他应用的网络带宽。取值说明如下:
|
x-tos-traffic-limit | Query | String | 否 | 819200 | TOS 提供单链接限速功能,在上传、下载文件等操作中进行流控控制,以保证其他应用的网络带宽。取值说明如下:
|
该请求中无请求消息元素,请求体中带的是修改写对象的数据内容。
该请求返回的公共响应消息头,请参见公共参数。
名称 | 参数类型 | 说明 |
---|---|---|
x-tos-next-modify-offset | Integer | 下一次追加写对象的 offset。 |
x-tos-hash-crc64ecma | Integer | 表示该对象的 64 位 CRC 值。该 64 位 CRC 根据 ECMA-182 标准计算得出。 |
该请求响应中无消息元素。
POST /objectName?modify&offset=0 HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 GMT Authorization: authorization string
HTTP/1.1 200 OK x-tos-id-2: 5726ce090a2d002d-a444ed0 x-tos-request-id: 5726ce090a2d002d-a444ed0 Date: Thu, 20 Jun 2024 07:59:37 GMT server: TosServer Content-Length: 0 x-tos-next-modify-offset: 4379329 x-tos-hash-crc64ecma: 6186290338114851376 ETag: "96e79218965eb72c92a549dd5a330112"