iSCSI イニシエータコマンドはアプライアンス上の iSCSI イニシエータと iSCSI イニシエータグループの管理に使用します。使用可能なコマンドを次の表に示します。
|
これらのコマンドは次の URI パラメータを使用します。
|
各イニシエータグループにはイニシエータグループのイニシエータのリストを含む「name」プロパティーと「initiators」プロパティーがあります。
使用可能なすべての iSCSI イニシエータグループを一覧表示します。成功時、HTTP ステータス 200 (OK) が返され、本文にイニシエータグループオブジェクトの配列を含む「groups」という名前のプロパティーを持つ JSON オブジェクトが含まれます。
リクエストの例:
GET /api/san/v1/iscsi/initiator-groups HTTP/1.1 Host: zfs-storage.example.com Accept: application/json
レスポンスの例:
HTTP/1.1 200 OK Content-Type: application/json { "groups": [{ "href": "/san/v1/iscsi/initiator-groups/aktest-initiators-0", "initiators": ["iqn.1986-03.com.sun:0"], "name": "aktest-initiators-0" }, { "href": "/san/v1/iscsi/initiator-groups/aktest-initiators-1", "initiators": ["iqn.1986-03.com.sun:1"], "name": "aktest-initiators-1" }] }
単一の iSCSI イニシエータグループから詳細情報を取得します。グループには list initiator group コマンドで返された href プロパティーに従ってアクセスできます。
リクエストの例:
GET /api/san/v1/iscsi/initiator-groups/test-group HTTP/1.1 Host: zfs-storage.example.com Accept: application/json
レスポンスの例:
HTTP/1.1 200 OK Content-Type: application/json { "group": { "href": "/api/san/v1/iscsi/initiator-groups/test-group" "initiators": ["iqn.1986-03.com.sun:02:01"], "name": "test-group" } }
メンバーを含まない iSCSI イニシエータグループを作成します。リクエスト本文には、グループ名を含む単一の「name」パラメータを持つ JSON オブジェクトが含まれます。
|
リクエストの例:
POST /api/san/v1/iscsi/initiator-groups HTTP/1.1 Host: zfs-storage.example.com Content-Type: application/json Content-Length: 64 Accept: application/json { "name":"group-01", "initiators": ["iqn.1986-03.com.sun:02"] }
レスポンスの例:
HTTP/1.1 201 Created Content-Type: application/json Location: /api/san/v1/iscsi/initiator-groups/test-group { "group": { "href": "/api/san/v1/iscsi/initiator-groups/test-group", "initiators": ["iqn.1986-03.com.sun:02"], "name": "group-01" } }
アプライアンスからイニシエータグループを削除します。
リクエストの例:
DELETE /api/san/v1.0/iscsi/initiator-groups/group-01 HTTP/1.1 Host: zfs-storage.example.com:215
delete が成功すると、HTTP ステータス 204 (No Content) を返します。
HTTP/1.1 204 No-Content