Skip to main content
Element Software
12.5 and 12.7
简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。

CreateInitiators

贡献者

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

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

参数

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

Name Description Type 默认值 Required

启动程序

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

  • 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

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

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

JSON 对象数组

是的。

返回值

此方法具有以下返回值:

Name

Description

Type

启动程序

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

启动程序 数组

error

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

Name

Description

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

了解更多信息