mc cp

Copies objects to and from buckets on local cluster or remote fabric in the global namespace.

Syntax

NOTE: The size limits for an object to upload are as follows.

Single object put : 5 GiB

Single part size : 5 GiB

Multi part complete object size : 5 TiB

CLI

mc cp [FLAGS] SOURCE [SOURCE...] TARGET

FLAGS:
  --version-id value, --vid value    select an object version to copy
  --recursive, -r                    copy recursively
  --attr value                       add custom metadata for the object
  --preserve, -a                     preserve filesystem attributes (mode, ownership, timestamps)
  --disable-multipart                disable multipart upload feature
  --md5                              force all upload(s) to calculate md5sum checksum
  --retention-mode value             retention mode to be applied on the object (governance, compliance)
  --retention-duration value         retention duration for the object in d days or y years
  --legal-hold value                 apply legal hold to the copied object (on, off)
  --tags value                       add tags for the object
  --json                             enable JSON lines formatted output
  --debug                            enable debug output
  --insecure                         disable SSL certificate verification
  --help, -h                         show help

Parameters

Parameter	Description
`SOURCE`	The source from which an object is copied. This can be the filesystem or the alias of a configured HPE Ezmeral Object Store deployment. This parameter is mandatory. To copy objects from a remote cluster/fabric in the global namespace, use the format `<fabricname>-<bucketname>/<objectname>` instead of only the `<bucketname>/<objectname>` after the alias, that is `<alias>/<fabricname>-<bucketname>/<objectname>.`When bucketname and objectname is mentioned without the fabric name, Data Fabric checks the local cluster for the specified bucketname and objectname.
`TARGET`	The destination to which an object is copied. This can be the filesystem or the alias of a configured HPE Ezmeral Object Store deployment. This parameter is mandatory. To copy objects from a remote cluster/fabric in the global namespace use the format `<fabricname>-<bucketname>/<objectname>` instead of only the `<bucketname>/<objectname>` after the alias, that is `<alias>/<fabricname>-<clustername>/<objectname>.`When bucketname and objectname is mentioned without the fabric name, Data Fabric checks the local cluster for the specified bucketname and objectname.
`version-id`	The object version to copy.
`recursive`	Copy objects recursively and not just the top-level folder.
`attr`	Add custom metadata for the object.
`preserve`	Preserve filesystem attributes such as mode, timestamps and ownership when copying.
`disable-multipart`	Disable the multipart upload feature.
`md5`	Calculate the md5 checksum when uploading.
`retention-mode`	The retention mode - either governance or compliance - to apply to the object.
`retention-duration`	Set the duration of the retention mode in days (d) or years (y).
`legal-hold`	Set legal hold for the object.
`tags`	Add tags for the object.
`json`	Enable JSON formatted output.
`debug`	Enable output for debugging.
`insecure`	Disable SSL verification.
`help`	Show this help.

Examples

Copy local folders fin1 and fin2 recursively to a bucket named northamerica in the Object Store deployment with alias salesobject:
CLI
```
/opt/mapr/bin/mc cp --recursive fin1/ fin2/ salesobject/northamerica/
```
Copy a list of Excel files (.xls) with specified metadata, separated by ";" from the profit folder to a bucket named northamerica in the Object Store deployment with alias salesobject
CLI
```
/opt/mapr/bin/mc cp --attr "key1=value1;key2=value2" profit/*.xls salesobject/northamerica/
```
Copy the file secret.txt with object lock mode set to governance with retention duration 1 day, from the profit folder to a bucket named northamerica in the Object Store deployment with alias salesobject:
CLI
```
/opt/mapr/bin/mc cp --retention-mode governance --retention-duration 1d profit/secret.txt salesobject/northamerica/
```
Copy the file secret.txt with legal hold enabled, from the profit folder to a bucket named northamerica in the Object Store deployment with alias salesobject:
CLI
```
/opt/mapr/bin/mc cp --legal-hold on profit/secret.txt salesobject/northamerica/
```
Copy the file secret.txt with legal hold enabled, from the profit folder to a bucket named northamerica on a remote cluster named sales, in the Object Store deployment with alias salesobject:
CLI
```
/opt/mapr/bin/mc cp --legal-hold on profit/secret.txt salesobject/sales-northamerica/
```
Copy the object testobject from the usa bucket on the remote fabric sales to a bucket named northamerica on the same remote fabric sales, in the Object Store deployment with alias salesobject:
CLI
```
/opt/mapr/bin/mc cp salesobject/sales-usa/testobject salesobject/sales-northamerica/
```