文档目录

二层网络

概览

二层网络:对应于一个二层广播域,进行二层相关的隔离。一般用物理网络的设备名称标识。
  • VLAN、VXLAN、SDN等能提供二层隔离技术都可作为二层网络。
  • 二层网络负责为三层网络提供二层隔离。
图 1所示:
图 1. 二层网络


二层网络类型

ZStack Cloud支持以下二层网络类型:
类型 描述
L2NoVlanNetwork
  • 必须指定物理机的接口名称。
  • 挂载的集群内物理机必须都存在相同的接口。
  • 云主机的流量经过物理机接口到达物理交换机时,不携带VLAN标签;物理交换机必须配置VLAN Access模式。
  • 创建L2NoVlanNetwork,会根据指定的物理机接口创建网桥。
L2VlanNetwork
  • 必须指定物理机的接口名称和VLAN ID。
  • 挂载的集群内物理机必须都存在相同的接口。
  • 云主机的流量经过物理机接口到达物理交换机时,携带用户指定的VLAN ID。
  • 创建L2VlanNetwork,会根据指定的VLAN ID创建VLAN设备,并基于此VLAN设备创建网桥。
  • 如果集群同时挂载L2NoVlanNetwork与L2VlanNetwork,或者同时挂载多个L2VlanNetwork,物理交换机接口必须为Trunk模式,且Trunk VLAN需包含当前使用的VLAN ID。
VxlanNetwork
  • VXLAN是一种Overlay技术,方便用户创建一个大二层网络,它最大支持的逻辑网络数量16M。
  • VxlanNetwork是一种基于软件VXLAN的解决方案。
  • 必须指定一个软件SDN类型的VXLAN Pool,一个VxlanNetwork对应VXLAN Pool里的一个VNI。
  • 挂载的集群内物理机的VTEP IP必须都属于当前指定的VXLAN Pool。
  • 云主机的流量经过物理机时,物理机给该云主机流量加上VXLAN信息,然后发送到物理交换机。
HardwareVxlanNetwork
  • VXLAN是一种Overlay 技术,方便用户创建一个大二层网络,它最大支持的逻辑网络数量为16M。
  • HardwareVxlanNetwork是一种对接第三方硬件SDN的解决方案。
  • 必须指定一个硬件SDN类型的VXLAN Pool,一个HardwareVxlanNetwork对应VXLAN Pool里的一个VNI。
  • 云主机的流量经过物理机接口到达虚拟分布式交换机时,携带用户指定的VLAN ID;VLAN ID与VXLAN ID直接的映射关系由SDN控制器决定。
L2GeneveNetwork
  • 基于 ZNS SDN 控制器创建的二层网络,通过 Geneve Overlay 承载租户网络隔离。
  • 用于创建 ZNS 三层网络时需选择就绪的 ZNS 控制器并填写 Geneve ID。
Note: 在部分系统中,ethx格式的网卡名称会在系统重启后导致网卡顺序随机改变,尤其是带多网卡的云主机环境中,建议将各计算节点的网卡设备名称修改成非ethx格式,例如:可修改成em01格式。

二层网络与集群、三层网络、云主机之间的关系

二层网络与集群、三层网络、云主机之间存在以下关系:
  • 如果集群已加载二层网络,但物理机不存在此二层设备,则物理机不能添加进入对应集群。
  • 如果集群未加载二层网络,但物理机不存在此二层设备,则集群不能加载此二层网络。
  • 如果某物理机存在此二层设备,但设备接线与集群内其他物理机接线不一致,则创建出的云主机IP不能正常工作。
  • 删除二层网络,其对应的子资源三层网络将被删除,使用此三层网络的云主机的网卡也将被删除,请慎重操作。
  • 删除二层网络,会删除使用此二层网络的VPC路由器和路由器规格。
  • 删除公有网络对应的二层网络,其对应的路由器的一切服务均会被删除,包括VPC路由器、路由器规格、虚拟IP、弹性IP、端口转发、负载均衡、IPsec隧道、NetFlow等。
  • 一个VXLAN Pool可以创建多个VxlanNetwork,这些VxlanNetwork可以分别应用于扁平网络或VPC网络。
  • VxlanNetwork下的云主机无法被外部的网络直接访问,需要通过弹性IP或者端口转发等服务进行间接访问。
  • 一个二层网络可用于创建多个三层网络,但若非特殊业务需求,不推荐多个三层网络共用一个二层网络,否则可能出现DHCP服务不可用的情况。

