Paths are specified as
You may put subdirectories in too, e.g.
If you have a CP code you can use that as the folder after the domain such as <domain>/<cpcode>/<internal directories within cpcode>.
For example, this is commonly configured with or without a CP code:
See all buckets
rclone lsd remote:
The initial setup for Netstorage involves getting an account and secret. Use
rclone config to walk you through the setup process.
Here's an example of how to make a remote called
nto create a new remote.
n) New remote d) Delete remote q) Quit config e/n/d/q> n
ns1when you reach the name> prompt.
netstorageas the type of storage to configure.
Type of storage to configure. Enter a string value. Press Enter for the default (""). Choose a number from below, or type in your own value XX / NetStorage \ "netstorage" Storage> netstorage
Enter a string value. Press Enter for the default (""). Choose a number from below, or type in your own value 1 / HTTP protocol \ "http" 2 / HTTPS protocol \ "https" protocol> 1
Enter a string value. Press Enter for the default (""). host> baseball-nsu.akamaihd.net/123456/content/
Enter a string value. Press Enter for the default (""). account> username
yoption to set your own password then enter your secret. Note: The secret is stored in the
rclone.conffile with hex-encoded encryption.
y) Yes type in my own password g) Generate random password y/g> y Enter the password: password: Confirm the password: password:
[ns1] type = netstorage protocol = http host = baseball-nsu.akamaihd.net/123456/content/ account = username secret = *** ENCRYPTED *** -------------------- y) Yes this is OK (default) e) Edit this remote d) Delete this remote y/e/d> y
This remote is called
ns1 and can now be used.
Get started with rclone and NetStorage with these examples. For additional rclone commands, visit https://rclone.org/commands/.
rclone lsd ns1:/974012/testing/
rclone sync . ns1:/974012/testing/
rclone copy notes.txt ns1:/974012/testing/
rclone delete ns1:/974012/testing/notes.txt
Your credentials must have access to two CP codes on the same remote. You can't perform operations between different remotes.
rclone move ns1:/974012/testing/notes.txt ns1:/974450/testing2/
The Netstorage backend changes the rclone
--links, -l behavior. When uploading, instead of creating the .rclonelink file, use the "symlink" API in order to create the corresponding symlink on the remote. The .rclonelink file will not be created, the upload will be intercepted and only the symlink file that matches the source file name with no suffix will be created on the remote.
This will effectively allow commands like copy/copyto, move/moveto and sync to upload from local to remote and download from remote to local directories with symlinks. Due to internal rclone limitations, it is not possible to upload an individual symlink file to any remote backend. You can always use the "backend symlink" command to create a symlink on the NetStorage server, refer to "symlink" section below.
Individual symlink files on the remote can be used with the commands like "cat" to print the destination name, or "delete" to delete symlink, or copy, copy/to and move/moveto to download from the remote to local. Note: individual symlink files on the remote should be specified including the suffix .rclonelink.
Note: No file with the suffix .rclonelink should ever exist on the server since it is not possible to actually upload/create a file with .rclonelink suffix with rclone, it can only exist if it is manually created through a non-rclone method on the remote.
With NetStorage, directories can exist in one of two forms:
Rclone will intercept all file uploads and mkdir commands for the NetStorage remote and will explicitly issue the mkdir command for each directory in the uploading path. This will help with the interoperability with the other Akamai services such as SFTP and the Content Management Shell (CMShell). Rclone will not guarantee correctness of operations with implicit directories which might have been created as a result of using an upload API directly.
--fast-list/ ListR support
NetStorage remote supports the ListR feature by using the "list" NetStorage API action to return a lexicographical list of all objects within the specified CP code, recursing into subdirectories as they're encountered.
Rclone will use the ListR method for some commands by default. Commands such as
lsf -R will use ListR by default. To disable this, include the
--disable listR option to use the non-recursive method of listing objects.
Rclone will not use the ListR method for some commands. Commands such as
sync don't use ListR by default. To force using the ListR method, include the
There are pros and cons of using the ListR method, refer to rclone documentation. In general, the sync command over an existing deep tree on the remote will run faster with the "--fast-list" flag but with extra memory usage as a side effect. It might also result in higher CPU utilization but the whole task can be completed faster.
Note: There is a known limitation that "lsf -R" will display number of files in the directory and directory size as -1 when ListR method is used. The workaround is to pass "--disable listR" flag if these numbers are important in the output.
NetStorage remote supports the purge feature by using the "quick-delete" NetStorage API action. The quick-delete action is disabled by default for security reasons and can be enabled for the account through the Akamai portal. Rclone will first try to use quick-delete action for the purge command and if this functionality is disabled then will fall back to a standard delete method.
Note: Read the NetStorage Usage API for considerations when using "quick-delete". In general, using quick-delete method will not delete the tree immediately and objects targeted for quick-delete may still be accessible.
Here are the Standard options specific to netstorage (Akamai NetStorage).
Domain+path of NetStorage host to connect to.
Format should be
Set the NetStorage account name
Set the NetStorage account secret/G2O key for authentication.
Please choose the 'y' option to set your own password then enter your secret.
NB Input to this must be obscured - see rclone obscure.
Here are the Advanced options specific to netstorage (Akamai NetStorage).
Select between HTTP or HTTPS protocol.
Most users should choose HTTPS, which is the default. HTTP is provided primarily for debugging purposes.
Here are the commands specific to the netstorage backend.
Run them with
rclone backend COMMAND remote:
The help below will explain what arguments each command takes.
See the backend command for more info on how to pass options and arguments.
These can be run on a running backend using the rc command backend/command.
Return disk usage information for a specified directory
rclone backend du remote: [options] [<arguments>+]
The usage information returned, includes the targeted directory as well as all files stored in any sub-directories that may exist.
You can create a symbolic link in ObjectStore with the symlink action.
rclone backend symlink remote: [options] [<arguments>+]
The desired path location (including applicable sub-directories) ending in
the object that will be the target of the symlink (for example, /links/mylink).
Include the file extension for the object, if applicable.
rclone backend symlink <src> <path>