AddVirtualNetwork

您可以使用 AddVirtualNetwork 方法将新的虚拟网络添加到集群配置中。

添加虚拟网络时，系统将为每个节点创建一个接口，且每个接口都需要一个虚拟网络 IP 地址。在此 API 方法的参数中指定的 IP 地址数量必须大于或等于集群中的节点数。系统将批量配置虚拟网络地址，并自动将其分配给各个节点。您无需手动将虚拟网络地址分配给节点。

注： AddVirtualNetwork 方法仅用于创建新的虚拟网络。如果要更改现有虚拟网络，请使用 ModifyVirtualNetwork 方法。

参数

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

名称	说明	类型	默认值	必需
addressBlocks	要包含在虚拟网络中的唯一 IP 地址范围。此对象所需的成员： start：IP 地址范围的起点。（字符串） size：要包含在块中的 IP 地址数。（整型）	JSON 对象数组	无	是
attributes	名称-值对的列表，采用 JSON 对象格式。	JSON 对象	无	否
gateway	虚拟网络的网关的 IP 地址。只有当 namespace 参数设置为 true 时，此参数才有效。	字符串	无	否
name	用户为新虚拟网络定义的名称。	字符串	无	是
namespace	设置为 true 时，通过创建并配置命名空间及其所包含的虚拟网络，可启用可路由存储 VLAN 功能。	布尔型	无	否
netmask	所创建虚拟网络的唯一网络掩码。	字符串	无	是
svip	所创建虚拟网络的唯一存储 IP 地址。	字符串	无	是
virtualNetworkTag	唯一虚拟网络 (VLAN) 标记。支持的值为 1 到 4094。	整型	无	是

注：如果将 namespace 设置为 false，则虚拟网络参数必须是每个虚拟网络特有的。

返回值

此方法具有以下返回值：

名称	说明	类型
virtualNetworkID	新虚拟网络的虚拟网络 ID。	整型

请求示例

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

{
  "method": "AddVirtualNetwork",
  "params": {
    "virtualNetworkTag": 2010,
    "name": "network1",
    "addressBlocks" : [
        { "start": "192.86.5.1", "size": 10 },
        { "start": "192.86.5.50", "size": 20 }
    ],
    "netmask" : "255.255.192.0",
    "gateway" : "10.0.1.254",
    "svip" : "192.86.5.200",
    "attributes" : {}
    "namespace" : true
  },
"id": 1
}

响应示例

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

{
   "id": 1,
   "result":  
      {
        "virtualNetworkID": 5
   }
}

发布以下版本后新增

9.6