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

二层网络支持四种类型
- 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控制器决定。
- 在部分系统中,
ethx格式的网卡名称会在系统重启后导致网卡顺序随机改变,尤其是带多网卡的云主机环境中,建议将各计算节点的网卡设备名称修改成非ethx格式,例如:可修改成em01格式。
二层网络与集群、三层网络、云主机之间的关系
- 如果集群已加载二层网络,但物理机不存在此二层设备,则物理机不能添加进入对应集群。
- 如果集群未加载二层网络,但物理机不存在此二层设备,则集群不能加载此二层网络。
- 如果某物理机存在此二层设备,但设备接线与集群内其他物理机接线不一致,则创建出的云主机IP不能正常工作。
- 删除二层网络,其对应的子资源三层网络将被删除,使用此三层网络的云主机的网卡也将被删除,请慎重操作。
- 删除二层网络,会删除使用此二层网络的VPC路由器和路由器规格。
- 删除公有网络对应的二层网络,其对应的路由器的一切服务均会被删除,包括VPC路由器、路由器规格、虚拟IP、弹性IP、端口转发、负载均衡、IPsec隧道、NetFlow等。
- 一个软件SDN类型的VXLAN Pool可以创建多个VxlanNetwork,这些VxlanNetwork可以分别应用于扁平网络或VPC网络。
- VxlanNetwork下的云主机无法被外部的网络直接访问,需要通过弹性IP或者端口转发等服务进行间接访问。
- 一个硬件SDN类型的VXLAN Pool可以创建多个HardwareVxlanNetwork,这些HardwareVxlanNetwork仅支目前仅支持应用于扁平网络。
- 一个二层网络可用于创建多个三层网络,但若非特殊业务需求,不推荐多个三层网络共用一个二层网络,否则可能出现DHCP服务不可用的情况。
- 若二层网络为HardwareVxlanNetwork类型,创建的三层网络目前仅支持扁平网络及相应网络服务。
- 若二层网络使用智能网卡网络加速模式,创建的三层网络目前仅支持IPv4类型的VPC网络及相应网络服务。
清单
属性
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| 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
}SDN控制器清单(SdnController Inventory)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| uuid | 请参见 资源属性 | 3.7.0 | ||
| name | 请参见 资源属性 | 3.7.0 | ||
| description | 请参见 资源属性 | 是 | 3.7.0 | |
| ip | 3.7.0 | |||
| password | 密码 | 3.7.0 | ||
| username | 3.7.0 | |||
| vendorType | 3.7.0 | |||
| vniRanges | 3.7.0 | |||
| vxlanPools | 3.7.0 | |||
| groupBy | 以字段分组,相当于MySQL中的group by关键字。例如groupBy=type | 是 | 3.7.0 | |
| createDate | 请参见 资源属性 | 3.7.0 | ||
| lastOpDate | 请参见 资源属性 | 3.7.0 | ||
| userTags | 用户标签,请参见 创建用户标签(CreateUserTag) | 是 | 3.7.0 | |
| systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag) | 是 | 3.7.0 |
{
"inventories": [
{
"createDate": "Oct 23, 2019 3:17:40 PM",
"ip": "172.20.12.165",
"lastOpDate": "Oct 23, 2019 3:17:40 PM",
"name": "gtt",
"password": "Password",
"username": "shixin",
"uuid": "5ce966372dde4169865474b88973a9d8",
"vendorType": "H3C VCFC",
"vniRanges": [
{
"endVni": 3000,
"startVni": 3000
},
{
"endVni": 2009,
"startVni": 10
}
],
"vxlanPools": [
{
"attachedCidrs": {},
"attachedClusterUuids": [
"f34570997a594344ad698280305a1a9a"
],
"attachedVniRanges": [
{
"createDate": "Oct 23, 2019 3:17:52 PM",
"endVni": 29,
"l2NetworkUuid": "0b03b34eb79b46d99d2c0aa074bc2385",
"lastOpDate": "Oct 23, 2019 3:17:52 PM",
"name": "gtt",
"startVni": 23,
"uuid": "3691fb6e4d194eb39d9c49dc3c780816"
}
],
"attachedVtepRefs": [],
"attachedVxlanNetworkRefs": [],
"createDate": "Oct 23, 2019 3:17:52 PM",
"description": "",
"lastOpDate": "Oct 23, 2019 3:17:52 PM",
"name": "gtt",
"physicalInterface": "eth0",
"sdnControllerUuid": "5ce966372dde4169865474b88973a9d8",
"type": "hardware-vxlan-pool",
"uuid": "0b03b34eb79b46d99d2c0aa074bc2385",
"zoneUuid": "182bd537a902404a94f6412d285d277e"
}
]
}
],
"success": true
}
attachedVtepRefs清单 (attachedVtepRefs Inventory)
attachedVxlanNetworkRefs清单 (attachedVxlanNetworkRefs Inventory)
操作(Operations)
创建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 |
创建VXLAN网络(CreateL2VxlanNetwork)
CreateL2VxlanNetwork name=L2VXLAN zoneUuid=e59b71e99d8a4ea1952b578388b8cd1d \
physicalInterface=eth0 poolUuid=1cac60dd6f124861aa99d85f51a9b4fe参数(Parameters)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| name | 普通二层网络名称 | 0.6 | ||
| description | 普通二层网络的详细描述 | 是 | 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 | |
| vSwitchType | 虚拟交换机类型 | 是 |
|
4.8.0 |
| userTags | 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO | 是 | 0.6 | |
| systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO | 是 | 0.6 | |
| 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 |
创建普通二层网络(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 | 虚拟交换机类型 | 是 |
|
4.8.0 |
| resourceUuid | 资源uuid。若指定,镜像会使用该字段值作为uuid | 是 | 0.6 | |
| userTags | 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO | 是 | 0.6 | |
| systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO | 是 | 0.6 | |
| taguUuids | 标签UUID列表 | 是 | 4.8.0 | |
| timeout | 是 |
- ZStack Cloud创建普通二层网络时支持启用SR-IOV功能,SystemTags增加enableSRIOV选项。
- 选项格式为:
enableSRIOV - 例如:
enableSRIOV
- 选项格式为:
创建二层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 | |
| 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 |
删除二层网络(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 |
更新二层网络(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 | 是 |
从集群上卸载二层网络(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 | 是 |
创建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(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(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(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 | 是 |
创建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 zoneUuid=b3a3bf9d1b1b44ca8631ffa3538bc59d \
physicalInterface=eth0参数(Parameters)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| vni | 是 | 4.8.0 | ||
| poolUuid | 是 | 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资源池(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 | |
| timeout | 是 |
获取虚拟交换机类型(GetVSwitchTypes)
GetVSwitchTypes参数(Parameters)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 L2NetworkVO | 是 | 4.8.0 | |
| userTags | 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 L2NetworkVO | 是 | 4.8.0 | |
| timeout | 是 |
硬件SDN对接
添加SDN控制器(AddSdnController)
AddSdnController vendorType=vendor name=sdn-1 ip=192.168.1.1 userName=admin password=password参数(Parameters)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| vendorType | 3.7.0 | |||
| name | 资源名称 | 3.7.0 | ||
| description | 资源的详细描述 | 是 | 3.7.0 | |
| ip | 3.7.0 | |||
| userName | 3.7.0 | |||
| password | 3.7.0 | |||
| resourceUuid | 是 | 3.7.0 | ||
| tagUuids | 标签UUID列表 | 是 | 3.7.0 | |
| userTags | 用户标签,请参见 创建用户标签(CreateUserTag) | 是 | 3.7.0 | |
| systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag) | 是 | 3.7.0 | |
| timeout | 是 |
- ZStack Cloud添加SDN控制器时支持创建H3C
SDN控制,SystemTags增加H3C_VDS_UUID选项,使用 vdsUuid参数来传递
SystemTag。
- 选项格式为:
vdsUuid::{%s} - 例如:
vdsUuid::1234-5678 - 关联资源:
SdnControllerVO.class
- 选项格式为:
查询SDN控制器(QuerySdnController)
QuerySdnController 原生域查询(Primitive Fields of Query)
嵌套和扩展域查询(Nested And Expanded Fields of Query)
| 域(Field) | 清单(Inventory) | 描述 | 起始支持版本 |
|---|---|---|---|
| vxlanPool | vxlanPool inventory | L2网络的vxlanPool | 3.7.0 |
删除SDN控制器(RemoveSdnController)
RemoveSdnController uuid=237901c5097b38c480315569a1ac7567参数(Parameters)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| uuid | 资源的UUID,唯一标示该资源 | 3.7.0 | ||
| deleteMode | 是 | 3.7.0 | ||
| userTags | 用户标签,请参见 创建用户标签(CreateUserTag) | 是 | 3.7.0 | |
| systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag) | 是 | 3.7.0 | |
| timeout | 是 |
更新SDN控制器(UpdateSdnController)
UpdateSdnController uuid=722428da8bac30d2b75daa2f6cd34e9d参数(Parameters)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| uuid | 资源的UUID,唯一标示该资源 | 3.7.0 | ||
| name | 资源名称 | 是 | 3.7.0 | |
| description | 资源的详细描述 | 是 | 3.7.0 | |
| userTags | 用户标签,请参见 创建用户标签(CreateUserTag) | 是 | 3.7.0 | |
| systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag) | 是 | 3.7.0 | |
| timeout | 是 |
标签(Tags)
CreateUserTag resourceType=L2NetworkVO tag=publicL2 \
resourceUuid=cff4be8694174b0fb831a9fe53b1d62b