二层网络
概览
- VLAN、VXLAN、SDN等能提供二层隔离技术都可作为二层网络。
- 二层网络负责为三层网络提供二层隔离。

二层网络类型
| 类型 | 描述 |
|---|---|
| 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网络A到KVM集群和VMware集群的时候, ZStack Cloud必须能够理解在这些集群中虚拟机管理程序是如何使用标记描述L2网络的:在KVM物理主机上eth0代表了L2网络,而在VMware物理主机上vswitch0代表了L2网络。 所以物理接口的名字也反映了不同的虚拟机管理程序。
挂载集群(Attaching Cluster)

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

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)
Assuming physicalInterface = eth0
brctl create br_eth0
brctl addif br_eth0 eth0{
"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
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| 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)
Assuming physicalInterface = eth0, vlan = 10
vconfig add eth0 10
brctl create br_eth0_10
brctl addif br_eth0_10 eth0.10{
"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)
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)
物理交换机清单 (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 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 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 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 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 uuid=6e287827ec1f4927a90637e7c96ca92eQueryL2VxlanNetwork 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 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 uuid=064a634df0b742e89d088655454ce63dQueryL2VxlanNetworkPool 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 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 physicalInterface=eth0QueryL2VlanNetwork 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 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 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 physicalInterface=eth0QueryL2Network 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 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 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 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)
{
"l2NetworkTypes": [
"VxlanNetworkPool",
"VxlanNetwork",
"L2NoVlanNetwork",
"L2VlanNetwork"
]
}
参数(Parameters)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| userTags | 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO | 是 | 0.6 | |
| systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO | 是 | 0.6 | |
| timeout | 是 |
挂载二层网络到集群(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 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 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 uuid=d0b6064810d945c582448fed6cb98d54QueryVniRange 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 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原生域查询(Primitive Fields of Query)
获取虚拟交换机类型(GetVSwitchTypes)
GetVSwitchTypes参数(Parameters)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO | 是 | 4.8.0 | |
| userTags | 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO | 是 | 4.8.0 | |
| timeout | 是 |
标签(Tags)
CreateUserTag resourceType=L2NetworkVO tag=publicL2 \
resourceUuid=cff4be8694174b0fb831a9fe53b1d62b