目标组

语言：

目标组是目标的集合。下表中列出了目标组命令。

目标组命令使用以下 URI 参数：

protocol: 启动器的 NAS 协议：fc、iscsi 或 srp
target-group: 目标组的名称

表 54 目标组命令

请求	附加到路径 /san/v1.0	说明
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`	销毁指定的目标组对象

列出目标组

列出设备上所有可用的目标组。成功后，将返回 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.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 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.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 abcd123MWE
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/nas/v1.0/iscsi/target-groups/test-group

成功删除后将返回 HTTP 状态 204 (No Content)：

HTTP/1.1 204 No-Content