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

ModifyInitiators

贡献者
PDF

您可以使用 `ModifyInitiators`方法更改一个或多个现有启动程序的属性。

您不能更改现有启动程序的名称。如果需要更改启动程序的名称、请先使用方法将其删除、然后使用方法创建一个新CreateInitiators启动程序DeleteInitiators。

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

参数

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

名称

说明

键入

默认值

必填

启动程序

包含要修改的每个启动程序的特性的对象列表。可能的对象：

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

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

  • chapUsername：(可选)此启动程序的新唯一CHAP用户名。string

  • forceDuringUpgrade：在升级期间完成启动程序修改。

  • initiatorID：(必需)要修改的启动程序的ID。整型

  • initiatorSecret：(可选)用于对启动程序进行身份验证的新CHAP密钥。string

  • requireChap：(可选)如果此启动程序需要CHAP、则为True。boolean

  • targetSecret：(可选)用于对目标进行身份验证的新CHAP密钥(使用相互CHAP身份验证时)。string

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

  • volumeAccessGroupID：(可选)应将启动程序添加到的卷访问组的ID。如果启动程序先前位于其他卷访问组中，则会将其从旧卷访问组中删除。如果此密钥存在但为空，则启动程序将从其当前卷访问组中删除，但不会放置在任何新的卷访问组中。整型

JSON 对象数组

无

是

返回值

此方法具有以下返回值：

名称

说明

键入

启动程序

描述新修改的启动程序的对象列表。

启动程序阵列

请求示例

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

{
  "id": 6683,
  "method": "ModifyInitiators",
  "params": {
    "initiators": [
      {
        "initiatorID": 2,
        "alias": "alias1",
        "volumeAccessGroupID": null
      },
      {
        "initiatorID": 3,
        "alias": "alias2",
        "volumeAccessGroupID": 1
      }
    ]
  }
}

响应示例

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

{
  "id": 6683,
  "result": {
    "initiators": [
      {
        "alias": "alias1",
        "attributes": {},
        "initiatorID": 2,
        "initiatorName": "iqn.1993-08.org.debian:01:395543635",
        "volumeAccessGroups": []
      },
      {
        "alias": "alias2",
        "attributes": {},
        "initiatorID": 3,
        "initiatorName": "iqn.1993-08.org.debian:01:935573135",
        "volumeAccessGroups": [
          1
        ]
      }
    ]
  }
}

自版本以来的新增功能

9.6

了解更多信息