Atom feed of this document
 

 Swift CLI Basics

The command line usage for swift, the CLI tool is:

swift (command) [options] [args]

Here are the available commands for swift.

 stat [container] [object]

Displays information for the account, container, or object depending on the args given (if any).

 list [options] [container]

Lists the containers for the account or the objects for a container. -p or -prefix is an option that will only list items beginning with that prefix. -d or -delimiter is option (for container listings only) that will roll up items with the given delimiter, or character that can act as a nested directory organizer.

 upload [options] container file_or_directory [file_or_directory] […]

Uploads to the given container the files and directories specified by the remaining args. -c or -changed is an option that will only upload files that have changed since the last upload.

 post [options] [container] [object]

Updates meta information for the account, container, or object depending on the args given. If the container is not found, it will be created automatically; but this is not true for accounts and objects. Containers also allow the -r (or -read-acl) and -w (or -write-acl) options. The -m or -meta option is allowed on all and used to define the user meta data items to set in the form Name:Value. This option can be repeated.

Example: post -m Color:Blue -m Size:Large

 download —all OR download container [object] [object] …

Downloads everything in the account (with —all), or everything in a container, or a list of objects depending on the args given. For a single object download, you may use the -o [—output] (filename) option to redirect the output to a specific file or if “-” then just redirect to stdout.

 delete —all OR delete container [object] [object] …

Deletes everything in the account (with —all), or everything in a container, or a list of objects depending on the args given.

Example: swift -A https://auth.api.rackspacecloud.com/v1.0 -U user -K key stat

 Options for swift

-version show program’s version number and exit

-h, -help show this help message and exit

-s, -snet Use SERVICENET internal network

-v, -verbose Print more info

-q, -quiet Suppress status output

-A AUTH, -auth=AUTH URL for obtaining an auth token

-U USER, -user=USER User name for obtaining an auth token

-K KEY, -key=KEY Key for obtaining an auth token



loading table of contents...