Method: Aws::S3::Object#copy_to

Defined in:

lib/aws-sdk-resources/services/s3/object.rb

#copy_to(target, options = {}) ⇒ Object

Note:

If you need to copy to a bucket in a different region, use #copy_from.

Copies this object to another object. Use ‘multipart_copy: true` for large objects. This is required for objects that exceed 5GB.

Examples:

Basic object copy

bucket = Aws::S3::Bucket.new('source-bucket')
object = bucket.object('source-key')

# target as String
object.copy_to('target-bucket/target-key')

# target as Hash
object.copy_to(bucket: 'target-bucket', key: 'target-key')

# target as Aws::S3::Object
object.copy_to(bucket.object('target-key'))

Managed copy of large objects

# uses multipart upload APIs to copy object
object.copy_to('src-bucket/src-key', multipart_copy: true)

Parameters:

• target (S3::Object, String, Hash) —

  Where to copy the object data to. ‘target` must be one of the following:

  • Aws::S3::Object

  • Hash - with ‘:bucket` and `:key`

  • String - formatted like ‘“target-bucket-name/target-key”`

# File 'lib/aws-sdk-resources/services/s3/object.rb', line 102

def copy_to(target, options = {})
  ObjectCopier.new(self, options).copy_to(target, options)
end