分片上传中上传单个分片。您必须初始化一个新的分片上传事件。在初始化请求中,OSS将会返回作为唯一标识符的Upload ID,您的上传分片请求中需包含该ID。
分片编号是1-10000的任何数字,分片号是一个分片的唯一标识,同时也是该分片在整个Object中的位置标识。
为了确保数据在传输过程中未损坏,可以在上传分片请求中指定Content-MD5,OSS将根据MD5值检查分片数据,如果不匹配,将会返回错误。
注:初始化分片上传后并上传一个或多个分片后,OSS会对分片所占的存储空间按量收费,您必须完成或者终止分片上传后才可停止OSS对分片的存储费用。
PUT /ObjectName?partNumber=PartNumber&uploadId=UploadId HTTP/1.1 Host: <Bucket>.s3.<region>.jdcloud-oss.com Date: <date> Content-Length: <Size> Authorization: <authorization string>
名称 | 描述 | 必须 |
---|---|---|
partNumber | 分片编号,分片号是一个分片的唯一标识,同时也是该分片在整个Object中的位置标识。 Type: String |
是 |
uploadId | 上传ID,初始化分片上传请求中返回的作为唯一标识符的Upload ID。 Type: String |
是 |
除公用请求Header外,还可使用以下Header。
名称 | 描述 | 必须 |
---|---|---|
Content-Length | Object的大小,单位为byte;更详细描述请参照RFC2616。 Type: String Default: None Constraints: None |
是 |
Content-MD5 | 对报文主体进行MD5算法获得128位二进制数,在通过Base64编码写入Content-MD5。可用于数据完整性检查。 Type: String Default: None Constraints: None |
否 |
Expect | 客户端使用Expect告知OSS,期望出现某种特定的行为。若OSS无法做出回应而发生错误时,请求报文主体将不会发送。 Type: String Default: None Valid Values: 100-continue Constraints: None |
否 |
无请求元素
除了通用响应Header外,还包括以下响应Header。
名称 | 描述 |
---|---|
x-amz-storage-class | Object的存储类型。OSS为非标准存储的Object返回该Header。 Type: String Default: None |
无响应元素
Error Code | 描述 | HTTP Status Code | SOAP Fault Code Prefix |
---|---|---|---|
NoSuchUpload | 指定的分片上传不存在。Upload ID可能是无效的。 | 404 Not Found | Client |
PUT /my-movie.m2ts?partNumber=1&uploadId=VCVsb2FkIElEIGZvciBlbZZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZR HTTP/1.1 Host: oss-example.s3.<region>.jdcloud-oss.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 x-amz-request-id: 656c76696e6727732072657175657374 Date: Mon, 1 Nov 2010 20:34:56 GMT ETag: "b54357faf0632cce46e942fa68356b38" Content-Length: 0 Connection: keep-alive Server: JDCloudOSS