mv

Moves a Storj object to another location in Storj DCS

Usage

./uplink.exe mv SOURCE DESTINATION [flags]
./uplink.exe mv SOURCE DESTINATION [flags]

The mv command is used to move or rename objects within the same Storj DCS project. The mv command uses a server-side move (rename) method, it does not incur a fee for downloading and will be performed with no delay.

Flags

FlagDescription
--access stringthe serialized access, or name of the access to use
--help, -hhelp for mv

Examples

Move an object within an existing bucket

When the mv command is used to move a file within Storj DCS, the CLI will move (rename) the object using the server-side method to rename the object.

To move cheesecake.jpg within the existing bucket cakes, use the following command:

./uplink.exe mv sj://cakes/cheesecake.jpg sj://cakes/New-York/cheesecake.jpg
./uplink.exe mv sj://cakes/cheesecake.jpg sj://cakes/New-York/cheesecake.jpg

You cannot use pattern expressions to specify which files to copy (e.g. uplink mv sj://cakes/cheese* sj://cakes/New-York/ will not work). Also, you can only specify one source at a time.

Sample Output:

Move an object from a one bucket to another

When the mv command is used to move an object from one Storj DCS bucket to another Storj DCS bucket, the CLI will use a server-side move method.

To create a new bucket, we will use the mb command, as a move is possible only to an existing bucket.

./uplink.exe mb sj://new-recipes
./uplink.exe mb sj://new-recipes
Bucket new-recipes created
Bucket new-recipes created

Nested buckets are not supported, but you can use prefixes, as they would act almost like subfolders.

To move an object from one bucket to another, use:

./uplink.exe mv sj://cakes/New-York/cheesecake.jpg sj://new-recipes/cakes/cheesecake.jpg
./uplink.exe mv sj://cakes/New-York/cheesecake.jpg sj://new-recipes/cakes/cheesecake.jpg

Sample Output:

Troubleshooting move errors

ERROR: duplicate key value violates unique constraint "primary" (SQLSTATE 23505)

uplink mv sj://cakes/New-York/cheesecake.jpg sj://new-recipes/cakes/cheesecake.jpg



Error: uplink: metaclient: metabase: unable to update object: ERROR: duplicate key value violates unique constraint "primary" (SQLSTATE 23505)
uplink mv sj://cakes/New-York/cheesecake.jpg sj://new-recipes/cakes/cheesecake.jpg



Error: uplink: metaclient: metabase: unable to update object: ERROR: duplicate key value violates unique constraint "primary" (SQLSTATE 23505)

This error means that the destination object already exists. You should either use a different destination name/prefix or remove the existing object from the destination.

To remove an object, use the rm command.

Previous
meta get
Next
rb