You need to enable JavaScript to run this app.
导航
ModifyObject
最近更新时间:2024.08.01 17:45:48首次发布时间:2024.07.08 16:10:14

功能描述

此接口与普通桶的 AppendObject 类似,但仅支持从对象的尾部位置起追加写,不支持通过 ModifyObject 创建对象。此外,ModifyObject 不区分对象类型,普通对象和分片上传对象均支持追加写。

使用说明

  • 目前该接口仅在分层目录桶支持。
  • 暂只支持从对象尾部位置起进行修改写。
  • 单次追加上传的数据量不超过 5GiB,追加后对象大小不超过 48.8TiB。
  • ModifyObject 接口不支持使用服务端加密。
  • 建议您不要并发执行 Modify 操作,否则可能会导致执行失败。
  • 不支持通过 ModifyObject 创建对象。
  • 修改写不支持chunk模式上传数据。
  • 对象成功执行修改写以后,HeadObject和GetObject的响应头域Etag变为该对象的64 位 CRC 值。
  • 不支持对目录进行修改写。

请求消息样式

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 提供单链接限速功能,在上传、下载文件等操作中进行流控控制,以保证其他应用的网络带宽。取值说明如下:

  • 取值范围:245760-838860800,单位为bit/s
  • Header和Query中不能同时存在此参数

x-tos-traffic-limit

Query

String

819200

TOS 提供单链接限速功能,在上传、下载文件等操作中进行流控控制,以保证其他应用的网络带宽。取值说明如下:

  • 取值范围:245760-838860800,单位为bit/s
  • Header和Query中不能同时存在此参数

请求元素

该请求中无请求消息元素,请求体中带的是修改写对象的数据内容。

响应消息头

该请求返回的公共响应消息头,请参见公共参数

名称

参数类型

说明

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"