CreateInitiators

您可以使用 CreateInitiators 创建多个新启动程序 IQN 或全球通用端口名称 (World Wide Port Name, WWPN)，也可以为其分配别名和属性。使用 CreateInitiators 创建新启动程序时，也可以将这些启动程序添加到卷访问组中。

如果该操作无法创建该参数中提供的某个启动程序，则该方法将返回错误且不会创建任何启动程序（即无法创建一部分启动程序）。

参数

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

名称	说明	类型	默认值	必需
initiators	包含每个新启动程序的特性的对象列表。对象： alias：（可选）要分配给此启动程序的友好名称。（字符串） attributes：（可选）要分配给此启动程序的一组 JSON 属性。（JSON 对象） chapUsername：（可选）此启动程序的唯一 CHAP 用户名。如果在创建期间未指定此名称，并且 requireChap 为 true，则默认为此启动程序名称 (IQN)。（字符串） initiatorSecret：（可选）用于对此启动程序进行身份验证的 CHAP 密钥。如果在创建期间未指定此密钥，并且 requireChap 为 true，则默认为一个随机生成的密钥。（字符串） name：（必需）要创建的启动程序的名称（IQN 或 WWPN）。（字符串） requireChap：（可选）如果在会话登录期间需要对此启动程序使用 CHAP，则为 True。（布尔值） targetSecret：（可选）用于对目标进行身份验证的 CHAP 密钥（使用相互 CHAP 身份验证时）。如果在创建期间未指定此密钥，并且 requireChap 为 true，则默认为一个随机生成的密钥。（字符串） volumeAccessGroupID：（可选）要将此新创建的启动程序添加到的卷访问组的 ID。（整型）	JSON 对象数组	无	是

返回值

此方法具有以下返回值：

名称	说明	类型
initiators	一个对象列表，用于描述新创建的启动程序。	initiator 数组

错误

此方法可能返回以下错误：

名称	说明
xInitiatorExists	如果所选的启动程序名称已存在，则返回此错误。

请求示例

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

{
  "id": 3291,
  "method": "CreateInitiators",
  "params": {
    "initiators": [
      {
        "name": "iqn.1993-08.org.debian:01:288170452",
        "alias": "example1"
      },
      {
        "name": "iqn.1993-08.org.debian:01:297817012",
        "alias": "example2"
      }
    ]
  }
}

响应示例

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

{
  "id": 3291,
  "result": {
    "initiators": [
      {
        "alias": "example1",
        "attributes": {},
        "initiatorID": 145,
        "initiatorName": "iqn.1993-08.org.debian:01:288170452",
        "volumeAccessGroups": []
      },
      {
        "alias": "example2",
        "attributes": {},
        "initiatorID": 146,
        "initiatorName": "iqn.1993-08.org.debian:01:297817012",
        "volumeAccessGroups": []
      }
    ]
  }
}

发布以下版本后新增

9.6