Object Storage Service:UploadPartCopy

Notes

To copy an object larger than 1 GB in size, call UploadPartCopy. For more information about how to copy objects smaller than 1 GB, see CopyObject.

When you call UploadPartCopy, take note of the following items:

• The source and destination buckets must be located in the same region.

• Before you call UploadPartCopy to upload a part, you must call InitiateMultipartUpload to obtain an upload ID issued by the Object Storage Service (OSS) server.

• If you specify the x-oss-server-side-encryption header when you call the InitiateMultipartUpload operation, the uploaded part is encrypted and the x-oss-server-side-encryption header is contained in the UploadPart response header. The value of the x-oss-server-side-encryption header indicates the server-side encryption algorithm of the part. For more information, see InitiateMultipartUpload.

• In a multipart upload task, each part must be larger than 100 KB in size, except the last part. The size of a part is not verified when you call UploadPart because not all parts are uploaded and OSS does not know which part is the last part. The size of each part is verified only when you call CompleteMultipartUpload.

Permissions

By default, an Alibaba Cloud account has full permissions on resources in the account. In contrast, RAM users and RAM roles associated with an Alibaba Cloud account initially have no permissions. To manage resources by using a RAM user or role, you must grant the required permissions via RAM policies or Bucket policies.

Versioning

If versionId is not specified and the current version of the source object is a delete marker, OSS returns 404 Not Found. If versionId is specified in the request and the specified version of the source object is a delete marker, OSS returns 400 Bad Request.

Syntax

PUT /ObjectName?partNumber=PartNumber&uploadId=UploadId  HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Length: Size
Authorization: SignatureValue
x-oss-copy-source: /SourceBucketName/SourceObjectName
x-oss-copy-source-range: bytes=first-last

Request headers

The following table describes the request headers in a UploadPartCopy request except common request headers.

The following table describes request headers that are used for the source object specified by x-oss-copy-source.

Examples

• Sample request

  PUT /multipart.data?partNumber=1&uploadId=0004B9895DBBB6EC98E36  HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Content-Length: 6291456
  Date: Wed, 22 Feb 2012 08:32:21 GMT
  Authorization: OSS qn6q**************:77Dv****************
  x-oss-copy-source: /oss-example/src-object
  x-oss-copy-source-range: bytes=100-6291756

  Sample success response

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Connection: keep-alive
  x-oss-request-id: 3e6aba62-1eae-d246-6118-8ff42cd0****
  Date: Thu, 17 Jul 2014 06:27:54 GMT
  
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyPartResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
      <LastModified>2014-07-17T06:27:54.000Z </LastModified>
      <ETag>"5B3C1A2E053D763E1B002CC607C5****"</ETag>
  </CopyPartResult>

• Sample request for specifying versionId in an UploadPartCopy request

  PUT /multipart.data?partNumber=2&uploadId=63C06A5CFF6F4AE4A6BB3AD7F01C****  HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 07:01:56 GMT
  Authorization: OSS qn6q**************:77Dv****************
  x-oss-copy-source: /oss-example/src-object?versionId=CAEQMxiBgMC0vs6D0BYiIGJiZWRjOTRjNTg0NzQ1MTRiN2Y1OTYxMTdkYjQ0****

  Sample success response

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Connection: keep-alive
  x-oss-copy-source-version-id: CAEQMxiBgMC0vs6D0BYiIGJiZWRjOTRjNTg0NzQ1MTRiN2Y1OTYxMTdkYjQ0****
  x-oss-request-id: 5CAC4364B7AEADE017000660
  Date: Tue, 09 Apr 2019 07:01:56 GMT
  
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyPartResult>
    <LastModified>2019-04-09T07:01:56.000Z</LastModified>
    <ETag>"25A9F4ABFCC05743DF6E2C886C56****"</ETag>
  </CopyPartResult>

OSS SDKs

ossutil

For information about the ossutil command that corresponds to the UploadPartCopy operation, see upload-part-copy.

Error codes