ターゲットグループはターゲットのコレクションです。
|
これらのコマンドは次の URI パラメータを使用します。
|
アプライアンスで使用可能なすべてのターゲットグループを一覧表示します。成功時、HTTP ステータス 200 (OK) が返され、本文にターゲットグループオブジェクトの配列を含む「groups」という名前のプロパティーを持つ JSON オブジェクトが含まれます。
リクエストの例:
GET /api/san/v1/iscsi/target-groups Host: zfs-storage.example.com:215 Authorization: Basic abcd123MWE= 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.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008" ] }, { "href": "/api/san/v1/iscsi/target-groups/alt-group", ... }] }
単一のターゲットグループを取得します。リクエストは、ターゲットグループ名である単一の URI パラメータを取ります。応答本文には、ターゲットグループプロパティーを含む「target-group」という名前の JSON オブジェクトが含まれます。
リクエストの例:
GET /api/san/v1/iscsi/target-groups/test-group Host: zfs-storage.example.com:215 Authorization: Basic abcd123MWE= 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.1986-03.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 abcd123MWE Accept: application/json Content-Type: application/json Content-Length: 97 {"name":"test-group", "targets": ["iqn.1986-03.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.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008"] } }
既存のターゲットグループを削除します。
リクエストの例:
DELETE /api/nas/v1.0/iscsi/target-groups/test-group
delete が成功すると、HTTP ステータス 204 (No Content) を返します。
HTTP/1.1 204 No-Content