清单

属性

名字 描述 可选的 可选的参数值 起始支持版本
attachedCidrs 4.8.0
vni 4.8.0
poolUuid 4.8.0
vlan 4.8.0
uuid 请参见 资源属性 0.6
name 请参见 资源属性 0.6
description 请参见 资源属性 0.6
zoneUuid 父区域的uuid, 请参见 zone 0.6
physicalInterface 请参见 physical interface 0.6
type L2网络类型
  • L2NoVlanNetwork
  • L2VlanNetwork
  • VxlanNetworkPool
  • VxlanNetwork
0.6
attachedClusterUuids L2网络挂载的集群的列表, 请参见 attach cluster 0.6
createDate 请参见 资源属性 0.6
lastOpDate 请参见 资源属性 0.6
attachedVtepRefs 请参见attachedVtepRefs清单 (attachedVtepRefs Inventory) 4.8.0
attachedVxlanNetworkRefs 请参见attachedVxlanNetworkRefs清单 (attachedVxlanNetworkRefs Inventory) 4.8.0
attachedVniRanges 请参见attachedVniRanges清单 (attachedVniRanges Inventory) 4.8.0

示例

{
    "inventories": [
        {
            "attachedClusterUuids": [
                "553c2fd2a67b4b89a6240541959b861f"
            ],
            "createDate": "Mar 10, 2018 2:35:14 PM",
            "description": "",
            "lastOpDate": "Mar 10, 2018 2:35:14 PM",
            "name": "L2Network-1",
            "physicalInterface": "eth0",
            "type": "L2NoVlanNetwork",
            "uuid": "dde9685e3ba944bea8c643fe64200750",
            "zoneUuid": "fa18454182eb41749797f824c00cfccf"
        }
    ],
    "success": true
}

物理接口(Physical Interface)

物理接口是一个字符串(例如eth0)。它代表了数据中心里二层网络(L2)的信息。不同L2网络类型和不同虚拟机管理程序类型通常会有不同的物理接口。这主要归结于虚拟机管理程序使用自己的标记方式(notations)来描述L2网络, 并且L2网络可以被同时挂载到多个拥有不同虚拟机管理系统的集群上。

假设数据中心有一个L2网络(l2Network A),这个L2网络跨越两个集群:一个是KVM集群, 另一个是VMware集群。在KVM中,L2网络是使用Linux操作系统中的以太网设备(ethernet device)实现的;假设每个KVM主机通过eth0连接到L2网络。 在VMware集群中, L2网络是使用vswitch实现的;假设VMware集群使用vswitch0连接到L2网络,这样,整个拓扑结构如图 2所示:
图 2. L2网络拓扑结构


很多看似应用到区域和集群上的操作,实际都被指派到对应的物理主机上了。 当挂载L2网络A到KVM集群和VMware集群的时候, ZStack Cloud必须能够理解在这些集群中虚拟机管理程序是如何使用标记描述L2网络的:在KVM物理主机上eth0代表了L2网络,而在VMware物理主机上vswitch0代表了L2网络。 所以物理接口的名字也反映了不同的虚拟机管理程序。

挂载集群(Attaching Cluster)

挂载集群是为了将L2网络和同一个区域中的集群(sibling clusters)关联起来,它提供了一种灵活的方式来维护数据中心中物理主机和二层网络(layer 2 networks)之间的关系。 例如,如图 3所示:
图 3. 挂载集群


假设数据中心中的网络拓扑结构如上图所示。 所有集群中的物理主机的eth0都连接在同一个称为L2 Network1的二层网络上;集群cluster1和cluster3中物理主机的eth1都连接在另一个称为L2 network2的二层网络上。为了在ZStack Cloud中描述这个拓扑结构,可以将L2 network1挂载到所有三个集群上,同时只将L2 network2挂载到集群cluster1和cluster3上。

几个月之后, 由于一些业务的需求,网络拓扑结构需要作一些改变。将集群cluster3中的物理主机上eth1所连接的网线从机架交换机(rack switch)上断开,这样集群cluster3就不再和L2 network2相连了;可以通过将L2 network2从cluster3上卸载来通知ZStack Cloud网络拓扑结构发生了改变。如图 4所示:
图 4. 改变挂载集群


