ListInitiators

您可以使用 ListInitiators 方法获取启动程序 IQN 或全球通用端口名称 (World Wide Port Name, WWPN) 的列表。

参数

此方法具有以下输入参数：

名称	说明	类型	默认值	必需
initiators	要检索的启动程序 ID 列表。您可以应用此参数或 startInitiatorID 参数，但不能同时应用这两个参数。	整型数组	无	否
startInitiatorID	列表开头处的启动程序 ID。您可以应用此参数或 initiators 参数，但不能同时应用这两个参数。	整型	0	否
limit	要返回的启动程序对象的最大数量。	整型	（无限制）	否

返回值

此方法具有以下返回值：

名称	说明	类型
initiators	启动程序信息列表。	initiator 数组

异常

此方法可能存在以下异常：

名称	说明
xInvalidParameter	如果将 startInitiatorID 和 initiators 参数包含在同一方法调用中，则会引发此异常。

请求示例

此方法的请求类似于以下示例：

{
   "method": "ListInitiators",
   "params": {},
   "id" : 1
}

响应示例

此方法返回类似于以下示例的响应：

{
  "id": 1,
  "result": {
    "initiators": [
      {
        "alias": "",
        "attributes": {},
        "initiatorID": 2,
        "initiatorName": "iqn.1993-08.org.debian:01:c84ffd71216",
        "volumeAccessGroups": [
          1
        ]
      }
    ]
  }
}