ModifyVolumeAccessGroup

您可以使用 ModifyVolumeAccessGroup 方法更新启动程序以及在卷访问组中添加或删除卷。

如果指定的启动程序或卷与现有启动程序或卷重复,则卷访问组保留不变。如果您未指定卷或启动程序的值,则当前启动程序和卷列表不会发生变化。

您也可以使卷访问组与某个虚拟网络关联起来。这种关联将应用于卷访问组中的所有卷。

参数

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

名称 说明 类型 默认值 必需
volumeAccessGroupID 要修改的卷访问组的 ID。 整型
name 此卷访问组的新名称。 字符串
attributes 名称-值对的列表,采用 JSON 对象格式。 JSON 对象
initiators 列出要包括在卷访问组中的启动程序 ID 或名称(IQN 和 WWPN)。如果传递启动程序名称列表,但不存在相关启动程序,则会创建这些启动程序。如果传递启动程序 ID 列表,但不存在任何启动程序,则该方法将返回错误。传递启动程序名称已弃用;您应尽可能使用启动程序 ID。 整型数组(建议)或字符串数组(已弃用)
deleteOrphanInitiators 指定是否在启动程序对象从卷访问组中删除之后删除这些对象。可能值:
  • true:在启动程序对象从卷访问组中删除之后,删除这些对象。
  • false:在启动程序对象从卷访问组中删除之后,不删除这些对象。这是默认值。
布尔型 false
volumes 要修改的卷的卷 ID 列表。 整型数组 volumeAccessGroup

返回值

此方法具有以下返回值:

名称 说明 类型
volumeAccessGroup 包含新修改的卷访问组相关信息的对象。 volumeAccessGroup

请求示例

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

{
   "method": "ModifyVolumeAccessGroup",
   "params": {
      "volumeAccessGroupID": 96,
      "name": "accessgrouptest",
      "initiators": [115,114],
      "volumes": [
         346
    ],
      "attributes": {}
   }
}

响应示例

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

{
  "id": null,
  "result": {
    "volumeAccessGroup": {
      "attributes": {},
      "deletedVolumes": [
        327
      ],
      "initiatorIDs": [
        114,
        115
      ],
      "initiators": [
        "iqn.1998-01.com.vmware:desk1-esx1-577b283a",
        "iqn.1998-01.com.vmware:donesq-esx1-421b281b"
      ],
      "name": "accessgrouptest",
      "volumeAccessGroupID": 96,
      "volumes": [
        346
      ]
    }
  }
}

发布以下版本后新增

9.6