swift(1) - Linux man page
Name
swift - Openstack-swift swift tool
Synopsis
swift [options] <command> [args]
Description
The swift tool is a command line interface script for communicating with an openstack-swift object storage environment. It allows one to perform several types of operations.
Commands
stat [container] [object]
- Displays information for the account, container, or object depending on the args given (if any).
- list [command-options] [container]
- Lists the containers for the account or the objects for a container. The -p or --prefix is an option that will only list items beginning with that prefix. The -d or --delimiter is option (for container listings only) that will roll up items with the given delimiter (see Cloud Files general documentation for what this means).
- upload [command-options] container file_or_directory [file_or_directory] [...]
- Uploads to the given container the files and directories specified by the remaining args. The -c or --changed is an option that will only upload files that have changed since the last upload. The -S <size> or --segment-size <size> and --leave-segments are options as well (see --help for more).
- post [command-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 [command-options] [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 [command-options] [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. Segments of manifest objects will be deleted as well, unless you specify the --leave-segments option.
Options
--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
- -s, --snet Use SERVICENET internal network
Example
swift -A https://127.0.0.1:443/auth/v1.0 -U swiftops:swiftops -K swiftops stat
- Account: AUTH_43b42dae-dc0b-4a4b-ac55-97de614d6e6e
- Containers: 1
- Objects: 1
- Bytes: 1124
- Accept-Ranges: bytes
- X-Trans-Id: txb21186a9eef64ed295a1e95896a0fc72
- Containers: 1
Documentation
More in depth documentation about Openstack-Swift as a whole can be found at http://swift.openstack.org