L2NoVlanNetwork

L2NoVlanNetwork是L2网络的基本类型,名字中的NoVlan并不表示不可以使用VLAN技术,它仅仅表示ZStack Cloud不会主动使用VLAN来创建一个二层广播域.。下面两个图例可以帮助理解。

图 5所示:
图 5. L2NoVlanNetwork网络配置1


在上图这个配置中,交换机的两个端口5和12是不带VLAN 10标签(untagged VLAN 10)的端口(Cisco中的VLAN 10访问端口,即access port), 并且分别连接到host1和host2的eth0。 这对于L2NoVlanNetwork是一个有效的配置。 管理员可以使用physicalInterface = eth0创建L2NoVlanNetwork,并挂载到集群。

图 6所示:
图 6. L2NoVlanNetwork网络配置2


在上图这个配置中,交换机的两个端口5和12是带VLAN 10标签(tagged VLAN 10)的端口(Cisco中的VLAN 10干线端口,即trunk port), 并且分别连接到host1和host2上预先创建好的VLAN设备eth0.10。 对于L2NoVlanNetwork来说,这同样是一个有效的配置。管理员可以使用physicalInterface = eth0.10创建L2NoVlanNetwork,并挂载到集群。

就是说,一个L2NoVlanNetwork对应了一个预先创建好的二层广播域; ZStack Cloud不会为L2NoVlanNetwork创建任何新的广播域。

KVML2NoVlanNetwork注意事项(L2NoVlanNetwork KVM Specific)

当挂载一个L2NoVlanNetwork到KVM集群时, physicalInterface应该是一个Linux操作系统中的以太网设备名(ethernet device name); 例如:eth0、 eth0.10和 em1。 当ZStack Cloud使用brctl创建网桥(bridge)时会使用physicalInterface作为设备名。伪代码如下:
Assuming physicalInterface = eth0

brctl create br_eth0
brctl addif br_eth0 eth0
L2NoVlanNetwork清单示例(L2NoVlanNetwork Inventory Example)
{
    "inventories": [
        {
            "attachedClusterUuids": [
                "967a353c2893409dab9312cf3033a98c"
            ],
            "createDate": "Oct 30, 2017 1:53:20 PM",
            "description": "",
            "lastOpDate": "Oct 30, 2017 1:53:20 PM",
            "name": "L2NoVlan",
            "physicalInterface": "eth0",
            "type": "L2NoVlanNetwork",
            "uuid": "5f0391e0c7ed45dba5ee5ed9c638f146",
            "zoneUuid": "e59b71e99d8a4ea1952b578388b8cd1d"
        }
    ],
    "success": true
}

L2VlanNetwork

L2VlanNetwork是ZStack Cloud主动使用VLAN创建二层广播域的L2网络。根据集群中虚拟机管理程序的不同, ZStack Cloud创建L2网络对应的二层广播域的方式也不同。 相比l2Network inventory, L2VlanNetwork还有一个额外的属性:
名字 描述 可选的 可选的参数值 起始支持版本
vlan 用来创建二层广播域的VLAN号(VLAN id) [0,4095] 0.6

当挂载L2VlanNetwork到集群的时候,ZStack Cloud会配合使用vlan属性和physicalInterface属性在集群中的主机上创建vlan设备; 为了使这种方式工作,physicalInterface所指定的以太网设备所连接的交换机端口必须是带相应vlan标签的。

图 7所示:
图 7. L2VlanNetwork网络配置


在上图这个配置中,交换机的两个端口5和12是带VLAN 10标签(tagged VLAN 10)的端口, 这样管理员就可以使用physicalInterface = eth0vlan = 10创建L2VlanNetwork,并将它挂载到集群上。

L2VlanNetwork KVM注意事项(L2VlanNetwork KVM Specific)

当挂载L2VlanNetwork到KVM集群时, ZStack Cloud会在集群中的所有物理主机上创建VLAN设备并创建网桥。 伪代码如下:
Assuming physicalInterface = eth0, vlan = 10

