帮助与文档

我们为你提供丰富、详尽的使用指南以及产品文档

Upload Object Part

用于上传一个分段,请求参数需要携带初始化分段上传阶段得到的 Upload ID。该请求需要对存储空间有可写权限。

关于分段大小的规定,请参看 分段上传限制

如果存储空间被设置为对匿名用户可写,则请求不需要携带认证信息。然而如果携带了认证信息,但是认证用户不拥有该存储空间的可写权限,则请求该接口会返回权限错误。

Request Syntax

PUT /<object-name>?upload_id=<upload-id>&part_number=<part-number> HTTP/1.1
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

Request Parameters

Name Type Description Required
upload_id String 初始化分段上传时,响应消息体里返回的 upload_id Yes
part_number Integer 分段序号,合并时需按照序号从小到大顺序,数值必须大于等于0 Yes

Request Headers

Header Name Type Description Required
Content-Length String 对象实体的大小 Yes
Content-MD5 String 分段实体的预期 MD5 值,用于检查对象在传输过程中字符是否出错或被篡改 No
Expect String 如果请求头附加这个参数,不需要附带 request body,对象存储服务端判断可以接受此请求,则返回 100 CONTINUE No

参见公共请求头

对象加密,参见数据加密请求头

Request Elements

分段内容实体

Response Headers

参见公共响应头

若对象被加密,服务端将返回加密响应头, 具体请参见数据加密请求头

Response Elements

没有响应消息体

Example

Example Request

PUT /large-object?upload_id=4d26b37a469230619604ecdc0e314782&part_number=0 HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Length: 7987
Authorization: authorization string
[7987 bytes of object data]

Example Response

HTTP/1.1 201 CREATED
Server: QingStor
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Length: 0
Connection: close
x-qs-request-id: 37fed66c441a11e5b95f52542e6ce14b