随笔- 180  文章- 0  评论- 15 

openstack官网有专门的开发者文档介绍如何使用curl操作swift(http://docs.openstack.org/api/openstack-object-storage/1.0/content/),本文做了些翻译工作并在自己创建的swift集群中做了实验,如果希望阅读完整的swift开发者文档,请到官网阅读,内容还是很详细的,本文只是向希望了解swift对象存储的朋友做个直观的展示。

1. Curl

Curl是一个命令行工具,能够通过命令行发送和接受http请求和响应,这使得它能够直接使用ReST API进行工作。

Curl基本命令:

-H <line>

自定义头信息传递给服务器

-i

输出时包括protocol头信息

-k

允许不使用证书到SSL站点

-v

显示详细信息

-X <command>

指定命令

-d <data>

HTTP POST方式传送数据

 

2. 使用curl操作swift

2.1 获取token

用户需要先向keystone主机获取访问swift的权限,然后使用获取到的token访问swift的proxy节点。

注意官网给的文档的使用方法(http://docs.openstack.org /grizzly/openstack-compute/install/yum/content/verify-swift- installation.html)是针对swauth或tempauth的,而不是针对keystone的。可能会产生如下错误


使用keystone认证方式的正确的获取token方法:

curl -d '{"auth":{"tenantName": "adminTenant","passwordCredentials":{"username": "admin","password": "admin"}}}' -H "Content-type:application/json" http://192.168.1.126:35357/v2.0/tokens | python -mjson.tool

此处使用的url应该是你自己的keystone主机的url。

响应内容大致如下:

% Total   % Received % Xferd  AverageSpeed   Time    Time    Time  Current

                                 Dload  Upload  Total   Spent    Left Speed

110 1107  100  1107   0   105   9759   925 --:--:-- --:--:-- --:--:-- 9109

{

   "access": {

       "metadata": {

           "is_admin": 0,

           "roles": [

               "3804f878346540438b0f640896485373"

           ]

       },

       "serviceCatalog": [

           {

                "endpoints": [

                    {

                        "adminURL":"http://192.168.1.127:8080",

                        "id":"bd49f802dddc4483872cc00e827d0362",

                       "internalURL":"http://192.168.1.127:8080/v1/AUTH_0bb450946b3b4f0aa487cf42d54abe77",

                        "publicURL":"http://192.168.1.127:8080/v1/AUTH_0bb450946b3b4f0aa487cf42d54abe77",

                        "region":"RegionOne"

                    }

                ],

                "endpoints_links":[],

                "name":"swift",

                "type":"object-store"

           },

           {

                "endpoints": [

                    {

                       "adminURL":"http://192.168.1.126:35357/v2.0",

                        "id":"42083df2425b4d48850599115580e21c",

                       "internalURL": "http://192.168.1.126:5000/v2.0",

                        "publicURL":"http://192.168.1.126:5000/v2.0",

                        "region":"RegionOne"

                    }

                ],

                "endpoints_links":[],

                "name":"keystone",

                "type":"identity"

           }

       ],

       "token": {

           "expires": "2013-05-29T11:58:48Z",

           "id":"44c81c18e0af4990b72663985911d6d8",

           "tenant": {

                "description":"Admin Tenant",

                "enabled": true,

                "id":"0bb450946b3b4f0aa487cf42d54abe77",

                "name":"adminTenant"

           }

       },

       "user": {

           "id": "946e9bc0402440638e46f1634cd49955",

           "name": "admin",

           "roles": [

                {

                    "name":"admin"

                }

           ],

           "roles_links": [],

           "username": "admin"

       }

    }

}

其中相当于X-Auth-Token的就是

"id": "44c81c18e0af4990b72663985911d6d8"

相当于X-Storage-Url的就是

"http://192.168.1.127:8080/v1/AUTH_0bb450946b3b4f0aa487cf42d54abe77"


2.2 account操作

1)查看当前存储信息

curl -k -v -X HEAD  -H 'X-Auth-Token:4b7ef9e0c24e44c689ff37a15a7a6493' http://192.168.1.127:8080/v1/AUTH_0bb450946b3b4f0aa487cf42d54abe77

输出为:

可以看到当前有一个container和一个object


2.3 container操作

1)列出container

