copy (copy object)

Top  Previous  Next

copy [BUCKET]/[FOLDER]/FROMOBJECT [BUCKET]/[FOLDER]/TOOBJECT [-cacl:CANNED_ACL] [-meta:METADATA] [-e] [-rr] [-ia] [-keep:KEEP]

Make a copy of one S3 object and optionally apply new ACL and/or new metadata or keep existing.
Note that the original object is not removed (if needed it must be removed with the del command).

 

Parameter

Description

Examples

-cacl:CANNED_ACL

Apply canned ACL to copy of object. Amazon S3 supports a set of predefined ACLs, known as canned ACLs. Each canned ACL has a predefined set of grantees and permissions.

 

Valid Values for CANNED_ACL:

 

private (Owner gets FULL CONTROL. No one else has access rights, this is the default for an object)

 

public-read (Owner gets FULL CONTROL. The AllUsers group,  that is everyone, gets READ access)

 

public-read-write (Owner gets FULL CONTROL. The AllUsers group, that is everyone, gets READ and WRITE access)

 

authenticated-read (Owner gets FULL CONTROL. The AuthenticatedUsers group, that is all Amazon AWS accounts, gets READ access.)

 

bucket-owner-read (Object owner gets FULL CONTROL. Bucket owner gets READ access)

 

bucket-owner-full-control (Both the object owner and the bucket owner get FULL CONTROL over the object)

 

Note: You can specify only one of these canned ACLs in your request.

copy mybucket/myfile.txt mybucket/myfilecopy.txt (duplicate file mybucket/myfile.txt to mybucket/myfilecopy.txt)

 

copy mybucket/myfile.txt mybucket/myfilecopy.txt -cacl:public-read (duplicate file mybucket/myfile.txt to mybucket/myfilecopy.txt and apply 'public-read' ACL to target mybucket/myfilecopy.txt)

-meta:META

Metadata headers to be added to copy of object. Multiple metadata headers should be separated by |.

copy mybucket/myfile.txt mybucket/myfilecopy.txt -meta:"cache-control:max-age=60" (duplicate file mybucket/myfile.txt to mybucket/myfilecopy.txt and apply metadata header "cache-control:max-age=60" to target mybucket/myfilecopy.txt)

-e

Apply Amazon S3 Server Side Encryption to copy of object.

copy mybucket/myfile.txt mybucket/subfolder/myfile.txt -e (duplicate file mybucket/myfile.txt to mybucket/subfolder/myfile.txt and apply server side encryption to target mybucket/subfolder/myfile.txt)

-rr

Set S3 storage class to "Reduced Redundancy" for copy of object.

copy mybucket/myfile.txt mybucket/subfolder/myfile.txt -rr (duplicate file mybucket/myfile.txt to mybucket/subfolder/myfile.txt and apply storage class Reduced Redundancy to target mybucket/subfolder/myfile.txt)

-ia

Set S3 storage class to "Infrequent Access" for copy of object.

copy mybucket/myfile.txt mybucket/subfolder/myfile.txt --ia (duplicate file mybucket/myfile.txt to mybucket/subfolder/myfile.txt and apply storage class Infrequent Access to target mybucket/subfolder/myfile.txt)

-keep:KEEP

Copy also metadata and/or ACL from source object to copy of object.

Use -keep:acl to copy the existing ACL

Use -keep:meta to copy the existing metadata

Use -keep to copy both, metadata and ACL.

If the -keep parm is not specified, metadata and ACL are not copied.

copy mybucket/myfile.txt mybucket/subfolder/myfile.txt -keep (duplicate file mybucket/myfile.txt to mybucket/subfolder/myfile.txt and copy also metadata and ACL from source mybucket/myfile.txt to target mybucket/subfolder/myfile.txt)