帮助与文档

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

Complete Multipart Upload

当分段上传完毕,需要发送此请求结束此分段上传,从而获得一个完整的对象。未调用此接口,分段上传处于未完成的状态,此时调用 GET 请求获得该对象会返回错误。该请求需要对存储空间有可写权限。

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

Request Syntax

POST /<object-name>?upload_id=<upload-id> HTTP/1.1
Host: <bucket-name>.pek3a.qingstor.com
Date: <date>
Authorization: <authorization-string>

Request Parameters

Name Type Description Required
upload_id String 初始化分段上传时,响应消息体里返回的 upload_id Yes

Request Headers

参见公共请求头

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

Name Type Description Required
ETag String 分段上传合并后的对象,因为读取大文件全部内容所需要时间较长,为了避免阻塞,对象存储服务不会自动为合并后的文件计算 ETag 值,需要用户自行在调用此接口时设置,该值会在调用 HEAD object 接口时,通过响应头返回。该值请使用 HTTP 规范所规定的格式 https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.19 No

Request Body Elements

请求内容为一个json结构,参看下面的 Example。

part_number 不一定需要连续,但需要递增。允许在最终合并的分段对象排除掉某些已上传分段。

Name Type Description
object_parts List 消息体顶层, 需要按照 part_number 递增排序
part_number Integer 分段序号, 大于等于0
etag String 可选,对该分段内容的校验码

Response Headers

参见公共响应头

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

Response Elements

没有响应消息体

Example

Example Request

POST /large-object?upload_id=4d26b37a469230619604ecdc0e314782 HTTP/1.1
Host: mybucket.<zone-id>.qingstor.com
Date: Sun, 16 Aug 2015 13:25:10 GMT
Authorization: authorization string
ETag: "0c2f573d81194064b129e940edcefe9b"

{
    "object_parts": [
        {"part_number": 0, "etag": "c837682353601f7fc0a2ccb6bc8f4654"},
        {"part_number": 2, "etag": "28e2c0c6574a1ef20ac41d16a012a7c1"}
    ]
}

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