Go to main content
Oracle® ZFS Storage Appliance RESTful API ガイド、Release OS8.6.x

印刷ビューの終了

更新: 2016 年 9 月
 
 

イニシエータグループ

iSCSI イニシエータコマンドはアプライアンス上の iSCSI イニシエータと iSCSI イニシエータグループの管理に使用します。使用可能なコマンドを次の表に示します。

表 50  イニシエータグループコマンド
リクエスト
パス /san/v1.0
説明
GET
/<protocol>/initiator-groups
指定されたプロトコル (FC、iSCSI、SRP) オブジェクトのすべての SAN イニシエータグループを一覧表示します
GET
/<protocol>/initiator-groups /<name>
指定されたプロトコル (FC、iSCSI、SRP) プロパティーの指定された SAN イニシエータグループを取得します
POST
/<protocol>/initiator-groups
指定されたプロトコル (FC、iSCSI、SRP) の新しい SAN イニシエータグループを作成します
PUT
/<protocol>/initiator-groups /<name>
指定されたプロトコル (FC、iSCSI、SRP) オブジェクトの指定された SAN イニシエータグループを変更します
DELETE
/<protocol>/initiator-groups /<name>
指定された名前オブジェクトを破棄します

これらのコマンドは次の URI パラメータを使用します。

表 51  URI パラメータ
名前
説明
protocol
イニシエータ (FC、iSCSI、SRP) の NAS プロトコル
name
イニシエータグループの名前。

各イニシエータグループにはイニシエータグループのイニシエータのリストを含む「name」プロパティーと「initiators」プロパティーがあります。

List Initiator Groups

使用可能なすべての 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"
    }]
}

Get Initiator Group Details

単一の 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"
    }
}

Create an Initiator Group

メンバーを含まない iSCSI イニシエータグループを作成します。リクエスト本文には、グループ名を含む単一の「name」パラメータを持つ JSON オブジェクトが含まれます。

表 52  イニシエータグループ作成プロパティー
プロパティー
説明
name
string
イニシエータグループの名前
initiators
配列
既存のイニシエータ IQN プロパティーの配列

リクエストの例:

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 an Initiator Group

アプライアンスからイニシエータグループを削除します。

リクエストの例:

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