OSDN -- 开发和下载开源软件
简体中文翻译状态 translation status for zh
edit | Title Index |  Recent Changes  | 
  • Showing Page History #100786

lxcficon.jpg LXCFのREST-API

元のページに戻る

LXCFのREST-API

REST APIは、WebのプロトコルHTTPを使ったネットワーク経由のインタフェースです。
次のような特徴を持ちます。

- ステートレスなクライアント/サーバプロトコル
- すべてのリソースに適用できる操作セット
- すべてのリソースは URI で表される一意的なアドレスを持つ
- アプリケーションの情報と状態遷移の両方を扱う

LXCFのREST APIは、主にHTTPのPOSTとGETの操作を使用します。
また、APIの発行時にはパスワードを付けてPOSTを行います。パスワードは空にすることができます。

1. Browseable REST API

LXCFのAPI操作は、HTTPのPOST操作とGET操作を使用します。
POST操作でAPIの発行をします。
GET操作では、POST操作のためのhtmlを返します。

curlのようなネットワークツールを使用する場合には、POST操作だけでAPIを操作できます。
たとえば、コンテナの一覧を表示するlistは以下のようにします。

POST操作

$ curl -F " passwd='' "  http://アドレス:ポート/lxcfv1/list

しかし、FireFoxのようなブラウザでもLXCFの操作が可能になります。
ブラウザでアドレスバーに、REST APIを入力してEnterキーを押すと、GETが発行され、POST操作のための画面が表示されます。
アドレスバーには、"http://アドレス:ポート/lxcfv1/list"と入力します。

lxcf-list-get.jpg
この画面上でパスワードを入力して、ボタンを押すと、アドレスバーに入力したAPIが発行されます。

lxcf-list-post.jpg
簡単なGUIのように、ブラウザだけでLXCFを操作できます。

このようなREST APIを、ここでは「Browseable REST API」と呼びます。

2. Browseable REST APIサービスの起動

Browseable REST APIは、デフォルトでは無効になっています。
Browseable REST APIを有効にするには、lxcf-apiサービスを起動する必要があります。
systemdまたはupstartのlxcf-apiサービスは、"lxcf api enable"コマンドで有効になります。

# lxcf api enable

また、Browseable REST APIのアドレスとポート番号は、/etc/lxcf/lxcf.confで定義します。
初期値はlocalhostと8080が設定されています。

#
# IP address and port for REST API
#
[rest_api]
ipaddr=localhost
port=8080
localhostが設定されていると、外部からはアクセスできません。
外部から接続するには、接続可能なIPアドレスかドメイン名を設定する必要があります。

一度enabledにすれば、システムをrebootしてもenabledのままです。
Browseable REST APIをdisabledにするには、"lxcf api disable"コマンドを使います。

# lxcf api disable

3. Browseable REST APIの認証

Browseable REST APIのパスワードは以下のように"lxcf api-passwd"コマンドで設定します。

# lxcf api-passwd
New password: 
Retype new password:

エンターキーだけを押すと、パスワードは空になります。

4. Browseable REST API リクエストの送信

LXCFのREST APIは、主にHTTPのPOSTとGETの操作を使用します。
また、APIの発行時にはパスワードを付けてPOSTを行います。パスワードは空にすることもできます。
REST APIを発行するときのURLのパスでAPIは規定されます。
URLは以下のような形式です。

 http://アドレス:ポート番号/lxcfv1/APIのパス

APIのパスは、lxcfコマンドで実行するときの空白を'/'に変えたものを指定します。
たとえば、a-srvというコンテナを作るコマンドは以下です。

 # lxcf sysgen a-srv

これと同じ指定をREST APIで行う場合は以下です。

 http://アドレス:ポート番号/lxcfv1/sysgen/a-srv

5. Browseable REST APIのデータ形式

Brouseable REST APIの返すデータ形式は以下のような形式です。

<html>
<head>
ｈｔｍｌヘッド情報
</head>
<body>
<pre>
  status=ステータス番号
  返りメッセージ
</pre>
POST用html
</body>
</html>

ほとんどは、POST操作用のフォームを表示するためのHTML情報です。
大事なのは、その中の以下です。

  status=ステータス番号
  返りメッセージ

ステータス番号は、正常ならば0が設定されています。
それ以外の値はエラーを示します。
帰りメッセージは、実行結果のメッセージが表示されます。

たとえば、次はlistのAPIの結果です。 

<html>
<head><title>LXCF API</title>
<meta http-equiv="Content-type" content="text/html; charset=utf-8">
</head>
<body>
<pre>
status=0
Name		Mode    	State	  Autostart    Path
-------------------------------------------------------------------------
a-srv		joint    	stopped	  n	      /opt/lxcf/a-srv
a0001		joint    	stopped	  n	      /opt/lxcf/a0001
</pre>
<HR><form action="http://localhost:8080/lxcfv1/list" method="POST" AcceptEncoding="utf-8">
<dl>
<dt>password</dt>
<dd><input type="password" name="password" value=""/></dd>
</dl>
<input type="submit" name="save" value="Execution" />
</form></body></html>

<pre>から</pre>までが、APIの結果を示します。

6. コマンドラインクライアント

ブラウザを使わないで、コマンドラインからcurlコマンドでREST APIを操作しましょう。 curlのようなネットワークツールを使用する場合には、POST操作だけでAPIを操作できます。

POST操作

$ curl -F " passwd=''パスワード "   URL

URLは以下のような形式です。 


 http://アドレス:ポート番号/lxcfv1/APIのパス

APIのパスは、lxcfコマンドで実行するときの空白を'/'に変えたものを指定します。

実行結果は<pre> 〜 </pre>に囲まれているので、たとえば以下のようにすると簡単に取り出せます。

 $ curl -F " passwd=''パスワード "   URL  |   awk 'BEGIN{f=1}{if ($0~/pre/){f=f*(-1)}else if (f == -1) print}'

これらを組み合わせれば、シェルスクリプトで簡単にLXCFを操作する運用プログラムを作成できることでしょう。

Python, Perl, C言語のネットワークプログラムからも同様に扱えます。

7. Browseable REST APIの一覧

元のページに戻る