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