table of contents
- stretch 1:3.1.0-3
- testing 1:3.6.0-2
- unstable 1:3.6.0-2
- experimental 1:3.7.0-1
swift(1) | OpenStack Swift | swift(1) |
NAME¶
swift - OpenStack Swift client toolSYNOPSIS¶
swift [options] <command> [args]DESCRIPTION¶
The swift tool is a command line utility for communicating with an OpenStack Object Storage (Swift) environment. It allows one to perform several types of operations.COMMANDS¶
stat [command-options] [container] [object]list [command-options] [container]
The -l or --long and --lh options provide more detail, similar to ls -l and ls -lh, the latter providing sizes in human readable format (eg 3K, 12M, etc). These latter 2 switches use more overhead to get those details, which is directly proportional to the number of container or objects being listed. With the -t or --total option they only report totals.
upload [command-options] container file_or_directory [file_or_directory] [...]
post [command-options] [container] [object]
copy [command-options] container object
download [command-options] [container] [object] [object] [...]
delete [command-options] [container] [object] [object] [...]
capabilities [command-options] [proxy-url]
By default, the output includes the list of the activated Swift middlewares as well as relevant options for each one. Additionally the command displays relevant options for the Swift core.
The --json option will print a json representation of the cluster capabilities. This is typically more suitable for consumption by other programs, such as jq.
Example: capabilities https://swift.example.com capabilities --json
tempurl [command-option] method seconds path key
auth
OPTIONS¶
- --version Show program's version number and exit
- -h, --help Show this (or any subcommand if after command) 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
- -V 1|2, --auth-version=VERSION Authentication protocol version
- -K KEY, --key=KEY Key for obtaining an auth token
- --os-storage-url=URL Use this instead of URL returned from auth
- --os-help Show all OpenStack authentication options
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
DOCUMENTATION¶
More in depth documentation about OpenStack Swift as a whole can be found at http://swift.openstack.org8/26/2011 | Linux |