UploadPart

更新时间:2023-08-17 17:36:19

1、多段上传任务创建后,用户可以通过指定多段上传任务号,通过上传段接口为特定的任务上传段,从客户端上传新数据。同一个对象的同一个多段上传任务在上传段时,上传的顺序对后续的合并操作没有影响,也即支持多个段并发上传。

2、上传段的编号有范围限制,其范围是[1,10000]。段编号是唯一确定一个段和合并段时所在的位置。如果上传了一个重复段编号的段,那之前上传的相同编号的段将被覆盖。段大小最小是5MB,但在进行合并段操作时,最后一个段的大小没有限制。

3、为了确保数据在传输过程不被破坏,可以加Content-MD5请求头部,系统就会校验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响应的上传id

请求头部

仅使用公共请求头部

请求主体

分片数据

响应语法

HTTP/1.1 status_code

x-wos-request-id: request id
Date: date
ETag: etagValue
Content-Length: length
Server: : WS-web-server

响应头部

仅使用公共响应头部

响应元素

特殊错误

Situation Http Status Error Code Message
签名中和URL中均只带同一个参数,uploadId或partNumber 400 Bad Request InvalidArgument Invalid Argument
签名中和URL中均带了uploadId/partNumber,且顺序一致,但是顺序不正常 400 Bad Request InvalidArgument Invalid Argument
partNumer>10000 400 Bad Request InvalidArgument Part number must be an integer between 1 and 10000
单次upload的partsize>=5G 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
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!