Upload Part

2023-02-19 21:14:02

Upload Part

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

段大小范围是[5MB,50MB],但在进行合并段操作时,最后一个段的大小范围为[0,50MB]。上传的段的编号也有范围限制,其范围是[1,10000]。

请求语法

PUT /Key+?partNumber=PartNumber&uploadId=UploadId HTTP/1.1
Host: Bucket.s3-us-east-1.ossfiles.com
Content-Length: ContentLength
Content-MD5: ContentMD5

URI 请求参数

名称 描述 类型
Bucket 存储桶名称 字符串
partNumber 上传段的段号。取值为从1到10000的整数。 整数型
uploadId 多段上传任务Id。 字符串

请求消息头

该请求没有请求消息头。


请求正文

该请求接受二进制数据。


请求元素

该请求没有请求元素。


响应语法

该请求没有响应正文。


响应元素

该请求没有响应元素。


响应消息头

名称 描述 类型
ETag 多段上传对象所在桶的桶名。 字符串

示例

请求示例

PUT /example-object?partNumber=1&uploadId=656c76696e6727732072657175657374 HTTP/1.1
Host: bucket.s3-us-east-1.ossfiles.com
Authorization: authorization string   
Date: Tue, 17 Jan 2023 06:36:17 GMT

Body

返回示例

HTTP/1.1 200 OK
x-amz-id-2: 656c76696e6727732072657175657374656c76696e6727732072657175657374
x-amz-request-id: 656c76696e6727732072657175657374
Date: Tue, 17 Jan 2023 06:36:17 GMT
ETag: "7e10e7d25dc4581d89b9285be5f384fd"