Yandex.Cloud
  • Services
  • Why Yandex.Cloud
  • Pricing
  • Documentation
  • Contact us
Get started
Yandex Object Storage
  • Getting started
  • Step-by-step instructions
    • All instructions
    • Buckets
      • Creating a bucket
      • Deleting a bucket
      • Limiting the maximum size of a bucket
      • Allowing public access to a bucket
      • Bucket encryption
      • Managing object lifecycles
      • Managing CORS configurations
      • Editing a bucket ACL
      • Logging actions with the bucket
    • Objects
      • Uploading an object
      • Getting information about an object
      • Downloading an object
      • Getting a public link to an object
      • Deleting an object
      • Deleting a partially uploaded object
      • Editing an object ACL
    • Static website hosting
      • Hosting setup
      • Support for your own domain
      • Support for multiple domain names
      • Configuring HTTPS
  • Concepts
    • Overview
    • Bucket
    • Objects
    • Bucket versioning
    • Object lifecycles
    • CORS
    • Static website hosting
    • Pre-signed URLs
    • Multipart upload
    • Access control lists (ACLs)
    • Bucket Policy
    • Upload file via HTML form
    • Storage class
    • Logging actions with a bucket
    • Backups
    • TLS protocol
    • Quotas and limits
  • Tools
    • All tools
    • Console clients
      • AWS CLI
      • S3cmd
    • File browsers
      • CyberDuck
      • WinSCP
    • SDK
      • AWS SDK for Java
      • Python SDK (boto)
    • FUSE
      • s3fs
      • goofys
  • Amazon S3-compatible HTTP API
    • How to use the API
    • Signing requests
    • API reference
      • All services and methods
      • Bucket
        • All methods
        • create
        • getBucketEncryption
        • getMeta
        • listObjects
        • listBuckets
        • deleteBucket
        • deleteBucketEncryption
        • putBucketEncryption
        • putBucketVersioning
        • getBucketVersioning
        • putBucketLogging
        • getBucketLogging
        • listObjectVersions
      • Object
        • All methods
        • upload
        • get
        • copy
        • getObjectMeta
        • delete
        • deleteMultipleObjects
        • options
      • Multipart upload
        • General multipart upload procedure
        • startUpload
        • uploadPart
        • copyPart
        • listParts
        • abortUpload
        • completeUpload
        • listUploads
      • Static Website Hosting
        • All methods
        • upload
        • get
        • delete
        • Static website response codes
      • CORS
        • All methods
        • XML structure of CORS configuration
        • upload
        • get
        • delete
      • Lifecycles
        • All methods
        • XML structure of lifecycle configuration
        • upload
        • get
        • delete
      • ACL
        • All methods
        • XML structure of ACL configuration
        • objectGetAcl
        • objectPutAcl
        • bucketGetAcl
        • bucketPutAcl
      • Bucket Policy
        • All methods
        • GetBucketPolicy
        • PutBucketPolicy
        • DeleteBucketPolicy
        • Data schema
        • Actions
        • Conditions
      • Common request headers
      • Common response headers
      • Responses
  • Access management
  • Pricing policy
    • Current pricing policy
    • Archive
      • Before January 1, 2019
      • From January 1 to March 1, 2019
  • Questions and answers
  1. Amazon S3-compatible HTTP API
  2. API reference
  3. Multipart upload
  4. copyPart

copyPart method

  • Request
    • Path parameters
    • Query parameters
    • Headers
  • Response
    • Headers
    • Response codes
    • Data schema

Copies part of an object.

Has the same functionality as uploadPart method, but data isn't passed in the request body. It's copied from an existing object.

Request

PUT /{bucket}/{key}?partNumber=PartNumber&uploadId=UploadId HTTP/1.1

Path parameters

Parameter Description
bucket Name of the resulting bucket.
key Key of the resulting object. ID that the object is saved with in Object Storage.

Query parameters

Parameter Description
partNubmer ID that you assigned to the uploaded part.
uploadId ID of the multipart upload returned by Object Storage at the start.

Headers

Use the necessary common request headers in requests.

The Content-Length header is required. The headers listed in the table below are also required.

Header Description
x-amz-copy-source The name of the bucket and the key of the object whose data will be copied, separated by the / character.

For example, x-amz-copy-source: /source_bucket/sourceObject.
x-amz-copy-source-range Byte range to copy from the source object. For example, if you specify x-amz-copy-source-range:bytes=10-36, then Object Storage will copy the range from the 10th to the 36th bytes of the source object.

If you want to add copy conditions, use the headers listed in the table below.

Use the headers from the table below if you need to change the default behavior of the copy method.

Header Description
x-amz-copy-source-if-match Object copying criteria.

If the ETag of an object is the same as in the header, the object is copied.

If the criteria isn't met, Object Storage returns a 412 error.

Can be used with the x-amz-copy-source-if-unmodified-since header.
x-amz-copy-source-if-none-match Object copying criteria.

If the ETag of the object isn't the same as in the header, the object is copied.

If the criteria isn't met, Object Storage returns a 412 error.

Can be used with the x-amz-copy-source-if-modified-since method.
x-amz-copy-source-if-unmodified-since Object copying criteria.

The object is copied if it didn't change since the specified time.

If the criteria isn't met, Object Storage returns a 412 error.

Can be used with the x-amz-copy-source-if-match header.
x-amz-copy-source-if-modified-since Object copying criteria.

The object is copied if it changed since the specified time.

If the criteria isn't met, Object Storage returns a 412 error.

Can be used with the x-amz-copy-source-if-none-match header.

Response

Headers

Responses can only contain common response headers.

Response codes

For a list of possible responses, see Responses.

Additionally, Object Storage may return errors described in the table below.

Error Description HTTP code
NoSuchUpload The specified upload doesn't exist. The specified upload ID might be incorrect or the upload was completed or deleted. 404 Not Found
EntityTooSmall The part is too small.

The uploaded part must be at least 5 MB.
400 Bad Request

Data schema

<CopyObjectResult>
   <LastModified>2019-02-15T14:32:00</LastModified>
   <ETag>"9bgh7535f2734ec974343yuc93985328"</ETag>
</CopyObjectResult>
Element Description
CopyObjectResult Contains response elements.

Path: /CopyObjectResult.
ETag ETag of the resulting part of multipart upload.

Path: /CopyObjectResult/ETag.
LastModified Date when a part of multipart upload was last modified.

Path: /CopyObjectResult/LastModified.
In this article:
  • Request
  • Path parameters
  • Query parameters
  • Headers
  • Response
  • Headers
  • Response codes
  • Data schema
Language
Careers
Privacy policy
Terms of use
© 2021 Yandex.Cloud LLC