对象存储 > API 文档 > Object 接口 > 分片上传 v2 版 > 初始化任务

初始化任务

最近更新时间: 2024-06-04 19:08:01

描述

使用 Multipart Upload 方式上传数据前，必须先调用 API 来获取一个全局唯一的 UploadId ，后续的块数据通过 uploadPart API 上传，整个文件完成 completeMultipartUpload API ，已经上传块的删除 abortMultipartUpload API 都依赖该 UploadId 。

请求

请求语法

POST /buckets/<BucketName>/objects/<EncodedObjectName>/uploads HTTP/1.1
Host: <UpHost>
Authorization: UpToken <UploadToken>

使用说明：

初始化 Multipart Upload 请求，并不会影响已存在的同名 Object 。
同一个 Object 可以同时拥有不同的 UploadId 。

请求参数

参数名称	必填	说明
BucketName	是	空间名称
EncodedObjectName	否	资源名，EncodedObjectName 需要经过 Base64 编码，如果表示不设置可以使用特殊字符 `~` 。具体可以参照：URL 安全的 Base64 编码

请求头

头部名称	必填	说明
Host	是	上传域名。对象存储支持的区域和对应区域上传域名列表见存储区域列表
Authorization	是	该参数应严格按照上传凭证格式进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于 Authorization: UpToken QNJi_bYJlmO5LeY08FfoNj9w_r…

请求内容

该请求操作的请求体为空。

响应

响应头

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅公共响应头。

响应内容

名称	类型	说明
uploadId	string	初始化文件生成的 id
expireAt	int64	UploadId 的过期时间 Unix 时间戳，过期之后 UploadId 不可用，固定 7 天有效期，过期后会删除未完成文件上传的块数据

响应状态码

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅错误响应。

示例

请求示例

POST /buckets/myBucket/objects/bXlPYmplY3Q=/uploads HTTP/1.1
Host: up.qiniup.com
User-Agent: Go-http-client/1.1
Authorization: UpToken j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:nP7NSSyGo4x3W_nJ8T9X1gJrgpk=

响应示例

HTTP/1.1 200 OK
Content-Length: 2
Connection: keep-alive
Content-Type: application/json
Date: Wed, 18 Dec 2019 17:02:11 GMT
Server: nginx
X-Reqid: SFkAAAC8BDebTtsU

{
	 "uploadId": "5df9ea14834c512b2270234e",
	 "expireAt": 1576659776
}

以上内容是否对您有帮助？