二层网络
概览
二层网络:对应于一个二层广播域,进行二层相关的隔离。一般用物理网络的设备名称标识。
- VLAN、VXLAN、SDN等能提供二层隔离技术都可作为二层网络。
- 二层网络负责为三层网络提供二层隔离。
二层网络类型
ZStack Cloud支持以下二层网络类型:
| 类型 | 描述 |
|---|---|
| L2NoVlanNetwork |
|
| L2VlanNetwork |
|
| VxlanNetwork |
|
| HardwareVxlanNetwork |
|
| L2GeneveNetwork |
|
在部分系统中,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网络类型 |
|
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网络,这样,整个拓扑结构如图 16: L2网络拓扑结构所示:
很多看似应用到区域和集群上的操作,实际都被指派到对应的物理主机上了。 当挂载L2网络A到KVM集群和VMware集群的时候, ZStack Cloud必须能够理解在这些集群中虚拟机管理程序是如何使用标记描述L2网络的:在KVM物理主机上eth0代表了L2网络,而在VMware物理主机上vswitch0代表了L2网络。 所以物理接口的名字也反映了不同的虚拟机管理程序。
挂载集群(Attaching Cluster)
挂载集群是为了将L2网络和同一个区域中的集群(sibling clusters)关联起来,它提供了一种灵活的方式来维护数据中心中物理主机和二层网络(layer 2 networks)之间的关系。 例如,如图 17: 挂载集群所示:
假设数据中心中的网络拓扑结构如上图所示。 所有集群中的物理主机的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网络拓扑结构发生了改变。如图 18: 改变挂载集群所示:
L2NoVlanNetwork
L2NoVlanNetwork是L2网络的基本类型,名字中的NoVlan并不表示不可以使用VLAN技术,它仅仅表示ZStack Cloud不会主动使用VLAN来创建一个二层广播域.。下面两个图例可以帮助理解。
在上图这个配置中,交换机的两个端口5和12是不带VLAN 10标签(untagged VLAN 10)的端口(Cisco中的VLAN 10访问端口,即access port), 并且分别连接到host1和host2的eth0。 这对于L2NoVlanNetwork是一个有效的配置。 管理员可以使用physicalInterface = eth0创建L2NoVlanNetwork,并挂载到集群。
在上图这个配置中,交换机的两个端口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标签的。
在上图这个配置中,交换机的两个端口5和12是带VLAN 10标签(tagged VLAN 10)的端口, 这样管理员就可以使用physicalInterface = eth0和vlan = 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 | 虚拟机交换类型 | 是 |
|
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 | 虚拟交换机类型 | 是 |
|
0.6 |
| isolated | 是 | 5.0.0 | ||
| pvlan | 是 | 5.0.0 | ||
| h3cTenantUuid | 是 | 5.4.0 | ||
| vlan | 是 | 5.4.0 |
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 | 虚拟机交换类型 | 是 |
|
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 | 虚拟机交换类型 | 是 |
|
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 | 虚拟机交换类型 | 是 |
|
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 | 虚拟交换机类型 | 是 |
|
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 | 是 |
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 | 虚拟交换机类型 | 是 |
|
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 |
ZStack Cloud创建普通二层网络时支持启用SR-IOV功能,SystemTags增加enableSRIOV选项。
- 选项格式为:
enableSRIOV - 例如:
enableSRIOV
- 选项格式为:
删除二层网络(DeleteL2Network)
管理员可以使用DeleteL2Network删除二层网络。例如:
DeleteL2Network uuid=a5535531eb7346ce89cfd7e643ad1ef8
参数(Parameters)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| uuid | 二层网络uuid | 0.6 | ||
| deleteMode | 请参见 删除资源(Delete Resources) | 是 |
|
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)
嵌套和扩展域查询(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 | 二层网络实现类型 | 是 |
|
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) | 是 |
|
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)
获取虚拟交换机类型(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
