Copies a local file or Storj object to another location locally or in Storj DCS
cp command is used to upload and download objects. The
cp command abstracts the complexity of encryption, erasure coding, and distributing pieces of a file to storage nodes.
|the serialized access, or name of the access to use|
|Perform a recursive copy|
|Controls how many uploads/downloads to perform in parallel (default 1)|
|Print what operations would happen but don't execute them|
|Show a progress bar when possible (default true)|
|Downloads the specified range bytes of an object. For more information about the HTTP Range header, see https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35|
|Controls how many parallel chunks to upload/download from a file (default 1)|
|Controls the size of the chunks for parallelism (default 64.0 MiB)|
|Schedule removal after this time (e.g. '+2h', 'now', '2020-01-02T15:04:05Z0700')|
|help for cp|
cp command is used to copy a file to Storj DCS (upload), the CLI first encrypts the file client-side, then splits it into a minimum of x erasure-coded pieces, and finally, the x pieces are uploaded in parallel to x different storage nodes. x currently equals 80 but is subject to change depending on continuous optimization.
cheesecake.jpg into the existing bucket
cakes, use the following command:
You cannot use regular expressions to specify which files to copy (e.g.
uplink cp cheese* sj://cakes will not work). Also, you can only specify one source at a time (no )
cp command is used to copy a file from Storj DCS (download), the CLI first downloads the minimum number of pieces to reconstitute a file (typically 29 pieces), then re-encodes the pieces into a single file, and finally decrypts the file client-side.
To copy a file from a project to a local drive, use:
The uploaded object can be set to expire at a certain time. After the expiration date, the file is no longer available and no longer will generate usage charges. To set an expiration date for a file when uploading it, you should use the
cp command with the
The date is given in the
yyyy-mm-ddThh:mm:ssZhh:mm format defined in ISO 8601.
2021-12-31T13:00:00+02:00 reads "December, 31st at 1pm UTC+2". A date ending with "Z", such as
2021-12-31T13:00:00Z, is in UTC.
The command above gives the following output:
If you have enough upstream bandwidth, you can use the multipart functionality to upload objects faster.
To increase upload speed, you can use the
cp command with the
--parallelism 10 flag (the number you can set according to your preferences and available upstream bandwidth):
Since our sample object is small, you likely will not notice a difference.
It would be significantly different with big objects like videos or OS images etc. and for upstream bandwidth much greater than 100Mbps.
You can recursively copy files:
It is possible to copy a file from one Storj DCS location to another Storj DCS location within the same project.
cp command is used to copy a file from one Storj DCS location to another Storj DCS location, the object will be copied entirely on the "server" side - this will not count against your egress limits, as the object is not being downloaded.
You need to have at least version 1.54.1 of Uplink installed to support server-side copy
First, to create a new bucket, we will use the
mb command, as copying is possible only to an existing bucket.
Nested buckets are not supported, but you can use prefixes, as they would act almost like subfolders.
Now, to copy a file from a bucket within a project to another bucket in the same project with prefix
There is no progress bar shown since nothing was downloaded or uploaded, as the copying happens on the "server" side (within a Storj DCS project.)