swift命令行操作

﹏ヽ暗。殇╰゛Y 2021-11-22 05:32 522阅读 0赞

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 of`storage.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.