vconfig add eth0 10
brctl create br_eth0_10
brctl addif br_eth0_10 eth0.10
L2VlanNetwork清单示例(L2VlanNetwork Inventory Example)
{
    "inventories": [
        {
            "attachedClusterUuids": [],
            "createDate": "Oct 30, 2017 1:41:19 PM",
            "description": "",
            "lastOpDate": "Oct 30, 2017 1:41:19 PM",
            "name": "L2Vlan",
            "physicalInterface": "eth0",
            "type": "L2VlanNetwork",
            "uuid": "ae97ba4adcb7404690344dde407b429c",
            "vlan": 2222,
            "zoneUuid": "e59b71e99d8a4ea1952b578388b8cd1d"
        }
    ],
    "success": true
}

attachedVtepRefs清单 (attachedVtepRefs Inventory)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 请参见 资源属性 4.8.0
hostUuid 物理机UUID 4.8.0
vtepIp 4.8.0
port 4.8.0
type L2网络类型 4.8.0
createDate 请参见 资源属性 4.8.0
lastOpDate 请参见 资源属性 4.8.0
poolUuid 4.8.0

attachedVxlanNetworkRefs清单 (attachedVxlanNetworkRefs Inventory)

名字 描述 可选的 可选的参数值 起始支持版本
vni 4.8.0
poolUuid 4.8.0
uuid 请参见 资源属性 4.8.0
name 请参见 资源属性 4.8.0
description 请参见 资源属性 4.8.0
zoneUuid 父区域的uuid, 请参见 zone 4.8.0
physicalInterface 请参见 physical interface 4.8.0
type L2网络类型 4.8.0
vSwitchType 5.3.20
virtualNetworkId 5.3.20
Isolated 5.3.20
pvlan 5.3.20
createDate 请参见 资源属性 4.8.0
lastOpDate 请参见 资源属性 4.8.0
attachedClusterUuids 4.8.0

attachedVniRanges清单 (attachedVniRanges Inventory)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 请参见 资源属性 4.8.0
name 请参见 资源属性 4.8.0
description 请参见 资源属性 4.8.0
startVni 起始VNI 5.3.20
endVni 结束VNI 5.3.20
createDate 请参见 资源属性 4.8.0
lastOpDate 请参见 资源属性 4.8.0
l2NetworkUuid 二层网络UUID 4.8.0

物理交换机清单 (PhysicalSwitch Inventory)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 资源的UUID,唯一标示该资源 5.4.0
description 资源的详细描述 5.4.0
name 资源名称 5.4.0
sdnControllerUuid SDN控制器UUID 5.4.0
groupBy 以字段分组,相当于MySQL中的group by关键字。例如groupBy=type 5.4.0
tagUuid 5.4.0
createDate 创建时间 5.4.0
lastOpDate 最后一次修改时间 5.4.0
softwareVersion 软件版本 5.4.0
mac 5.4.0
mode 5.4.0
ports 5.4.0
ip 5.4.0
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 5.4.0
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 5.4.0
示例
{
    "inventories": [
        {
            "createDate": "Oct 11, 2025 11:12:38 AM",
            "ip": "172.25.1.152",
            "lastOpDate": "Oct 11, 2025 11:12:38 AM",
            "mac": "c0:e3:fb:65:ab:d1",
            "mode": "CE6881-48S6CQ",
            "name": "huawei_152",
            "ports": [
                {
                    "createDate": "Oct 11, 2025 11:12:38 AM",
                    "lastOpDate": "Oct 11, 2025 11:12:38 AM",
                    "name": "100GE1/0/1",
                    "portType": "IFMIPHYTYPE100GE",
                    "sdnControllerUuid": "4d81cdfcfa1748caaecaa4285cebe383",
                    "switchUuid": "b9d708c427c630b1b9fffe2d989c3a48",
                    "uuid": "db6003d18fe339909a31863b31846a08"
                },
                {
                    "createDate": "Oct 11, 2025 11:12:38 AM",
                    "ethTrunkName": "Eth-Trunk10",
                    "lastOpDate": "Oct 11, 2025 11:12:38 AM",
                    "name": "10GE1/0/11",
                    "portType": "IFMIPHYTYPE10GE",
                    "sdnControllerUuid": "4d81cdfcfa1748caaecaa4285cebe383",
                    "switchUuid": "b9d708c427c630b1b9fffe2d989c3a48",
                    "uuid": "21ce670921443be5ba7a1a028f290718"
                }
            ],
            "sdnControllerUuid": "4d81cdfcfa1748caaecaa4285cebe383",
            "softwareVersion": "V200R021C00SPC200",
            "uuid": "b9d708c427c630b1b9fffe2d989c3a48"
        }
    ],
    "success": true
}

