启动器组

iSCSI 启动器命令用于管理设备上的 iSCSI 启动器和 iSCSI 启动器组。下表中列出了可用命令。

表 47  启动器组命令

请求 路径 /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 参数。

表 48  URI 参数

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

每个启动器组都有 "name" 属性和 "initiators" 属性，后者包含启动器组中的启动器的列表。

列出启动器组

列出所有可用的 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"
    }]
}

获取启动器组详细信息

从单个 iSCSI 启动器组中获取详细信息。可根据列出启动器组命令中返回的 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"
    }
}

创建启动器组

创建无成员的 iSCSI 启动器组。请求正文包含带单个 "name" 参数的 JSON 对象，此参数包含组名称。

表 49  启动器组创建属性

属性 类型 描述 name 字符串 启动器组的名称 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 /api/san/v1.0/iscsi/initiator-groups/group-01 HTTP/1.1
Host: zfs-storage.example.com:215

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

HTTP/1.1 204 No-Content