帮助与文档

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

Initiate Multipart Upload

用于初始化一个分段上传,该请求会返回一个Upload ID,后续在上传分段时,在请求参数中附加该 Upload ID,则表明分段属于同一个对象。该请求需要对存储空间有可写权限。

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

Request Syntax

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

Request Parameters

没有请求参数

Request Headers

参见公共请求头

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

如果给对象附带支持的标准 HTTP 头或自定义元数据,参见如何创建对象元数据

Header Name Type Description Required
Content-Type String 对象的类型 No

Request Elements

没有请求消息体

Response Headers

参见公共响应头

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

Response Elements

Name Type Description
bucket String 存储空间名称
key String 对象 key
upload_id String 分段上传 ID,此 ID 用于后续上传分段时,作为参数使用

Example

Example Request

POST /large-object?uploads HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 13:25:10 GMT
Authorization: authorization string

Example Response

HTTP/1.1 200 OK
Server: QingStor
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Type: application/json
Content-Length: 90
Connection: close
x-qs-request-id: 37fed66c441a11e5b95f52542e6ce14b

{
    "upload_id": "4d26b37a469230619604ecdc0e314782",
    "bucket": "mybucket",
    "key": "large-object"
}