操作(Operations)

创建tungsten fabric二层网络(CreateL2TfNetwork)

管理员可以使用CreateL2TfNetwork创建tungsten fabric二层网络。例如:
CreateL2TfNetwork name=testtf zoneUuid=b3a3bf9d1b1b44ca8631ffa3538bc59d \
physicalInterface=eth0

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
ipPrefix Ip地址前缀 4.8.0
ipPrefixLength Ip地址前缀长度 4.8.0
name tungsten fabric二层网络名称 4.8.0
description tungsten fabric二层网络的详细描述 4.8.0
zoneUuid 区域uuid 4.8.0
physicalInterface 物理网卡 4.8.0
type 类型 4.8.0
resourceUuid 资源uuid。若指定,镜像会使用该字段值作为uuid 4.8.0
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 4.8.0
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 4.8.0
vSwitchType 虚拟机交换类型
  • LinuxBridge
  • OvsDpdk
  • MacVlan
4.8.0
tagUuid 标签UUID列表 4.8.0
timeout

创建硬件VXLAN网络(CreateL2HardwareVxlanNetwork)

管理员可以使用CreateL2HardwareVxlanNetwork创建硬件VXLAN网络。例如:
CreateL2HardwareVxlanNetwork name=test-hardvlan poolUuid=7b3b9aaa42d3364d846a598cce125174 \
zoneUuid=b3a3bf9d1b1b44ca8631ffa3538bc59d physicalInterface=eth0 

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
vni VNI号 3.7
poolUuid VXLAN资源池UUID 3.7
name 资源名称 3.7
description 资源的详细描述 3.7
zoneUuid 区域UUID 3.7
physicalInterface 物理网卡 3.7
type 二层网络类型 3.7
resourceUuid 资源UUID。若指定,二层网络会使用该字段值作为UUID 3.7
tagUuids 标签UUID列表 3.7
systemTags 系统标签 3.7
userTags 用户标签 3.7
vSwitchType 虚拟交换机类型
  • LinuxBridge
  • OvsDpdk
  • MacVlan
0.6
isolated 5.0.0
pvlan 5.0.0
h3cTenantUuid 5.4.0
vlan 5.4.0
Note:
  • ZStack Cloud创建二层网络时支持记录硬件vxlan网络对应的华为vpc uuid,SystemTags增加huaweiVpcUuid选项。
    • 选项格式为:huaweiVpcUuid::{%s}
    • 例如:huaweiVpcUuid:: bf4eb98c0bb74441a652715f1c9a065d
  • ZStack Cloud创建二层网络时支持记录硬件vxlan网络对应的华为租户uuid,SystemTags增加huaweiTenantUuid选项。
    • 选项格式为:huaweiTenantUuid::{%s}
    • 例如:huaweiTenantUuid:: e9218d9e4a2e4a029d33ce6a683d44e8

创建硬件VXLAN资源池(CreateL2HardwareVxlanNetworkPool)

管理员可以使用CreateL2HardwareVxlanNetworkPool创建硬件VXLAN资源池。例如:
CreateL2HardwareVxlanNetworkPool name=test-hardvlanpool sdnControllerUuid=0b2231798a5c3971811ca4c9647776b8 zoneUuid=b3a3bf9d1b1b44ca8631ffa3538bc59d \
physicalInterface=eth0

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
sdnControllerUuid SDN控制器UUID 4.8.0
name tungsten fabric二层网络名称 4.8.0
description tungsten fabric二层网络的详细描述 4.8.0
zoneUuid 区域UUID 4.8.0
physicalInterface 物理网卡 4.8.0
type 类型 4.8.0
resourceUuid 资源UUID。若指定,镜像会使用该字段值作为UUID 4.8.0
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 4.8.0
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 4.8.0
vSwitchType 虚拟机交换类型
  • LinuxBridge
  • OvsDpdk
  • MacVlan
