Initiate Multipart Upload
更新时间:2024-12-10 11:03:08
PDF
该 API 接口用于初始化一个分段上传。针对该请求,QingStor 对象存储会返回一个 Upload Id,用于后续上传分段时,标记该分段所属 Object。
使用须知
-
该操作要求请求者对指定的 Bucket 拥有可写权限。
-
若指定的 Bucket 被设置为匿名用户可写,则请求中可不携带用户认证信息;
-
若指定的 Bucket 被设置为匿名用户可写,但请求中仍然携带了用户认证信息,则 QingStor 对象存储仍然会对该用户进行认证,当 QingStor 对象存储认证该用户不拥有该 Bucket 的可写权限,该请求返回错误。
请求语法
POST /<object-name>?uploads HTTP/1.1
Host: <bucket-name>.<zone-id>.qsstor.com
Date: <date>
Authorization: <authorization-string>
请求参数
无。
请求消息头
请求消息体
无。
响应消息体
成功调用该 API 接口后,服务端会返回如响应示例中的 Json 消息体。该消息体各字段说明如下:
名称 | 类型 | 说明 |
---|---|---|
bucket |
String |
存储空间名称 |
key |
String |
对象名称 |
upload_id |
String |
分段上传 ID。用于唯一标识该分段上传过程,作为后续上传分段的参数。 |
错误码
错误码 | 错误描述 | HTTP 状态码 |
---|---|---|
OK |
成功 |
200 |
其他错误码可参考错误码列表。
示例
请求示例
POST /large-object?uploads HTTP/1.1
Host: mybucket.pek3a.qsstor.com
Date: Sun, 16 Aug 2015 13:25:10 GMT
Authorization: authorization string
响应示例
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"
}