curl -i -X GET  -H 'X-Auth-Token:4b7ef9e0c24e44c689ff37a15a7a6493' http://192.168.1.127:8080/v1/AUTH_0bb450946b3b4f0aa487cf42d54abe77

响应:

Myfiles就是之前创建的container


2)创建container

curl -i -X PUT -H 'X-Auth-Token:4b7ef9e0c24e44c689ff37a15a7a6493' http://192.168.1.127:8080/v1/AUTH_0bb450946b3b4f0aa487cf42d54abe77/dianxin

响应:


创建了一个名叫dianxin的container,可以list出来看看


3)列出部分container

如果container有很多的话,swift本身的限制是一次最多显示10000个container,或者自己只想要列出一部分文件夹,可以使用limit

首先用上面提过的方法多创建几个container,如下图所示我创建了6个container。


现在我只想列出前三个,则使用下述命令:

curl -i -X GET  -H 'X-Auth-Token:4b7ef9e0c24e44c689ff37a15a7a6493' http://192.168.1.127:8080/v1/AUTH_0bb450946b3b4f0aa487cf42d54abe77?limit=3

响应如下,可见只列出了前三个container:


现在我想要列出后面的三个container,应该怎么做呢?就要用到marker,如下命令:

curl -i -X GET  -H 'X-Auth-Token:4b7ef9e0c24e44c689ff37a15a7a6493' http://192.168.1.127:8080/v1/AUTH_0bb450946b3b4f0aa487cf42d54abe77?marker=myfiles\limit=3

意思就是列出myfiles这个container之后的3个container。(也可是?marker=myfiles\&limit=3)

响应如下,可见列出的就是后三个container:


通过使用marker和limit,就可以控制列出哪些container。

4)格式化输出

Json格式输出:

curl -i -X GET  -H 'X-Auth-Token:4b7ef9e0c24e44c689ff37a15a7a6493' http://192.168.1.127:8080/v1/AUTH_0bb450946b3b4f0aa487cf42d54abe77?format=json

响应:


Xml格式输出:

curl -i -X GET  -H 'X-Auth-Token:4b7ef9e0c24e44c689ff37a15a7a6493' http://192.168.1.127:8080/v1/AUTH_0bb450946b3b4f0aa487cf42d54abe77?format=xml

响应:


5)查看container的metadata

查看myfiles这个container的metadata

curl -i -X HEAD  -H 'X-Auth-Token:4b7ef9e0c24e44c689ff37a15a7a6493' http://192.168.1.127:8080/v1/AUTH_0bb450946b3b4f0aa487cf42d54abe77/myfiles

响应:


6)删除container

删除mss这个container

curl -i -X DELETE  -H 'X-Auth-Token:4b7ef9e0c24e44c689ff37a15a7a6493' http://192.168.1.127:8080/v1/AUTH_0bb450946b3b4f0aa487cf42d54abe77/mss

响应:


List剩余的container:


(以下内容为更换过系统部署后的示例,所以token、节点IP和account不同)

2.4 object操作

1)创建object

上传一个object到myfiles

curl -k -i -X PUT -T "install.log" -H 'X-Auth-Token:2235c348d91445f09708af80150d58f2' http://192.168.1.124:8080/v1/AUTH_f0cb916780504478b03da925451422d5/myfiles/install.log

响应:


列出刚上传的object

curl -k -i -X GET -H 'X-Auth-Token:2235c348d91445f09708af80150d58f2' http://192.168.1.124:8080/v1/AUTH_f0cb916780504478b03da925451422d5/myfiles

响应:


2)object也可以使用limit和marker来自定义要列出的object,用法和container相同

3)下载一个object

下载刚上传的myfiles/install.log,注意不要使用-i参数

curl -k -X GET -H 'X-Auth-Token:2235c348d91445f09708af80150d58f2' http://192.168.1.124:8080/v1/AUTH_f0cb916780504478b03da925451422d5/myfiles/install.log> install.log.backup

响应:


4)object拷贝

拷贝myfiles/install.log到dianxin

