UploadPart

更新时间:2025-08-18 15:54:01

上传任务说明

  1. 在创建多段上传任务后,用户可通过指定多段上传任务编号,从客户端上传新数据,即通过上传分片接口为指定任务进行分片上传。同一对象的同一个多段上传任务各分片上传顺序不会影响后续的合并操作,即支持分片的并发上传。

  2. 上传分片的编号有范围限制,取值为[1,10000]。分片编号是确定分片及其在合并时位置的唯一方式。如果上传了重复编号的分片,则已上传的同编号分片会被覆盖。每个分片的最小尺寸为5MB,但最后一片合并时大小无限制。

  3. 为确保数据在传输过程中的完整性,可在请求头中增加 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

URI请求参数

参数名 描述 是否必填
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

本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!