由于最近工作需要使用Openstack ,使用cURL操作Openstack對象存儲的ReST API，這是本人找了好多資料完成的，這里記錄下。

使用Openstack ,使用cURL操作Openstack對象存儲的ReST API

     cURL 是一個利用URL語法規(guī)定來傳輸文件和數(shù)據(jù)的工具，支持很多協(xié)議，如HTTP、FTP、TELNET等。本文主要是介紹使用該工具和HTTP協(xié)議與swift服務(wù)如何交互。cURL允許你從命令行或shell腳本傳送和接收HTTP的請求和響應(yīng)。這使得直接與ReST的API工作而無需其他客服端APIs成為可能。本文，我們需要使用到以下的cURL命令行選項(xiàng)：

-X METHOD 描述HTTP的請求方法(HEAD, GET等) 

-D Dump 將HTTP響應(yīng)頭部到stdout.

-H HEADER 描述一個在請求中的HTTP\HTTPS頭部.

-v 使用操作的過程更加詳細(xì)

1.認(rèn)證

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，我們首先需要獲得一個認(rèn)證令牌，用于傳給每個使用X-Auth-Token頭部的請求。以下的例子展示了如何使用cURL來獲得認(rèn)證令牌和存儲系統(tǒng)的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

運(yùn)行結(jié)果如下：

sting' http://127.0.0.1:8080/auth/v1.0
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:45:58 GMT

也可以使用-v選項(xiàng)來獲得更詳細(xì)的信息：

curl -v -H 'X-Storage-User: test:tester' -H 'X-Storage-Pass: testing' http://127.0.0.1:8080/auth/v1.0

運(yùn)行結(jié)果如下：

* 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和認(rèn)證令牌作為響應(yīng)頭部返回。在認(rèn)證之后，你可以使用cURL來執(zhí)行存儲服務(wù)上的HEAD,GET,DELETE,POST和PUT請求。

2.確定存儲的使用情況

一個HEAD請求可以發(fā)送到存儲服務(wù)來確定你已經(jīng)在系統(tǒng)中存儲了多少數(shù)據(jù)以及你使用的容器數(shù)量。使用-X開關(guān)來描述正確的HTTP方法和-D將HTTP響應(yīng)頭部輸出到終端(stdout)。

Exp2:查詢帳號的存儲使用情況

 curl -X HEAD -D - \
 -H "X-Auth-Token:AUTH_tkf828cc87bb9348168a52619b1f7e3928" \
 http://127.0.0.1:8080/v1/AUTH_test

輸出如下：

HTTP/1.1 204 No Content
X-Account-Object-Count: 3
X-Account-Bytes-Used: 92983
X-Account-Container-Count: 4
Accept-Ranges: bytes
Content-Length: 0
Date: Fri, 07 Oct 2011 08:04:38 GMT

HTTP請求必須包含了一個頭部來描述認(rèn)證令牌。在響應(yīng)中的HTTP頭部顯示在該存儲帳號中的容器數(shù)量和整個帳號所存儲的總字節(jié)數(shù)。

3.創(chuàng)建一個存儲容器

    在上傳任何數(shù)據(jù)到OpenStack的對象存儲之前，你必須創(chuàng)建一個存儲容器。你可以使用PUT請求來創(chuàng)建一個容器；cURL也可以用于該目的。

Exp3:創(chuàng)建一個photos的容器

curl -X PUT -D - -H "X-Auth-Token:AUTH_tkf828cc87bb9348168a52619b1f7e3928" http://127.0.0.1:8080/v1/AUTH_test/photos

運(yùn)行結(jié)果如下：

HTTP/1.1 201 Created
Content-Length: 18
Content-Type: text/html; charset=UTF-8
Date: Fri, 07 Oct 2011 08:18:44 GMT

    返回201（Created）的HTTP狀態(tài)代碼表示容器已被成功地創(chuàng)建。

4.上傳一個存儲對象

在創(chuàng)建完一個容器之后，你可以上傳一個本地文件。對于這個例子，我們上傳一張林志玲MM的照片。-T開關(guān)描述到上傳的本地文件的完整路徑。

Exp4:上傳對象

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: 一張關(guān)于林志玲的美圖" \
 http://127.0.0.1:8080/v1/AUTH_test/photos/lzl.jpg

結(jié)果如下：

HTTP/1.1 201 Created
Content-Length: 118
Content-Type: text/html; charset=UTF-8
Etag: 870563216b9f54942fc09d574aa3e2bd
Last-Modified: Fri, 07 Oct 2011 08:39:49 GMT
Date: Fri, 07 Oct 2011 08:39:51 GMT

 5.其他cURL命令

你可以使用cURL工具發(fā)出任何已定義的用于OpenStack對象存儲的ReST方法。例如，你可以使用cURL來發(fā)送POST和DELETE請求即使我們沒有提供的相關(guān)例子。比如，下載剛才上傳的照片：

curl -X GET -H "X-Auth-Token: AUTH_tkf828cc87bb9348168a52619b1f7e3928" http://127.0.0.1:8080/v1/AUTH_test/photos/lzl.jpg >td_lzl.jpg

注意：一般地，你每次調(diào)用curl來執(zhí)行一個操作，系統(tǒng)就會創(chuàng)建一個獨(dú)立的TCP/IP和SSL連接（https）然后丟棄。然而，使用語言的APIs是設(shè)計(jì)用來重用這些在操作之間的連接，因此提供了更好的細(xì)嫩。我們推薦在你的產(chǎn)品應(yīng)用中使用一種支持語言的APIs并且限制curl僅用來快速和簡單地測試/診斷。

 感謝閱讀，希望能幫助到大家，謝謝大家對本站的支持！

最新評論