文档中心 > UploadPart
UploadPart

最近更新时间:2022-01-18

使用UploadPart接口在分片上传任务中上传一个片。

在你上传任一块之前你必须先要启动一个分块上传任务。在你发送一个启动请求后,每次上传块时,都需要将上传ID包含在请求中。

块的数量可以是1到10000中的任意一个(包含1和10000)。块序号用于标识一个块以及其在对象创建时的位置。如果你上传一个新的块,使用之前已经使用的序列号,那么之前的那个块将会被覆盖。除了最后一个块没有大小限制外,其余的块的大小均要求在100KB以上。该种方式最大支持48.8TB的对象。

为了保证数据在传输过程中没有损坏,请使用 Content-MD5 头部。当使用此头部时,KS3会自动计算出MD5,并根据用户提供的MD5进行校验,如果不匹配,将会返回错误信息。


注意:当启动分块上传后,并开始上传分块,您必须完成或者放弃上传任务,才能终止因为存储造成的收费。


请求

请求语法

PUT /ObjectName?partNumber=PartNumber&uploadId=UploadId HTTP/1.1

Host: examplebucket.region.unicloudsrv.com

Date: date

Content-Length: Size

Authorization: authorization string

请求参数

参数

描述

Content-Length

指明对象的大小,按字节。更多信息,请点击http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13

Content-MD5

base64加密MD5信息,128位,用于对象完整性校验。

Expect

当你使用 100-continue 时,直到收到确认时才会发送请求体。如果头部信息被拒绝,请求体不会被发送。

示例

请求示例

PUT /my-movie.m2ts?partNumber=1&uploadId=VCVsb2FkIElEIGZvciBlbZZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZR HTTP/1.1

Host: examplebucket.region.unicloudsrv.com

Date:  Mon, 1 Nov 2010 20:34:56 GMT

Content-Length: 10485760

Content-MD5: pUNXr/BjKK5G2UKvaRRrOA==

Authorization: authorization string

 

***part data omitted**

  

HTTP/1.1 200 OK

Date:  Mon, 1 Nov 2010 20:34:56 GMT

ETag: "b54357faf0632cce46e942fa68356b38"

Content-Length: 0

Connection: keep-alive