启动器组

语言：

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

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

protocol: 启动器的 NAS 协议：fc、iscsi 或 srp
name: 启动器组的名称

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

表 34 启动器组命令

请求	附加到路径 /san/v{1\|2}	说明
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`	销毁指定的名称对象

列出启动器组

列出所有可用的 iSCSI 启动器组。成功后，将返回 HTTP 状态 200 (OK)，并且正文包含属性名为 "groups" 的 JSON 对象，此对象包含启动器组对象的数组。

请求示例：

GET /api/san/v1/iscsi/initiator-groups HTTP/1.1
Host: zfs-storage.example.com:215
Accept: application/json

结果示例：

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

{
    "groups": [{
        "href": "/san/v1/iscsi/initiator-groups/p1-initiators-0",
        "initiators": ["iqn.zfs-storage.example.com.sun:0"],
        "name": "p1-initiators-0"
    }, {
        "href": "/san/v1/iscsi/initiator-groups/p1-initiators-1",
        "initiators": ["iqn.zfs-storage.example.com.sun:1"],
        "name": "p1-initiators-1"
    }]
}

获取启动器组详细信息

从单个 iSCSI 启动器组中获取详细信息。可根据列出启动器组命令中返回的 href 属性访问此组。

请求示例：

GET /api/san/v1/iscsi/initiator-groups/test-group HTTP/1.1
Host: zfs-storage.example.com:215
Accept: application/json

结果示例：

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

{
    "group": {
        "href": "/api/san/v1/iscsi/initiator-groups/test-group"
        "initiators": ["iqn.zfs-storage.example.com.sun:02:01"],
        "name": "test-group"
    }
}

创建启动器组

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

表 35 启动器组创建属性

属性	类型	说明
`name`	string	启动器组的名称
`initiators`	array	现有启动器 IQN 属性的数组

请求示例：

POST /api/san/v1/iscsi/initiator-groups HTTP/1.1
Host: zfs-storage.example.com:215
Content-Type: application/json
Content-Length: 64
Accept: application/json

{
   "name":"group-01",
   "initiators": ["iqn.zfs-storage.example.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.zfs-storage.example.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