目标组

目标组是目标的集合。

表 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> 销毁指定的目标组对象

这些命令使用以下 URI 参数。

表 55  URI 参数

名称 描述 protocol 启动器的 NAS 协议（FC、iSCSI、SRP） name 目标组的名称

列出目标组

列出设备上所有可用的目标组。成功后，将返回 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

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

HTTP/1.1 204 No-Content