swift命令行操作

最新推荐文章于 2026-02-03 00:25:00 发布

转载最新推荐文章于 2026-02-03 00:25:00 发布 · 6.1k 阅读

标签

#OpenStack #swift

linux 专栏收录该内容

104 篇文章

订阅专栏

root@nova-control:~# swift -h

Usage: swift [options] [args]

Commands:

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 (see Cloud Files general documentation for what this means).

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. -S or --segment-size and --leave-segments are options as well (see --help for more).

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 [options] [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] option to redirect the output to a specific file or if "-" then just redirect

to stdout.

delete --all OR delete container [--leave-segments] [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.

Example:

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

[注:可以这么理解.swift命令后跟的地址是验证地址(keystone的地址),理解为默认的去找keystone中的swift服务;想下:如果用curl,则要用到keystone返回给我们的地址(x-storage-url))]

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

-V AUTH_VERSION, --auth-version=AUTH_VERSION

Specify a version for authentication(default: 1.0)

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

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

2.1. Authentication

Client authentication is provided via a ReST interface using the GET method, with v1.0 supplied as the path. Additionally, two headers are required, X-Auth-User and X-Auth-Key with values for the username and API Access Key respectively.

Each ReST request against the OpenStack Object Storage system requires the inclusion of a specific authorization token HTTP x-header, defined as X-Auth-Token. Clients obtain this token, along with the Cloud Servers API URL, by first using an authentication service and supplying a valid username and API access key.

Request

To authenticate, you must supply your username and API access key in x-headers:

Use your OpenStack Object Storage (Swift) username as the username for the API. Place it in the X-Auth-User x-header.
Get your API access key from authentication service you chose when installing. You have some options for auth, including tempauth (which is included with Swift), swauth (an auth service for Swift as WSGI middleware that uses Swift itself as a backing store that is provided via download from Github), the OpenStack Identity Service (project named Keystone), or you can use your own authentication system. Place your access key in the X-Auth-Key x-header.

Example 2.1. Authentication HTTP Request

GET /v1.0 HTTP/1.1
Host: auth.api.yourcloud.com
X-Auth-User: jdoe
X-Auth-Key: a86850deb2742ec3cb41518e26aa2d89

Response

When authentication is successful, an HTTP status 204 (No Content) is returned with the X-Storage-Url and X-Auth-Token headers. Any 2xx response is a good response. For example, a 202 response means the request has been accepted. Also, additional X- headers may be returned. These additional headers are related to other Rackspace services and can be ignored. An HTTP status of 401 (Unauthorized) is returned upon authentication failure. All subsequent container/object operations against OpenStack Object Storage should be made against the URI specified in X-Storage-Url and must include the X-Auth-Token header.

Example 2.2. Authentication HTTP Response

HTTP/1.1 204 No Content
Date: Mon, 12 Nov 2010 15:32:21 GMT
Server: Apache
X-Storage-Url: https://storage.swiftdrive.com/v1/CF_xer7_34
X-Auth-Token: eaaafd18-0fed-4b3a-81b4-663c99ec1cbb
Content-Length: 0
Content-Type: text/plain; charset=UTF-8

The X-Storage-Url will need to be parsed and used in the connection and request line of all subsequent requests against Object Storage. In the example response above, users connecting to OpenStack Object Storage would send most container/object requests with a host header ofstorage.swiftdrive.com and the request line's version and account as /v1/CF_xer7_34. Note that authentication tokens are valid for a 24 hour period for many authentication configurations.