4.8.0
tagUuid 标签UUID列表 4.8.0
isolated 4.8.0
pvlan 4.8.0
startVlan 5.3.28
endVlan 5.3.28

创建VXLAN网络(CreateL2VxlanNetwork)

管理员可以使用CreateL2VxlanNetwork创建VXLAN网络。例如:
CreateL2VxlanNetwork name=L2VXLAN zoneUuid=e59b71e99d8a4ea1952b578388b8cd1d \
physicalInterface=eth0 poolUuid=1cac60dd6f124861aa99d85f51a9b4fe

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
name VXLAN二层网络名称 0.6
description VXLAN二层网络的详细描述 0.6
zoneUuid 区域UUID 0.6
physicalInterface 物理网卡 0.6
poolUuid VXLAN网络资源池UUID 0.6
vni VXLAN网络ID 0.6
type 类型 0.6
resourceUuid 资源UUID。若指定,镜像会使用该字段值作为UUID。 0.6
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 0.6
vSwitchType 虚拟机交换类型
  • LinuxBridge
  • OvsDpdk
4.8.0
timeout

查询VXLAN网络(QueryL2VxlanNetwork)

管理员可以使用QueryL2VxlanNetwork查询VXLAN网络。例如:
QueryL2VxlanNetwork uuid=6e287827ec1f4927a90637e7c96ca92e
QueryL2VxlanNetwork zone.uuid=e59b71e99d8a4ea1952b578388b8cd1d

原生域查询(Primitive Fields of Query)

请参见 L2 vxlannetwork inventory

嵌套和扩展域查询(Nested and Expanded Fields of Query)

域(Field) 清单(Inventory) 描述 起始支持版本
cluster cluster inventory 该L2网络挂载的所有集群 0.6
l3Network L3 network inventory 属于这个L2网络的L3网络 0.6
vxlanPool vxlanPool inventory 创建这个L2网络的vxlanPool 0.6
zone zone inventory 父区域 0.6

创建VXLAN网络池(CreateL2VxlanNetworkPool)

管理员可以使用CreateL2VxlanNetworkPool创建VXLAN网络池。例如:
CreateL2VxlanNetworkPool name=testvxlan zoneUuid=8abab36040884e6fbec05fa70c5ef873 \
physicalInterface=eth0

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
name VXLAN网络池名称 0.6
description VXLAN网络池的详细描述 0.6
zoneUuid 区域uuid 0.6
physicalInterface 物理网卡 0.6
type 类型 0.6
resourceUuid 资源uuid。若指定,镜像会使用该字段值作为uuid 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 0.6
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 0.6
vSwitchType 虚拟机交换类型
  • LinuxBridge
  • OvsDpdk
  • MacVlan
4.8.0
tagUuid 标签UUID列表 4.8.0
timeout

查询VXLAN网络池(QueryL2VxlanNetworkPool)

管理员可以使用QueryL2VxlanNetworkPool查询VXLAN网络池。例如:
QueryL2VxlanNetworkPool uuid=064a634df0b742e89d088655454ce63d
QueryL2VxlanNetworkPool zone.uuid=8abab36040884e6fbec05fa70c5ef873

原生域查询(Primitive Fields of Query)

请参见 L2 vxlannetworkpool inventory

嵌套和扩展域查询(Nested and Expanded Fields of Query)

域(Field) 清单(Inventory) 描述 起始支持版本
attachedVniRanges attachedVniRanges inventory 0.6
attachedVtepRefs attachedVtepRefs inventory 0.6
attachedVxlanNetworkRefs attachedVxlanNetworkRefs inventory 0.6
cluster cluster inventory 该L2网络挂载的所有集群 0.6
l2VxlanNetwork l2VxlanNetwork inventory 0.6
l3Network L3 network inventory 属于这个L2网络的L3网络 0.6
vniRange vniRange inventory 0.6
vtep vtep inventory Vxlan隧道端点 0.6
zone zone inventory 父区域 0.6

创建二层VLAN网络(CreateL2VlanNetwork)

