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

CreateVolumeAccessGroup

贡献者
PDF

您可以使用 CreateVolumeAccessGroup 创建新的卷访问组。创建卷访问组时，需要为其指定一个名称，您也可以输入启动程序和卷。

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

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

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

  • 一个卷访问组最多可以包含 64 个启动程序 IQN 。

  • 一个启动程序只能属于一个卷访问组。

  • 一个卷访问组最多可以包含 2000 个卷。

  • 每个卷访问组最多可以属于四个卷访问组。

Parameters

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

Name Description Type 默认值 Required

启动程序

要包括在卷访问组中的启动程序 ID 或名称（ IQN 和 WWPN ）的列表。如果传递启动程序名称列表，则会创建不存在的启动程序。如果传递启动程序 ID 列表，则如果任何启动程序尚不存在，则该方法将返回错误。传递启动程序名称已弃用；应尽可能使用启动程序 ID 。

整型数组或字符串数组（已弃用）

否

name

卷访问组的名称。不需要唯一，但建议使用。长度必须为 1 到 64 个字符。

string

无

是的。

volumes

要包括在卷访问组中的卷 ID 列表。

整型数组

否

属性

名称 - 值对列表，采用 JSON 对象格式。

JSON 对象

｛ ｝

否

返回值

此方法具有以下返回值：

Name

Description

Type

卷访问组

一个对象，其中包含有关新创建的卷访问组的信息。

卷访问组

卷访问组 ID

新创建的卷访问组的 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
  }
}

自版本以来的新增功能

9.6

了解更多信息