用户可以调用该 API 接口以追加写的方式上传对象到 QingStor 对象存储。通过该接口创建的 Object 类型为 appendable

使用限制

  • 每次追加写的数据不能超过 5 GB,Object 的总大小不能超过 50 TB;

  • appendable 类型的 Object 不支持被追加写;

  • appendable 类型的 Object 不支持加密;

请求语法

POST /<object-name>?append&position=<position> HTTP/1.1
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

请求参数

调用该接口时,可在 URL 中添加如下参数:

名称 类型 说明 是否必选

append

String

表示以追加写的方式上传 Object

position

Integer

用于指定追加写的位置。首次调用该接口时,指定该值 0,后续调用该接口追加写时,指定该值为前一次返回结果中的 x-qs-next-append-position 值。

请求消息头

名称 类型 说明 是否必选

Content-Length

String

本次追加写入的数据的大小。

Content-Type

String

Object 类型,首次写入时需指定。

Content-MD5

String

本次追加写入的数据的 MD5 值,用于检查数据在传输过程中是否出错或被篡改。

x-qs-storage-class

String

指定该对象的存储级别,首次写入时需指定。默认值为 STANDARD。可选值为:

  • STANDARD 表示标准存储;

  • STANDARD_IA 表示低频存储。

除以上请求头以外,此接口还需要包含 Host、Date 等公共请求头。详细内容可参见公共请求头

请求消息体

无。

响应头

调用该接口后,QingStor 对象存储会返回如下自定义响应头:

名称 类型 说明 是否必选

x-qs-next-append-position

Interger

即当前 Object 大小。作为下一次追加写请求参数 position 的值。

除以上响应头以外,其他公共响应头可参考:公共响应头

错误码

成功则返回 200,失败的返回码参考错误码列表

示例

请求示例

POST /obj-append?append&position=0 HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Dec, 16 Aug 2019 09:05:00 GMT
Content-Length: 1024
Authorization: authorization string
[1024 bytes of object data]

响应示例

HTTP/1.1 200 OK
Server: QingStor
Date: Dec, 16 Aug 2019 09:05:00 GMT
Content-Length: 0
Connection: close
x-qs-request-id: 3f2cf9ac3168744d
x-qs-next-append-position: 1024

SDK

此接口所对应的各语言 SDK 可参考 SDK 文档