CreateVolumeAccessGroup

您可以使用 CreateVolumeAccessGroup 创建新的卷访问组。创建卷访问组时，您需要为其提供名称，还可以为其输入启动程序和卷。

添加到卷访问组中的任何启动程序 IQN 可以访问组中的任何卷，而无需 CHAP 身份验证。

注：克隆的卷不会继承源卷的卷访问组成员资格。

创建卷访问组时，请考虑以下事项：

一个卷访问组最多可以包含 64 个启动程序 IQN。
一个启动程序只能属于一个卷访问组。
一个卷访问组最多可以包含 2000 个卷。
每个卷访问组最多可以属于四个其他卷访问组。

参数

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

名称	说明	类型	默认值	必需
initiators	列出要包括在卷访问组中的启动程序 ID 或名称（IQN 和 WWPN）。如果传递启动程序名称列表，但不存在相关启动程序，则会创建这些启动程序。如果传递启动程序 ID 列表，但不存在任何启动程序，则该方法将返回错误。传递启动程序名称已弃用；您应尽可能使用启动程序 ID。	整型数组或字符串数组（已弃用）	[]	否
name	卷访问组的名称。此名称不必唯一，但建议使用唯一名称。长度必须是 1 到 64 个字符。	字符串	无	是
volumes	列出要包括在卷访问组中的卷 ID。	整型数组	[]	否
attributes	名称-值对的列表，采用 JSON 对象格式。	JSON 对象	{}	否

返回值

此方法具有以下返回值：

名称	说明	类型
volumeAccessGroup	包含新创建的卷访问组的相关信息的对象。	volumeAccessGroup
volumeAccessGroupID	新创建的卷访问组的 ID。	整型

请求示例

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

{
   "method": "CreateVolumeAccessGroup",
   "params": {
      "name": "myaccessgroup",
      "initiators": ["iqn.1993-08.org.debian: 01: a31b1d799d5c"],
      "volumes": [327],
      "attributes": {}
   }
}

响应示例

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

{
  "id": null,
  "result": {
    "volumeAccessGroup": {
      "attributes": {},
      "deletedVolumes": [],
      "initiatorIDs": [
        95
      ],
      "initiators": [
        "iqn.1993-08.org.debian: 01: a31b1d799d5c"
      ],
      "name": "myaccessgroup",
      "volumeAccessGroupID": 96,
      "volumes": [
        327
      ]
    },
    "volumeAccessGroupID": 96
  }
}