由于最近工作需要使用Openstack ,使用cURL操作Openstack對象存儲的ReST API,這是本人找了好多資料完成的,這里記錄下。
使用Openstack ,使用cURL操作Openstack對象存儲的ReST API
cURL 是一個利用URL語法規定來傳輸文件和數據的工具,支持很多協議,如HTTP、FTP、TELNET等。本文主要是介紹使用該工具和HTTP協議與swift服務如何交互。cURL允許你從命令行或shell腳本傳送和接收HTTP的請求和響應。這使得直接與ReST的API工作而無需其他客服端APIs成為可能。本文,我們需要使用到以下的cURL命令行選項:
-X METHOD 描述HTTP的請求方法(HEAD, GET等) -D Dump 將HTTP響應頭部到stdout.-H HEADER 描述一個在請求中的HTTP/HTTPS頭部.-v 使用操作的過程更加詳細
1.認證
In order to use the ReST API, you will first need to obtain a authorization token, which will need to be passed in for each request using the X-Auth-Token header. The following example demonstrates how to use cURL to obtain the authorization token and the URL of the storage system.
為了使用ReST的API,我們首先需要獲得一個認證令牌,用于傳給每個使用X-Auth-Token頭部的請求。以下的例子展示了如何使用cURL來獲得認證令牌和存儲系統的URL。
Exp1:獲得X-Storage-Url和X-Auth-Token
curl -D- -H 'X-Storage-User: test:tester' -H 'X-Storage-Pass: testing' http://127.0.0.1:8080/auth/v1.0
運行結果如下:
sting' http://127.0.0.1:8080/auth/v1.0HTTP/1.1 200 OKX-Storage-Url: http://127.0.0.1:8080/v1/AUTH_testX-Storage-Token: AUTH_tkf828cc87bb9348168a52619b1f7e3928X-Auth-Token: AUTH_tkf828cc87bb9348168a52619b1f7e3928Content-Length: 0Date: Fri, 07 Oct 2011 07:45:58 GMT
也可以使用-v選項來獲得更詳細的信息:
curl -v -H 'X-Storage-User: test:tester' -H 'X-Storage-Pass: testing' http://127.0.0.1:8080/auth/v1.0
運行結果如下:
* About to connect() to 127.0.0.1 port 8080 (#0)* Trying 127.0.0.1... connected* Connected to 127.0.0.1 (127.0.0.1) port 8080 (#0)> GET /auth/v1.0 HTTP/1.1> User-Agent: curl/7.21.3 (i686-pc-linux-gnu) libcurl/7.21.3 OpenSSL/0.9.8o zlib/1.2.3.4 libidn/1.18> Host: 127.0.0.1:8080> Accept: */*> X-Storage-User: test:tester> X-Storage-Pass: testing> < HTTP/1.1 200 OK< X-Storage-Url: http://127.0.0.1:8080/v1/AUTH_test< X-Storage-Token: AUTH_tkf828cc87bb9348168a52619b1f7e3928< X-Auth-Token: AUTH_tkf828cc87bb9348168a52619b1f7e3928< Content-Length: 0< Date: Fri, 07 Oct 2011 07:48:30 GMT< * Connection #0 to host 127.0.0.1 left intact* Closing connection #0
存儲URL和認證令牌作為響應頭部返回。在認證之后,你可以使用cURL來執行存儲服務上的HEAD,GET,DELETE,POST和PUT請求。
2.確定存儲的使用情況
一個HEAD請求可以發送到存儲服務來確定你已經在系統中存儲了多少數據以及你使用的容器數量。使用-X開關來描述正確的HTTP方法和-D將HTTP響應頭部輸出到終端(stdout)。
Exp2:查詢帳號的存儲使用情況
curl -X HEAD -D - / -H "X-Auth-Token:AUTH_tkf828cc87bb9348168a52619b1f7e3928" / http://127.0.0.1:8080/v1/AUTH_test
新聞熱點
疑難解答