Object Storage Service


Object Storage Service

Upload Part-Copy


Replicate existed Objects as the source data multipart upload. You can specify source data through x-amz-copy-source Header, and the x-amz-copy-source-range request Header specifies data range. Before uploading multiparts, a multipart upload must be started,and at this moment OSS will return an Upload ID, you must include the ID in the multipart upload request.



PUT /ObjectName?partNumber=PartNumber&uploadId=UploadId HTTP/1.1
Host: <target-bucket>.s3.<region>.jdcloud-oss.com
x-amz-copy-source: /source_bucket/sourceObject
Date: <date>
Authorization: <authorization string>

Request Parameter

Name Description Must
partNumber Multipart Number, which is the unique identifier of a multipart and also is the location identifier of the multipart in the whole Object.
Type: String
uploadId Upload ID, which is the unique identifier returned in the initialization multipart upload request.
Type: String

Request Header

Except public request Headers, the following Headers also can be used

Name Description Must
x-amz-copy-source Source Bucket and source Object are separated by "/".
Type: String
Default: None
x-amz-copy-source-range The Data Range of Source Object.
Type: Integer
Default: None

Request Elements

No Request Elements


Response Header

No Special Response Header

Response Element

Name Description
CopyPartResult Response Element Set.
Type: Container
Ancestor: None
ETag Return ETag of new multipart.
Type: String
Ancestor: CopyPartResult
LastModified Return the modification time of multiparts.
Type: String
Ancestor: CopyPartResult

Special Error

Error Code Description HTTP Status Code
NoSuchUpload Specified multipart upload ID is absent, which may be invalid. 404 Not Found
InvalidRequest Specified replication source does not support Range replication. 400 Bad Request


Request Example

PUT /newobject?partNumber=2&uploadId=VCVsb2FkIElEIGZvciBlbZZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZR HTTP/1.1
Host: target-bucket.s3.<region>.jdcloud-oss.com
Date:  Mon, 11 Apr 2011 20:34:56 GMT
x-amz-copy-source: /source-bucket/sourceobject
Authorization: <authorization string>

Response Example

HTTP/1.1 200 OK
x-amz-request-id: 656c76696e6727732072657175657374
Date:  Mon, 11 Apr 2011 20:34:56 GMT
Server: JDCloudOSS 

Update Time:2019-05-28 16:47:17