由于最近工作需要使用Openstack ,使用cURL操作Openstack對象存儲的ReST API，這是本人找了好多資料完成的，這里記錄下。
使用Openstack ,使用cURL操作Openstack對象存儲的ReST API
cURL 是一個利用URL語法規定來傳輸文件和數據的工具，支持很多協議，如HTTP、FTP、TELNET等。本文主要是介紹使用該工具和HTTP協議與swift服務如何交互。cURL允許你從命令行或shell腳本傳送和接收HTTP的請求和響應。這使得直接與ReST的API工作而無需其他客服端APIs成為可能。本文，我們需要使用到以下的cURL命令行選項：
|
1
2
3
4
5
6
7
|
-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
運行結果如下：
|
1
2
3
4
5
6
7
|
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
運行結果如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
* 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:查詢帳號的存儲使用情況
|
1
2
3
|
curl -X HEAD -D - \-H "X-Auth-Token:AUTH_tkf828cc87bb9348168a52619b1f7e3928" \http://127.0.0.1:8080/v1/AUTH_test |
輸出如下：
|
1
2
3
4
5
6
7
|
HTTP/1.1 204 No ContentX-Account-Object-Count: 3X-Account-Bytes-Used: 92983X-Account-Container-Count: 4Accept-Ranges: bytesContent-Length: 0Date: Fri, 07 Oct 2011 08:04:38 GMT |
HTTP請求必須包含了一個頭部來描述認證令牌。在響應中的HTTP頭部顯示在該存儲帳號中的容器數量和整個帳號所存儲的總字節數。
3.創建一個存儲容器
在上傳任何數據到OpenStack的對象存儲之前，你必須創建一個存儲容器。你可以使用PUT請求來創建一個容器；cURL也可以用于該目的。
Exp3:創建一個photos的容器
curl -X PUT -D - -H "X-Auth-Token:AUTH_tkf828cc87bb9348168a52619b1f7e3928" http://127.0.0.1:8080/v1/AUTH_test/photos
運行結果如下：
|
1
2
3
4
|
HTTP/1.1 201 CreatedContent-Length: 18Content-Type: text/html; charset=UTF-8Date: Fri, 07 Oct 2011 08:18:44 GMT |
返回201（Created）的HTTP狀態代碼表示容器已被成功地創建。
4.上傳一個存儲對象
在創建完一個容器之后，你可以上傳一個本地文件。對于這個例子，我們上傳一張林志玲MM的照片。-T開關描述到上傳的本地文件的完整路徑。
Exp4:上傳對象
|
1
2
3
4
5
|
curl -X PUT -T /home/swift/下載/lzl.jpg -D - \ -H "Content-Type: image/jpeg" \ -H "X-Auth-Token: AUTH_tkf828cc87bb9348168a52619b1f7e3928" \ -H "X-Object-Meta-lzl: 一張關于林志玲的美圖" \ http://127.0.0.1:8080/v1/AUTH_test/photos/lzl.jpg |
結果如下：
|
1
2
3
4
5
6
|
HTTP/1.1 201 CreatedContent-Length: 118Content-Type: text/html; charset=UTF-8Etag: 870563216b9f54942fc09d574aa3e2bdLast-Modified: Fri, 07 Oct 2011 08:39:49 GMTDate: Fri, 07 Oct 2011 08:39:51 GMT |
5.其他cURL命令
你可以使用cURL工具發出任何已定義的用于OpenStack對象存儲的ReST方法。例如，你可以使用cURL來發送POST和DELETE請求即使我們沒有提供的相關例子。比如，下載剛才上傳的照片：
curl -X GET -H "X-Auth-Token: AUTH_tkf828cc87bb9348168a52619b1f7e3928" http://127.0.0.1:8080/v1/AUTH_test/photos/lzl.jpg >td_lzl.jpg
注意：一般地，你每次調用curl來執行一個操作，系統就會創建一個獨立的TCP/IP和SSL連接（https）然后丟棄。然而，使用語言的APIs是設計用來重用這些在操作之間的連接，因此提供了更好的細嫩。我們推薦在你的產品應用中使用一種支持語言的APIs并且限制curl僅用來快速和簡單地測試/診斷。
感謝閱讀，希望能幫助到大家，謝謝大家對本站的支持！
原文鏈接：http://www.cnblogs.com/yuxc/archive/2011/10/07/2200656.html
