更新时间:2025-08-18 15:54:01
在创建多段上传任务后,用户可通过指定多段上传任务编号,从客户端上传新数据,即通过上传分片接口为指定任务进行分片上传。同一对象的同一个多段上传任务各分片上传顺序不会影响后续的合并操作,即支持分片的并发上传。
上传分片的编号有范围限制,取值为[1,10000]。分片编号是确定分片及其在合并时位置的唯一方式。如果上传了重复编号的分片,则已上传的同编号分片会被覆盖。每个分片的最小尺寸为5MB,但最后一片合并时大小无限制。
为确保数据在传输过程中的完整性,可在请求头中增加 Content-MD5,系统将校验MD5,如校验出错,WOS会给出错误提示。
注意:如果创建了多段任务并上传了一段或多段分片,只有在合并分片或者取消多段任务后,所占用的存储空间才会被释放,否则占用空间不会释放。
PUT /ObjectName?partNumber=partNum&uploadId=uploadId HTTP/1.1
Host: Bucket.Endpoint
Date: date
Content-Length: Size
Authorization: authorization
Content-MD5: md5
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| partNumber | 上传分片编号,取值范围[1,10000] | 是 |
| uploadId | Initiate Multipart Upload响应返回的upload id | 是 |
仅使用公共请求头。
分片数据
HTTP/1.1 status_code
x-wos-request-id: request id
Date: date
ETag: etagValue
Content-Length: length
Server: WS-web-server
仅使用公共响应头。
无
| 情况 | Http状态 | 错误码 | 描述 |
|---|---|---|---|
| 签名和URL中均只带同一个参数(uploadId或partNumber) | 400 Bad Request | InvalidArgument | Invalid Argument |
| 签名及URL中同时带有uploadId/partNumber,顺序相同但不规范 | 400 Bad Request | InvalidArgument | Invalid Argument |
| partNumber > 10000 | 400 Bad Request | InvalidArgument | Part number must be an integer between 1 and 10000 |
| 单次上传的分块大小≥5GB | 400 Bad Request | EntityTooLarge | Your proposed upload exceeds the maximum allowed object size |
PUT /ObjectName?partNumber=1&uploadId=VCVsb2FkIElEIGZvciBlbZZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZR HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 1048596
Authorization:WOS 14RZT432N80TGDF2Y2G2:8se2hm3YLchJhuPMDrybeITcuo0=
Content-MD5:q3q7DaS8pTI6thGbtdzSlg==
HTTP/1.1 200 OK
x-wos-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
ETag: "b54357faf0632cce46e942fa68356b38"
Content-Length: 1048596
Server:WCS-web-server