ターゲットグループ

言語:

ターゲットグループはターゲットのコレクションです。ターゲットグループコマンドを以下の表に示します。

ターゲットグループコマンドは次の URI パラメータを取ります。

protocol: イニシエータ用の NAS プロトコル: fc、iscsi、または srp
target-group: ターゲットグループの名前

表 39 ターゲットグループのコマンド

リクエスト	パス /san/v{1\|2} の後ろに追加	説明
GET	/`protocol`/target-groups	指定されたプロトコル (`fc`、`iscsi`、`srp`) オブジェクトのすべての SAN ターゲットグループを一覧表示します
GET	/`protocol`/target-groups/`target-group`	指定されたプロトコル (`fc`、`iscsi`、`srp`) プロパティーの指定された SAN ターゲットグループを取得します
POST	/`protocol`/target-groups	指定されたプロトコル (`fc`、`iscsi`、`srp`) の新しい SAN ターゲットグループを作成します
PUT	/`protocol`/target-groups/`target-group`	指定されたプロトコル (`fc`、`iscsi`、`srp`) オブジェクトの指定された SAN ターゲットグループを変更します
DELETE	/`protocol`/target-groups/`target-group`	指定された target-group オブジェクトを破棄します

ターゲットグループの一覧表示

アプライアンスで使用可能なすべてのターゲットグループを一覧表示します。成功時、HTTP ステータス 200 (OK) が返され、本文にターゲットグループオブジェクトの配列を含む groups という名前のプロパティーを持つ JSON オブジェクトが含まれます。

リクエストの例:

GET /api/san/v1/iscsi/target-groups
Host: zfs-storage.example.com:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: application/json

結果例:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 237

{
    "groups": [{
        "href": "/api/san/v1/iscsi/target-groups/test-group",
        "name": "test-group",
        "targets": [
            "iqn.zfs-storage.example.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008"
        ]
    }, {
        "href": "/api/san/v1/iscsi/target-groups/alt-group",
        ...
    }]
}

ターゲットグループの取得

単一のターゲットグループを取得します。リクエストは、ターゲットグループ名である単一の URI パラメータを取ります。応答本文には、ターゲットグループプロパティーを含む group という名前の JSON オブジェクトプロパティーが含まれます。

リクエストの例:

GET /api/san/v1/iscsi/target-groups/test-group
Host: zfs-storage.example.com:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: application/json

結果例:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "group": {
        "href": "/api/san/v1/iscsi/target-groups/test-group",
        "name": "test-group",
        "targets": [
            "iqn.zfs-storage.example.com.sun:02:0d5a0ed8-44b6-49f8-a594-872bf787ca5a"]
    }
}

ターゲットグループの作成

新しい iSCSI ターゲットグループを作成します。リクエスト本文は、新しいグループの名前である単一の name プロパティーを持つ JSON オブジェクトです。

リクエストの例:

POST /api/san/v1/iscsi/target-groups HTTP/1.1
Host: zfs-storage.example.com:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: application/json
Content-Type: application/json
Content-Length: 97

{"name":"test-group",
 "targets": ["iqn.zfs-storage.example.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008"]}

結果例:

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 154
X-Zfssa-San-Api: 1.0
Location: /api/san/v1/iscsi/target-groups/test-group

{
    "group": {
        "href": "/api/san/v1/iscsi/target-groups/test-group",
        "name": "test-group",
        "targets": [
            "iqn.zfs-storage.example.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008"]
    }
}

ターゲットグループの削除

既存のターゲットグループを削除します。

リクエストの例:

DELETE /api/san/v1.0/iscsi/target-groups/test-group

削除に成功すると、HTTP ステータス 204 (No Content) が返されます。

HTTP/1.1 204 No-Content