管理员可以使用CreateL2VlanNetwork创建二层VLAN网络。例如:
CreateL2VlanNetwork name=testvlan zoneUuid=8abab36040884e6fbec05fa70c5ef873 \
physicalInterface=eth0 vlan=2637

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
vlan 0.6
name 二层Vlan网络名称 0.6
description 二层Vlan网络的详细描述 0.6
zoneUuid 区域uuid 0.6
physicalInterface 物理网卡 0.6
type 0.6
vSwitchType 虚拟交换机类型
  • LinuxBridge
  • OvsDpdk
  • MacVlan
4.8.0
resourceUuid 资源uuid 0.6
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 0.6
tagUuid 标签UUID列表 4.8.0
isolated 5.0.0
timeout
Note:
  • ZStack Cloud创建二层VLAN网络时支持启用SR-IOV功能,SystemTags增加enableSRIOV选项。
    • 选项格式为:enableSRIOV
    • 例如:enableSRIOV

查询二层VLAN网络(QueryL2VlanNetwork)

管理员可以使用QueryL2VlanNetwork查询二层VLAN网络。例如:
QueryL2VlanNetwork physicalInterface=eth0
QueryL2VlanNetwork zone.cluster.zoneUuid=8abab36040884e6fbec05fa70c5ef873

原生域查询(Primitive Fields of Query)

请参见 L2 vlan network inventory

嵌套和扩展域查询(Nested and Expanded Fields of Query)

域(Field) 清单(Inventory) 描述 起始支持版本
l3Network L3 network inventory 属于这个L2网络的L3网络 0.6
cluster cluster inventory 该L2网络挂载的所有集群 0.6
zone zone inventory 父区域 0.6

创建普通二层网络(CreateL2NoVlanNetwork)

管理员可以使用CreateL2NoVlanNetwork创建普通二层网络。例如:
CreateL2NoVlanNetwork name=management-network physicalInterface=eth0 \
zoneUuid=9a94e647a9f64bb392afcdc5396cc1e4

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
name 普通二层网络名称 0.6
description 普通二层网络的详细描述 0.6
zoneUuid 区域uuid 0.6
physicalInterface 物理网卡 0.6
type 类型 0.6
vSwitchType 虚拟交换机类型
  • LinuxBridge
  • OvsDpdk
  • MacVlan
  • OvnDpdk
5.3.28
isolated 5.3.20
pvlan 5.3.20
resourceUuid 资源uuid。若指定,镜像会使用该字段值作为uuid 0.6
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 0.6
tagUuids 标签UUID列表 4.8.0
timeout 5.3.20
Note:
  • ZStack Cloud创建普通二层网络时支持启用SR-IOV功能,SystemTags增加enableSRIOV选项。
    • 选项格式为:enableSRIOV
    • 例如:enableSRIOV

删除二层网络(DeleteL2Network)

管理员可以使用DeleteL2Network删除二层网络。例如:
DeleteL2Network uuid=a5535531eb7346ce89cfd7e643ad1ef8

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 二层网络uuid 0.6
deleteMode 请参见 删除资源(Delete Resources)
  • Permissive
  • Enforcing
0.6
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 0.6
timeout

查询二层网络(QueryL2Network)

管理员可以使用QueryL2Network查询二层网络。例如:
QueryL2Network physicalInterface=eth0
QueryL2Network l3Network.ipRanges.startIp=192.168.0.2

原生域查询(Primitive Fields of Query)

请参见 L2 network inventory

嵌套和扩展域查询(Nested and Expanded Fields of Query)

域(Field) 清单(Inventory) 描述 起始支持版本
l3Network L3 network inventory 属于这个L2网络的L3网络 0.6
cluster cluster inventory 该L2网络挂载的所有集群 0.6
zone zone inventory 父区域 0.6

从集群上卸载二层网络(DetachL2NetworkFromCluster)

管理员可以使用DetachL2NetworkFromCluster从集群上卸载二层网络。例如:
DetachL2NetworkFromCluster clusterUuid=2379a0d00ae242df91189f6d7d9e23e3 \
l2NetworkUuid=cc42d175ed9649558af69b8a0b824b9a

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
l2NetworkUuid 二层网络uuid 0.6
clusterUuid 集群uuid 0.6
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 0.6
timeout

修改二层网络VLAN ID(ChangeL2NetworkVlanId)

