ModifyVirtualNetwork

您可以使用 ModifyVirtualNetwork 方法更改现有虚拟网络的属性。

使用此方法可以添加或删除地址块、更改网络掩码或者修改虚拟网络的名称或说明。此外,还可以使用它来启用或禁用命名空间,以及在虚拟网络启用了命名空间的情况下添加或删除网关。

注:此方法需要 virtualNetworkIDvirtualNetworkTag 作为参数,但不能两者都用。
警告:
通过更改 namespace 参数来启用或禁用现有虚拟网络的可路由存储 VLAN 功能会中断此虚拟网络处理的所有流量。最好在计划维护时段更改 namespace 参数。

参数

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

名称 说明 类型 默认值 必需
virtualNetworkID 要修改的虚拟网络的唯一标识符。这是由集群分配的虚拟网络 ID。 整型
virtualNetworkTag 用于标识要修改的虚拟网络的网络标记。 整型
addressBlocks 要为此虚拟网络设置的新地址块。此参数可能包含要为现有对象添加的新地址块,也可能会省略需要删除的未用地址块。或者,您也可以增加或减小现有地址块的大小。您只能增加虚拟网络对象的起始地址块的大小,但不能减小它。此对象所需的成员:
  • start:IP 地址范围的起点。(字符串)
  • size:要包含在块中的 IP 地址数。(整型)
JSON 对象
gateway 虚拟网络的网关的 IP 地址。只有当 namespace 参数设置为 true 时,此参数才有效。 字符串
attributes 名称-值对的列表,采用 JSON 对象格式。 JSON 对象
name 虚拟网络的新名称。 字符串
namespace 如果设置为 true,则可以通过重新创建虚拟网络并配置要包含该虚拟网络的命名空间来启用可路由存储 VLAN 功能。如果设置为 false,则可以禁用虚拟网络的 VRF 功能。如果更改此值,则会中断通过此虚拟网络运行的流量。 布尔型
netmask 此虚拟网络的新网络掩码。 字符串
svip 此虚拟网络的存储虚拟 IP 地址。您不能更改虚拟网络的 SVIP, 而是必须创建新的虚拟网络才能使用其他 SVIP 地址。 字符串

返回值

此方法没有返回值。

请求示例

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

{
  "method": "ModifyVirtualNetwork",
  "params": {
    "virtualNetworkID": 2,
    "name": "ESX-VLAN-3112",
    "addressBlocks": [
     {
      "start": "10.1.112.1",
      "size": 20
     },
     {
      "start": "10.1.112.100",
      "size": 20
     }
   ],
    "netmask": "255.255.255.0",
    "gateway": "10.0.1.254",
    "svip": "10.1.112.200",
    "attributes": {}
  },
  "id":1
}

响应示例

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

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

发布以下版本后新增

9.6