InitiateMultipartUpload
更新时间：2025-08-18 15:53:59
在使用分段上传时，需首先调用Initiate Multipart Upload接口来创建任务，系统会返回一个全局唯一的分段上传任务编号 uploadId，作为任务标识。后续用户可基于此标识进行分段上传、合并分段、列举分段等相关操作。相同对象可同时存在多个分段上传任务；每个分段上传任务初始化时可附加额外的消息头信息。
需要拥有 IAM wos:PutObject 权限。
请求语法
POST /ObjectName?uploads HTTP/1.1
Host: Bucket.Endpoint
Date: date
Authorization: authorization
Cache-Control: CacheControl
Content-Disposition: ContentDisposition
Content-Encoding: ContentEncoding
Content-Language: ContentLanguage
Content-Length: ContentLength
Content-MD5: ContentMD5
Content-Type: ContentType
Expires: Expires
URI请求参数
无
请求头
除了使用公共请求头，还支持：
| 参数 | 描述 | 是否必填 |
|---|---|---|
| Content-MD5 | 原始数据的MD5，如果数据在传输过程中损坏且MD5不一致，将响应403 SignatureDoesNotMatch | 否 |
| x-wos-storage-class | 决定文件的存储类型，Standard-标准存储, IA-低频存储, Archive-归档存储。默认采用空间内的默认存储类型 | 否 |
| x-wos-meta-* | 客户自定义元数据，在 headObject 和 getObject 时按原样返回 | 否 |
请求体
无
响应语法
HTTP/1.1 status_code
x-wos-request-id: request id
Date: date
Content-Length: length
Connection: status
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<InitiateMultipartUploadResult xmlns="https://www.wangsu.com/document">
<Bucket>BucketName</Bucket>
<Key>ObjectName</Key>
<UploadId>uploadID</UploadId>
</InitiateMultipartUploadResult>
响应头
仅使用公共响应头。
响应元素
| 元素名称 | 描述 |
|---|---|
| InitiateMultipartUploadResult | 描述分段上传任务的容器 类型：XML 子节点：Bucket、Key、UploadId 父节点：空 |
| Bucket | 分段上传对象所在空间的名称 类型：string 父节点：InitiateMultipartUploadResult |
| Key | 分段上传对象的 key 类型：string 父节点：InitiateMultipartUploadResult |
| UploadId | 分段上传的id，后续进行分段操作时需要用该id指定对应任务 类型：string 父节点：InitiateMultipartUploadResult |
特殊错误
| 情况 | Http状态 | 错误代码 | 描述 |
|---|---|---|---|
| 签名有 uploads，但URL未携带uploads；或URL有uploads，签名未携带uploads | 403 Forbidden | SignatureDoesNotMatch | The request signature we calculated does not match the signature. |
| 签名有uploads，但URL中uploads不合法（如拼写错误）；或URL有uploads但签名uploads不合法（如拼写错误） | 403 Forbidden | SignatureDoesNotMatch | The request signature we calculated does not match the signature you provided. |
| 签名和URL都包含uploads，但拼写不一致 | 403 Forbidden | SignatureDoesNotMatch | The request signature we calculated does not match the signature you provided. |
示例
POST /objectkey?uploads HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
Date: Mon, 1 Apr 2017 20:34:56 GMT
Authorization: WOS AKIAIOSFODNN7EXAMPLE:VGhpcyBtZXNzYWdlIHNpZ25lZGGieSRlbHZpbmc=
HTTP/1.1 200 OK
x-wos-request-id: 996c76696e6727732072657175657374
Date: Mon, 1 Apr 2017 20:34:56 GMT
Content-Length: 146
Connection: keep-alive
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<InitiateMultipartUploadResult xmlns="https://www.wangsu.com/document">
<Bucket>bucket01</Bucket>
<Key>objectkey</Key>
<UploadId>DCD2FC98B4F70000013DF578ACA318E7</UploadId>
</InitiateMultipartUploadResult>
本篇文档内容对您是否有帮助？
有帮助
我要反馈