用户可以使用ChangeL2NetworkVlanId创建二层网络VLAN ID。例如:
ChangeL2NetworkVlanId uuid=808756594f2f3ce8bc33ca92499b7653 vlan=1

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 二层网络UUID 5.1.0
vlan VLAN ID 5.1.0
type 二层网络类型 5.1.0
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 5.1.0
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 5.1.0
tagUuid 标签UUID列表 5.1.0
timeout 5.1.0

更新二层网络(UpdateL2Network)

管理员可以使用UpdateL2Network更新二层网络。例如:
UpdateL2Network uuid=cc42d175ed9649558af69b8a0b824b9a

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 二层网络uuid 0.6
name 普通二层网络名称 0.6
description 普通二层网络的详细描述 0.6
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 0.6
timeout

获取二层网络类型(GetL2NetworkTypes)

管理员可以使用GetL2NetworkTypes获取二层网络类型。返回示例:
{
    "l2NetworkTypes": [
        "VxlanNetworkPool",
        "VxlanNetwork",
        "L2NoVlanNetwork",
        "L2VlanNetwork"
    ]
}

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 0.6
timeout

挂载二层网络到集群(AttachL2NetworkToCluster)

管理员可以使用AttachL2NetworkToCluster挂载二层网络到集群。例如:
AttachL2NetworkToCluster clusterUuid=2379a0d00ae242df91189f6d7d9e23e3 \
l2NetworkUuid=cc42d175ed9649558af69b8a0b824b9a

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
l2NetworkUuid 二层网络uuid 0.6
clusterUuid 集群uuid 0.6
l2ProviderType 二层网络实现类型
  • LinuxBridge
4.8.0
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 0.6
timeout

创建VNI Range(CreateVniRange)

管理员可以使用CreateVniRange创建VNI Range。例如:
CreateVniRange name=vni startVni=8034 endVni=9322 l2NetworkUuid=1cac60dd6f124861aa99d85f51a9b4fe

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
name VNI Range名称 0.6
description VNI Range的详细描述 0.6
startVni 0.6
endVni 0.6
l2NetworkUuid Vxlan网络资源池uuid 0.6
resourceUuid 资源uuid。若指定,镜像会使用该字段值作为uuid 0.6
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 0.6
timeout

删除VNI Range(DeleteVniRange)

管理员可以使用DeleteVniRange删除VNI Range。例如:
DeleteVniRange uuid=d0b6064810d945c582448fed6cb98d54

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
uuid VNI Range uuid 0.6
deleteMode 请参见 删除资源(Delete Resources)
  • Permissive
  • Enforcing
0.6
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 0.6
timeout

查询VNI Range(QueryVniRange)

管理员可以使用QueryVniRange查询VNI Range。例如:
QueryVniRange uuid=d0b6064810d945c582448fed6cb98d54
QueryVniRange vxlanPool.uuid=1cac60dd6f124861aa99d85f51a9b4fe

原生域查询(Primitive Fields of Query)

请参见 VNI range inventory

嵌套和扩展域查询(Nested and Expanded Fields of Query)

域(Field) 清单(Inventory) 描述 起始支持版本
vxlanPool vxlanPool inventory 0.6

修改VNI Range(UpdateVniRange)

管理员可以使用UpdateVniRange修改VNI Range。例如:
UpdateVniRange uuid=d0b6064810d945c582448fed6cb98d54

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
uuid Vni Range uuid 3.3.0
name 3.3.0
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 3.3.0
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 3.3.0
timeout

查询物理交换机信息(QueryPhysicalSwitch)

管理员可以使用QueryPhysicalSwitch查询物理交换机信息。例如:
QueryPhysicalSwitch

原生域查询(Primitive Fields of Query)

请参见 物理交换机清单 (PhysicalSwitch Inventory)

获取虚拟交换机类型(GetVSwitchTypes)

管理员可以使用GetVSwitchTypes获取虚拟交换机类型。例如:
GetVSwitchTypes

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO 4.8.0
userTags 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO 4.8.0
timeout

标签(Tags)

管理员可以使用resourceType=L2NetworkVO在L2网络上创建用户标签。例如:
CreateUserTag resourceType=L2NetworkVO tag=publicL2 \
resourceUuid=cff4be8694174b0fb831a9fe53b1d62b
CLI命令使用手册 | 5.5.30 | ZStack Cloud · ZCF | ZStack 资源中心