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