curl -k -i -X PUT \

-H 'X-Auth-Token:2235c348d91445f09708af80150d58f2' \

-H 'X-Copy-From: /myfiles/install.log' -H 'Content-Length:0'http://192.168.1.124:8080/v1/AUTH_f0cb916780504478b03da925451422d5/dianxin/install.log

响应:


查看是否拷贝成功

curl -k -i -X GET -H 'X-Auth-Token:2235c348d91445f09708af80150d58f2' http://192.168.1.124:8080/v1/AUTH_f0cb916780504478b03da925451422d5/dianxin/

响应:


5)删除object

删除上一步拷贝的那个文件

curl -k -i -X DELETE -H 'X-Auth-Token:2235c348d91445f09708af80150d58f2' http://192.168.1.124:8080/v1/AUTH_f0cb916780504478b03da925451422d5/dianxin/install.log

响应:


查看是否删除成功

curl -k -i -X GET -H 'X-Auth-Token:2235c348d91445f09708af80150d58f2' http://192.168.1.124:8080/v1/AUTH_f0cb916780504478b03da925451422d5/dianxin/

响应:


6)objectmetadata操作

设置对象的元数据:

curl -k -i -X POST \

-H 'X-Auth-Token:2235c348d91445f09708af80150d58f2' \

-H 'X-Object-Meta-Breed: installinfo'http://192.168.1.124:8080/v1/AUTH_f0cb916780504478b03da925451422d5/myfiles/install.log

响应:


读取对象元数据

curl -k -i -X HEAD -H 'X-Auth-Token:2235c348d91445f09708af80150d58f2' http://192.168.1.124:8080/v1/AUTH_f0cb916780504478b03da925451422d5/myfiles/install.log

响应:


附件:curl命令集

-a/--append 上传文件时,附加到目标文件

-A/--user-agent <string> 设置用户代理发送给服务器

- anyauth 可以使用“任何”身份验证方法

-b/--cookie <name=string/file> cookie字符串或文件读取位置

- basic 使用HTTP基本验证

-B/--use-ascii 使用ASCII /文本传输

-c/--cookie-jar <file> 操作结束后把cookie写入到这个文件中

-C/--continue-at <offset> 断点续转

-d/--data <data> HTTP POST方式传送数据

--data-ascii <data> 以ascii的方式post数据

--data-binary <data> 以二进制的方式post数据

--negotiate 使用HTTP身份验证

--digest 使用数字身份验证

--disable-eprt 禁止使用EPRT或LPRT

--disable-epsv 禁止使用EPSV

-D/--dump-header <file> 把header信息写入到该文件中

--egd-file <file> 为随机数据(SSL)设置EGD socket路径

--tcp-nodelay 使用TCP_NODELAY选项

-e/--referer 来源网址

-E/--cert <cert[:passwd]> 客户端证书文件和密码 (SSL)

--cert-type <type> 证书文件类型 (DER/PEM/ENG) (SSL)

--key <key> 私钥文件名 (SSL)

--key-type <type> 私钥文件类型 (DER/PEM/ENG) (SSL)

--pass <pass> 私钥密码 (SSL)

--engine <eng> 加密引擎使用 (SSL). "--engine list" for list

--cacert <file> CA证书 (SSL)

--capath <directory> CA目录 (made using c_rehash) to verify peer against (SSL)

--ciphers <list> SSL密码

--compressed 要求返回是压缩的形势 (using deflate or gzip)

--connect-timeout <seconds> 设置最大请求时间

--create-dirs 建立本地目录的目录层次结构

--crlf 上传是把LF转变成CRLF

-f/--fail 连接失败时不显示http错误

--ftp-create-dirs 如果远程目录不存在,创建远程目录

--ftp-method [multicwd/nocwd/singlecwd] 控制CWD的使用

--ftp-pasv 使用 PASV/EPSV 代替端口

--ftp-skip-pasv-ip 使用PASV的时候,忽略该IP地址

--ftp-ssl 尝试用 SSL/TLS 来进行ftp数据传输

--ftp-ssl-reqd 要求用 SSL/TLS 来进行ftp数据传输

