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
  }
}