rm

Delete an object.

Usage

./uplink.exe rm sj://BUCKET/KEY [flags]
./uplink.exe rm sj://BUCKET/KEY [flags]

Please note, the command uplink rm --recursive for the versioned bucket will put a deletion marker instead of the object deletion.

Flags

FlagDescription
--access stringthe serialized access, or name of the access to use
--recursive, -rRemove recursively
--parallelism, -p intControls how many removes to perform in parallel (default 1)
--encryptedif true, treat paths as base64-encoded encrypted paths
--pendingRemove pending object uploads instead
--version-idVersion ID to remove (if the location is an object path)
--bypass-governance-retentionBypass Object Lock governance mode restrictions

Global flags

FlagDescription
--config-dir stringmain directory for uplink configuration
--help, -hhelp for the command
--summaryprints a summary of what commands are available
--advancedif used in with -h, print advanced flags help

Examples

Delete an object

./uplink.exe rm sj://cakes/cheesecake.jpg
./uplink.exe rm sj://cakes/cheesecake.jpg

Delete an encrypted object

If an object has been created with another encryption key, you won't be able to read it, but you can delete it. In order to delete an encrypted object, you have to know its encrypted path. To retrieve it, you can use the list command ls with the encrypted file. For instance, to list the encrypted path of the objects in a bucket sj://cakes you could use:

./uplink.exe ls sj://cakes --encrypted
./uplink.exe ls sj://cakes --encrypted

You can then use this path to delete the encrypted object:

./uplink.exe rm --encrypted sj://cakes/Ao8rmi2hw5v8_SS2GRokJwqkzQ2j9wXRH2Ll-1owEGPwIWMyu8tj5YCCig==
./uplink.exe rm --encrypted sj://cakes/Ao8rmi2hw5v8_SS2GRokJwqkzQ2j9wXRH2Ll-1owEGPwIWMyu8tj5YCCig==

Delete a pending object

To see a pending objects:

./uplink.exe ls --pending sj://cakes/
./uplink.exe ls --pending sj://cakes/

To delete a pending object:

./uplink.exe rm --pending sj://cakes/cheesecake.jpg
./uplink.exe rm --pending sj://cakes/cheesecake.jpg

Delete an object with a Governance object lock

./uplink.exe rm --bypass-governance-retention sj://cakes/cheesecake.jpg
./uplink.exe rm --bypass-governance-retention sj://cakes/cheesecake.jpg
Previous
rb
Next
setup