Skip to main content
Element Software
本产品推出了新版本。
简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

CreateInitiators

贡献者
PDF

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

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

参数

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

名称 说明 键入 默认值 必填

启动程序

包含每个新启动程序特征的对象列表。对象：

  • alias：(可选)要分配给此启动程序的友好名称。string

  • attributes：(可选)要分配给此启动程序的一组JSON属性。（ JSON 对象）

  • chapUsername:(可选)此启动程序的唯一CHAP用户名。如果在创建期间未指定启动程序名称（ IQN ），并且 requireChap 为 true ，则默认为启动程序名称（ IQN ）。string

  • initiatorSecret：(可选)用于对启动程序进行身份验证的CHAP密钥。如果在创建期间未指定此密钥，并且 requireChap 为 true ，则默认为随机生成的密钥。string

  • name：(必需)要创建的启动程序的名称(IQN或WWPN)。string

  • requireChap：(可选)如果此启动程序在会话登录期间需要CHAP、则为True。boolean

  • targetSecret：(可选)用于对目标进行身份验证的CHAP密钥(使用相互CHAP身份验证时)。如果在创建期间未指定此密钥，并且 requireChap 为 true ，则默认为随机生成的密钥。string

  • virtualNetworkIDs：(可选)与此启动程序关联的虚拟网络标识符列表。如果定义了一个或多个虚拟网络，则此启动程序只能登录到这些虚拟网络。如果不定义任何虚拟网络，此启动程序可以登录到所有网络。

  • volumeAccessGroupID：(可选)要将此新创建的启动程序添加到的卷访问组的ID。整型

JSON 对象数组

无

是

返回值

此方法具有以下返回值：

名称

说明

键入

启动程序

描述新创建启动程序的对象列表。

启动程序阵列

错误

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

名称

说明

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

了解更多信息

ListInitiators