-F/--form <name=content> 模拟http表单提交数据

-form-string <name=string> 模拟http表单提交数据

-g/--globoff 禁用网址序列和范围使用{}和[]

-G/--get 以get的方式来发送数据

-h/--help 帮助

-H/--header <line>自定义头信息传递给服务器

--ignore-content-length 忽略的HTTP头信息的长度

-i/--include 输出时包括protocol头信息

-I/--head 只显示文档信息

从文件中读取-j/--junk-session-cookies忽略会话Cookie

- 界面<interface>指定网络接口/地址使用

- krb4 <级别>启用与指定的安全级别krb4

-j/--junk-session-cookies 读取文件进忽略session cookie

--interface <interface> 使用指定网络接口/地址

--krb4 <level> 使用指定安全级别的krb4

-k/--insecure 允许不使用证书到SSL站点

-K/--config 指定的配置文件读取

-l/--list-only 列出ftp目录下的文件名称

--limit-rate <rate> 设置传输速度

--local-port<NUM> 强制使用本地端口号

-m/--max-time <seconds> 设置最大传输时间

--max-redirs <num> 设置最大读取的目录数

--max-filesize <bytes> 设置最大下载的文件总量

-M/--manual 显示全手动

-n/--netrc 从netrc文件中读取用户名和密码

--netrc-optional 使用 .netrc 或者 URL来覆盖-n

--ntlm 使用 HTTP NTLM 身份验证

-N/--no-buffer 禁用缓冲输出

-o/--output 把输出写到该文件中

-O/--remote-name 把输出写到该文件中,保留远程文件的文件名

-p/--proxytunnel 使用HTTP代理

--proxy-anyauth 选择任一代理身份验证方法

--proxy-basic 在代理上使用基本身份验证

--proxy-digest 在代理上使用数字身份验证

--proxy-ntlm 在代理上使用ntlm身份验证

-P/--ftp-port <address> 使用端口地址,而不是使用PASV

-Q/--quote <cmd>文件传输前,发送命令到服务器

-r/--range <range>检索来自HTTP/1.1或FTP服务器字节范围

--range-file 读取(SSL)的随机文件

-R/--remote-time 在本地生成文件时,保留远程文件时间

--retry <num> 传输出现问题时,重试的次数

--retry-delay <seconds> 传输出现问题时,设置重试间隔时间

--retry-max-time <seconds> 传输出现问题时,设置最大重试时间

-s/--silent静音模式。不输出任何东西

-S/--show-error 显示错误

--socks4 <host[:port]> 用socks4代理给定主机和端口

--socks5 <host[:port]> 用socks5代理给定主机和端口

--stderr <file>

-t/--telnet-option <OPT=val> Telnet选项设置

--trace <file> 对指定文件进行debug

--trace-ascii <file> Like --跟踪但没有hex输出

--trace-time 跟踪/详细输出时,添加时间戳

-T/--upload-file <file> 上传文件

--url <URL> Spet URL to work with

-u/--user <user[:password]>设置服务器的用户和密码

-U/--proxy-user <user[:password]>设置代理用户名和密码

-v/--verbose

-V/--version 显示版本信息

-w/--write-out [format]什么输出完成后

-x/--proxy <host[:port]>在给定的端口上使用HTTP代理

-X/--request <command>指定什么命令

-y/--speed-time 放弃限速所要的时间。默认为30

-Y/--speed-limit 停止传输速度的限制,速度时间'秒

-z/--time-cond 传送时间设置

-0/--http1.0 使用HTTP 1.0

-1/--tlsv1 使用TLSv1(SSL)

-2/--sslv2 使用SSLv2的(SSL)

-3/--sslv3 使用的SSLv3(SSL)

--3p-quote like -Q for the source URL for 3rd party transfer

--3p-url 使用url,进行第三方传送

--3p-user 使用用户名和密码,进行第三方传送

-4/--ipv4 使用IP4

-6/--ipv6 使用IP6

-#/--progress-bar 用进度条显示当前的传送状态

 posted on 2015-03-05 14:34  zmlctt  阅读(4866)  评论(0编辑  收藏