创建交换机EthTrunk端口
典型场景
提供配置参数的接口,创建交换机EthTrunk端口。
接口功能
页面功能:站点配置下选择存在交换机设备的站点,在交换机页签下选择接口。
创建交换机EthTrunk端口,可以同时配置此EthTrunk端口参数。
接口约束
1、该接口支持租户视图或msp代维视图下,用户角色为“Open Api Operator”的用户访问,必须在用户会话建立后使用。
2、存在交换机设备的站点内使用。
调用方法
POST
URI
/controller/campus/v1/networkservice/networkconfig/net/lswport/devices/{deviceId}/ethtrunk-ports
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
deviceId |
是 |
uuid |
- |
- |
设备ID。 |
"fbb684c8-0d37-496f-bafa-4b06d5151e2e" |
请求参数
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
body |
是 |
REFERENCE |
详细请参见表3。 |
创建交换机EthTrunk端口参数体,结构体参见LSWEthTrunkPortDto。 |
- |
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
status |
否 |
boolean |
|
true |
接口管理状态(true为undo shutdown,false为shutdown)。默认值为true。 |
true |
description |
否 |
string |
0~242个字符。 |
- |
接口描述。 |
"LSW interface" |
linkType |
否 |
string |
- |
trunk |
链路类型,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。取值:access;trunk;hybrid;dot1q。默认值为trunk。 |
"trunk" |
defaultVlan |
否 |
int32 |
[1-4094] |
1 |
access类型下缺省VLAN;或trunk类型下pvid;或hybrid类型下缺省VLAN。若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为1。 |
1 |
allowPassVlan |
否 |
string |
0~13000个字符。 |
1 |
trunk类型下允许通过VLAN,接口为trunk类型时必填。allowPassVlan的取值要求:1到4094范围内的数字、段或all,如:1,3-10。默认值为1。 |
"1,3-10" |
untaggedVlan |
否 |
string |
0~100个字符。 |
1 |
hybrid类型下Untagged VLAN。untaggedVlan的取值要求:1到4094范围内的数字或段,如:11,12-16。不能配置和taggedVlan相同的数值。默认值为1。 |
"11,12-16" |
taggedVlan |
否 |
string |
0~100个字符。 |
- |
hybrid类型下Tagged VLAN。taggedVlan的取值要求:1到4094范围内的数字或段,如:1,3-10。不能配置和untaggedVlan相同的数值。 |
"1,3-10" |
arpSnoopingEnable |
否 |
boolean |
|
false |
ARP Snooping使能,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
dhcpSnooping |
否 |
boolean |
|
false |
DHCP Snooping使能,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
dhcpSnoopingTrusted |
否 |
boolean |
|
false |
配置接口为DHCP Snooping信任状态,默认为非信任状态。默认值为false。 |
false |
ndSnooping |
否 |
boolean |
|
false |
ND Snooping使能,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
ndSnoopingTrusted |
否 |
boolean |
|
false |
配置接口为ND Snooping信任状态,默认为非信任状态。默认值为false。 |
false |
portIsolation |
否 |
boolean |
|
false |
端口隔离使能,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
stp |
否 |
boolean |
|
true |
STP功能状态,取值:true(使能);false(未使能)。当STP为false时,stpEdgedport自动赋值为normal,传入其他参数无效。默认值为true。 |
true |
stpEdgedport |
否 |
string |
- |
normal |
STP边缘端口状态,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。取值:enable(使能);normal(遵从全局状态);disable(未使能)。默认值为normal。 |
"normal" |
bpduFilter |
否 |
string |
0~10个字符。 |
normal |
配置当前端口是否为BPDU filter端口。。取值:enable(使能);normal(遵从全局状态);disable(未使能)。 |
"normal" |
enableRelay |
否 |
boolean |
|
false |
堆叠多主检测场景下,设为检测代理设备。默认值为false。 |
false |
enableMadDetection |
否 |
boolean |
|
false |
堆叠多主检测场景下,代理模式双主检测开关。默认值为false。 |
false |
domainId |
否 |
int32 |
[0-255] |
- |
堆叠多主检测场景下,堆叠域编号,两个堆叠互相检测时,堆叠域编号需不同。 |
16 |
naMsgCheck |
否 |
boolean |
|
false |
NA报文检测,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
nsMsgCheck |
否 |
boolean |
|
false |
NS报文检测,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
rsMsgCheck |
否 |
boolean |
|
false |
RS报文检测,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
ipsgCheck |
否 |
boolean |
|
false |
IPSG检测使能开关。默认值为false。 |
false |
daiCheck |
否 |
boolean |
|
false |
DAI检测使能开关。默认值为false。 |
false |
collectDynamicMac |
否 |
boolean |
|
false |
动态MAC采集关闭使能开关。开关打开:动态MAC采集关闭;开关关闭:动态MAC采集使能。默认值为false。 |
false |
restoreIpSubnetVlanDefault |
否 |
boolean |
|
false |
IP子网划分Vlan开关是否恢复默认值。该属性为true时,ipSubnetVlanEnable属性不生效;该属性为false时,ipSubnetVlanEnable属性生效。默认值为false。 |
false |
ipSubnetVlanEnable |
否 |
boolean |
|
false |
IP子网划分Vlan开关。restoreIpSubnetVlanDefault为true时,该属性不生效;restoreIpSubnetVlanDefault为false时,该属性生效。默认值为false。 |
false |
linkUpDownTrapEnable |
否 |
boolean |
|
true |
SNMP TRAP使能开关。默认值为true。 |
true |
mdnsSnoopingEnable |
否 |
boolean |
|
false |
mdns Snooping使能开关。默认值为false。 |
false |
dnsSnoopingEnable |
否 |
boolean |
|
false |
DNS snooping开关。默认值为false。 |
false |
loopbackDetectEnabled |
否 |
boolean |
|
false |
环路检测使能开关。默认值为false。 |
false |
loopbackDetectAction |
否 |
string |
- |
shutdown |
环路检测处理动作。非V600版本设备取值范围:shutdown,alarm,block,nolearn,quitvlan。V600版本设备取值范围:alarm,block,errordown。 |
"shutdown" |
loopbackDetectVlans |
否 |
string |
- |
环路检测Vlan。1-4094范围内的数字或段,最多支持30个vlan,默认值为空。 |
"1,3-8" |
|
loopbackDetectRecoveryTime |
否 |
int32 |
[1-1000] |
- |
环路检测惩罚动作恢复时间,单位s。非V600版本设备取值范围:1-1000。V600版本设备取值范围:5-1000。 |
16 |
trust |
否 |
string |
- |
- |
trust字段是用来指定对报文按照某类优先级进行映射。可选值为dscp、8021p |
"dscp" |
loadBalance |
否 |
string |
0~15个字符。 |
- |
负载均衡模式。可选值为dst-ip | src-ip | src-dst-ip | dst-mac | src-mac | src-dst-mac | round-robin |
"src-dst-ip" |
lacpPriorityValue |
否 |
int32 |
[0-65535] |
32768 |
lacp优先级,该参数是为了区别同一设备不同接口的优先级,接口优先级高的将被选做活动接口。当Eth-Trunk的ethTrunkMode为lacp时,成员口该值生效。默认值为32768。 |
32768 |
portSecurityEnable |
否 |
boolean |
|
false |
port security 使能, 支持普通口和eth-Truck口, 不支持成员口。默认值为false。 |
false |
portSecurityMaxinum |
否 |
int32 |
[1-4096] |
1 |
port security 使能后, 交换机学习的mac地址数量上限,范围:1~4096。默认值为1。 |
1 |
stickyEnable |
否 |
boolean |
|
false |
sticky mac使能, 支持普通口和eth-Truck口, 不支持成员口。默认值为false。 |
false |
manualUpStream |
否 |
boolean |
|
false |
是否手动指定的上行口,默认值为false |
true |
outboundTrafficPolicy |
否 |
string |
- |
- |
出方向流量策略名称 |
"aaa" |
inboundTrafficPolicy |
否 |
string |
- |
- |
入方向流量策略名称 |
"bbb" |
voiceVlanEnable |
否 |
boolean |
|
- |
Voice VLAN使能 |
false |
voiceVlanId |
否 |
int32 |
[2-4094] |
- |
voiceVlanEnable使能后生效且必填,范围:2~4094。该VLAN必须在当前接口上放通,否则Voice VLAN功能将无法生效。当链路类型为Hybrid时,”Voice VLAN ID”必须与本接口的”Untagged VLAN”相同。 |
2 |
voiceVlanMode |
否 |
string |
- |
- |
voiceVlanEnable使能后生效且必填,提升语音报文优先级方式,取值范围:tag、untag,其中tag为VLAN方式,untag为MAC方式。 |
"tag" |
isolate |
否 |
boolean |
|
- |
远端模块端口隔离配置使能,若当前接口为上行口,堆叠口,eth-trunk成员口不能配置此参数。 |
false |
arpExpireTime |
否 |
int32 |
[30-62640] |
- |
ARP表项老化时间(秒)。 |
1200 |
portSecurityAction |
否 |
string |
0~16个字符。 |
- |
端口安全保护,取值:protect(丢弃),restrict(丢弃并告警),shutdown(关闭并告警)。 |
"protect" |
portSecurityAgingTime |
否 |
int32 |
[1-1440] |
- |
MAC老化时间(分钟)。 |
1440 |
portSecurityAgingType |
否 |
string |
0~16个字符。 |
- |
MAC老化类型,取值:absolute(绝对),inactivity(相对)。 |
"absolute" |
ethTrunkMode |
否 |
string |
- |
manual |
ethTrunk接口的工作模式。取值:lacp(lacp模式);manual(手工模式)。默认值为manual。 |
"manual" |
ethPnpStartSwitchEnable |
否 |
boolean |
|
- |
Eth-Trunk自协商。 |
false |
LswEthTrunkLacpConfigDto |
否 |
REFERENCE |
详细请参见表4。 |
交换机Eth-Trunk的LACP配置数据结构,结构体参见LswEthTrunkLacpConfigDto。 |
- |
|
portMemberList |
是 |
array<string> |
1-64 个列表项。 |
- |
EthTrunk接口成员列表。 |
["GigabitEthernet0/0/1","GigabitEthernet0/0/2"] |
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
lacpMode |
是 |
string |
- |
default |
lacp模式,取值范围:default,customize。当lacpMode为default时,lacpForceForward、leastActivenum、maxActivenum、lacpPreempt、preemptDelayTime、lacpTimeoutType、lacpTimeoutNum会按照默认值给设备下发,无需填写;当lacpMode为customize时,可选填lacpForceForward、leastActivenum、maxActivenum、lacpPreempt、preemptDelayTime、lacpTimeoutType、lacpTimeoutNum。默认值为default。 |
"customize" |
lacpForceForward |
否 |
boolean |
|
false |
使能lacp强制转发报文开关。 当lacpForceForward为true时,设置物理状态为Up的成员口,在对端没有加入Eth-Trunk时可以转发数据报文。当lacpForceForward为false时,可选填leastActivenum和maxActivenum参数,默认值为false。 |
false |
leastActivenum |
否 |
int32 |
[1-8] |
1 |
最小活动接口数量,用来配置链路聚合组活动接口数目的下限阈值。当lacpForceForward为false时,可填改参数。最小活动接口数量必须小于等于最大活动接口数量,且必须同时为空或非空,默认值为1。 |
1 |
maxActivenum |
否 |
int32 |
[1-8] |
8 |
最大活动接口数量,用来配置链路聚合组活动接口数目的上限阈值。当lacpForceForward为false时,可填改参数。且最小活动接口数量必须小于等于最大活动接口数量,且必须同时为空或非空,默认值为8。 |
8 |
lacpPreempt |
否 |
boolean |
|
false |
按优先级抢占开关。当lacpPreempt为true时,高优先级的链路会抢占低优先级链路,回切到活动状态。当lacpPreempt为false时,系统不会重新选择活动接口,故障恢复后的链路将作为备用链路。在进行优先级抢占时,系统将根据主动端接口的优先级进行抢占。默认值为false。 |
false |
preemptDelayTime |
否 |
int32 |
[10-180] |
30 |
抢占延迟时间,单位:秒。当lacpPreempt为true时,preemptDelayTime必填。默认值为30。 |
30 |
lacpTimeoutType |
否 |
string |
- |
slow |
协议超时模式,取值范围:fast、slow。当lacpTimeoutType为fast时,lacpTimeoutNum必填,对端发送LACP报文的周期是1秒,响应性能好,但占用系统资源相对slow参数情况较大。当lacpTimeoutType为slow时,对端发送LACP报文的周期是30秒,响应性能较fast低一些,但占用系统资源也比较少。默认值为slow。 |
"fast" |
lacpTimeoutNum |
否 |
int32 |
[3-90] |
3 |
接收报文超时时间。当lacpTimeoutType为fast时,lacpTimeoutNum必填。默认值为3。 |
3 |
请求示例
POST /controller/campus/v1/networkservice/networkconfig/net/lswport/devices/fbb684c8-0d37-496f-bafa-4b06d5151e2e/ethtrunk-ports HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "status" : true, "description" : "LSW interface", "linkType" : "trunk", "defaultVlan" : 1, "allowPassVlan" : "1,3-10", "untaggedVlan" : "11,12-16", "taggedVlan" : "1,3-10", "arpSnoopingEnable" : false, "dhcpSnooping" : false, "dhcpSnoopingTrusted" : false, "ndSnooping" : false, "ndSnoopingTrusted" : false, "portIsolation" : false, "stp" : true, "stpEdgedport" : "normal", "bpduFilter" : "normal", "enableRelay" : false, "enableMadDetection" : false, "domainId" : 16, "naMsgCheck" : false, "nsMsgCheck" : false, "rsMsgCheck" : false, "ipsgCheck" : false, "daiCheck" : false, "collectDynamicMac" : false, "restoreIpSubnetVlanDefault" : false, "ipSubnetVlanEnable" : false, "linkUpDownTrapEnable" : true, "mdnsSnoopingEnable" : false, "dnsSnoopingEnable" : false, "loopbackDetectEnabled" : false, "loopbackDetectAction" : "shutdown", "loopbackDetectVlans" : "1,3-8", "loopbackDetectRecoveryTime" : 16, "trust" : "dscp", "loadBalance" : "src-dst-ip", "lacpPriorityValue" : 32768, "portSecurityEnable" : false, "portSecurityMaxinum" : 1, "stickyEnable" : false, "manualUpStream" : true, "outboundTrafficPolicy" : "aaa", "inboundTrafficPolicy" : "bbb", "voiceVlanEnable" : false, "voiceVlanId" : 2, "voiceVlanMode" : "tag", "isolate" : false, "arpExpireTime" : 1200, "portSecurityAction" : "protect", "portSecurityAgingTime" : 1440, "portSecurityAgingType" : "absolute", "ethTrunkMode" : "manual", "ethPnpStartSwitchEnable" : false, "LswEthTrunkLacpConfigDto" : { "lacpMode" : "customize", "lacpForceForward" : false, "leastActivenum" : 1, "maxActivenum" : 8, "lacpPreempt" : false, "preemptDelayTime" : 30, "lacpTimeoutType" : "fast", "lacpTimeoutNum" : 3 }, "portMemberList" : ["GigabitEthernet0/0/1","GigabitEthernet0/0/2"] }
响应参数
返回状态码为200:创建交换机EthTrunk端口成功,返回EthTrunk端口信息结构体参见EthTrunkResponseDto。
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
errcode |
string |
0~64个字符。 |
- |
错误码。 |
"0" |
errmsg |
string |
0~256个字符。 |
- |
错误信息。 |
"" |
data |
REFERENCE |
详细请参见表6。 |
交换机EthTrunk端口配置数据,结构体参见LSWEthTrunkPortRespDto。 |
- |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
status |
boolean |
|
true |
接口管理状态(true为undo shutdown,false为shutdown)。默认值为true。 |
true |
description |
string |
0~242个字符。 |
- |
接口描述。 |
"LSW interface" |
linkType |
string |
- |
trunk |
链路类型,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。取值:access;trunk;hybrid;dot1q。默认值为trunk。 |
"trunk" |
defaultVlan |
int32 |
[1-4094] |
1 |
access类型下缺省VLAN;或trunk类型下pvid;或hybrid类型下缺省VLAN。若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为1。 |
1 |
allowPassVlan |
string |
0~13000个字符。 |
1 |
trunk类型下允许通过VLAN,接口为trunk类型时必填。allowPassVlan的取值要求:1到4094范围内的数字、段或all,如:1,3-10。默认值为1。 |
"1,3-10" |
untaggedVlan |
string |
0~100个字符。 |
1 |
hybrid类型下Untagged VLAN。untaggedVlan的取值要求:1到4094范围内的数字或段,如:11,12-16。不能配置和taggedVlan相同的数值。默认值为1。 |
"11,12-16" |
taggedVlan |
string |
0~100个字符。 |
- |
hybrid类型下Tagged VLAN。taggedVlan的取值要求:1到4094范围内的数字或段,如:1,3-10。不能配置和untaggedVlan相同的数值。 |
"1,3-10" |
arpSnoopingEnable |
boolean |
|
false |
ARP Snooping使能,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
dhcpSnooping |
boolean |
|
false |
DHCP Snooping使能,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
dhcpSnoopingTrusted |
boolean |
|
false |
配置接口为DHCP Snooping信任状态,默认为非信任状态。默认值为false。 |
false |
ndSnooping |
boolean |
|
false |
ND Snooping使能,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
ndSnoopingTrusted |
boolean |
|
false |
配置接口为ND Snooping信任状态,默认为非信任状态。默认值为false。 |
false |
portIsolation |
boolean |
|
false |
端口隔离使能,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
stp |
boolean |
|
true |
STP功能状态,取值:true(使能);false(未使能)。当STP为false时,stpEdgedport自动赋值为normal,传入其他参数无效。默认值为true。 |
true |
stpEdgedport |
string |
- |
normal |
STP边缘端口状态,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。取值:enable(使能);normal(遵从全局状态);disable(未使能)。默认值为normal。 |
"normal" |
bpduFilter |
string |
0~10个字符。 |
normal |
配置当前端口是否为BPDU filter端口。。取值:enable(使能);normal(遵从全局状态);disable(未使能)。 |
"normal" |
enableRelay |
boolean |
|
false |
堆叠多主检测场景下,设为检测代理设备。默认值为false。 |
false |
enableMadDetection |
boolean |
|
false |
堆叠多主检测场景下,代理模式双主检测开关。默认值为false。 |
false |
domainId |
int32 |
[0-255] |
- |
堆叠多主检测场景下,堆叠域编号,两个堆叠互相检测时,堆叠域编号需不同。 |
16 |
naMsgCheck |
boolean |
|
false |
NA报文检测,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
nsMsgCheck |
boolean |
|
false |
NS报文检测,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
rsMsgCheck |
boolean |
|
false |
RS报文检测,若当前是以太接口,其加入Eth-Trunk后不能配置此参数。默认值为false。 |
false |
ipsgCheck |
boolean |
|
false |
IPSG检测使能开关。默认值为false。 |
false |
daiCheck |
boolean |
|
false |
DAI检测使能开关。默认值为false。 |
false |
collectDynamicMac |
boolean |
|
false |
动态MAC采集关闭使能开关。开关打开:动态MAC采集关闭;开关关闭:动态MAC采集使能。默认值为false。 |
false |
restoreIpSubnetVlanDefault |
boolean |
|
false |
IP子网划分Vlan开关是否恢复默认值。该属性为true时,ipSubnetVlanEnable属性不生效;该属性为false时,ipSubnetVlanEnable属性生效。默认值为false。 |
false |
ipSubnetVlanEnable |
boolean |
|
false |
IP子网划分Vlan开关。restoreIpSubnetVlanDefault为true时,该属性不生效;restoreIpSubnetVlanDefault为false时,该属性生效。默认值为false。 |
false |
linkUpDownTrapEnable |
boolean |
|
true |
SNMP TRAP使能开关。默认值为true。 |
true |
mdnsSnoopingEnable |
boolean |
|
false |
mdns Snooping使能开关。默认值为false。 |
false |
dnsSnoopingEnable |
boolean |
|
false |
DNS snooping开关。默认值为false。 |
false |
loopbackDetectEnabled |
boolean |
|
false |
环路检测使能开关。默认值为false。 |
false |
loopbackDetectAction |
string |
- |
shutdown |
环路检测处理动作。非V600版本设备取值范围:shutdown,alarm,block,nolearn,quitvlan。V600版本设备取值范围:alarm,block,errordown。 |
"shutdown" |
loopbackDetectVlans |
string |
- |
环路检测Vlan。1-4094范围内的数字或段,最多支持30个vlan,默认值为空。 |
"1,3-8" |
|
loopbackDetectRecoveryTime |
int32 |
[1-1000] |
- |
环路检测惩罚动作恢复时间,单位s。非V600版本设备取值范围:1-1000。V600版本设备取值范围:5-1000。 |
16 |
trust |
string |
- |
- |
trust字段是用来指定对报文按照某类优先级进行映射。可选值为dscp、8021p |
"dscp" |
loadBalance |
string |
0~15个字符。 |
- |
负载均衡模式。可选值为dst-ip | src-ip | src-dst-ip | dst-mac | src-mac | src-dst-mac | round-robin |
"src-dst-ip" |
lacpPriorityValue |
int32 |
[0-65535] |
32768 |
lacp优先级,该参数是为了区别同一设备不同接口的优先级,接口优先级高的将被选做活动接口。当Eth-Trunk的ethTrunkMode为lacp时,成员口该值生效。默认值为32768。 |
32768 |
portSecurityEnable |
boolean |
|
false |
port security 使能, 支持普通口和eth-Truck口, 不支持成员口。默认值为false。 |
false |
portSecurityMaxinum |
int32 |
[1-4096] |
1 |
port security 使能后, 交换机学习的mac地址数量上限,范围:1~4096。默认值为1。 |
1 |
stickyEnable |
boolean |
|
false |
sticky mac使能, 支持普通口和eth-Truck口, 不支持成员口。默认值为false。 |
false |
manualUpStream |
boolean |
|
false |
是否手动指定的上行口,默认值为false |
true |
outboundTrafficPolicy |
string |
- |
- |
出方向流量策略名称 |
"aaa" |
inboundTrafficPolicy |
string |
- |
- |
入方向流量策略名称 |
"bbb" |
voiceVlanEnable |
boolean |
|
- |
Voice VLAN使能 |
false |
voiceVlanId |
int32 |
[2-4094] |
- |
voiceVlanEnable使能后生效且必填,范围:2~4094。该VLAN必须在当前接口上放通,否则Voice VLAN功能将无法生效。当链路类型为Hybrid时,”Voice VLAN ID”必须与本接口的”Untagged VLAN”相同。 |
2 |
voiceVlanMode |
string |
- |
- |
voiceVlanEnable使能后生效且必填,提升语音报文优先级方式,取值范围:tag、untag,其中tag为VLAN方式,untag为MAC方式。 |
"tag" |
isolate |
boolean |
|
- |
远端模块端口隔离配置使能,若当前接口为上行口,堆叠口,eth-trunk成员口不能配置此参数。 |
false |
arpExpireTime |
int32 |
[30-62640] |
- |
ARP表项老化时间(秒)。 |
1200 |
portSecurityAction |
string |
0~16个字符。 |
- |
端口安全保护,取值:protect(丢弃),restrict(丢弃并告警),shutdown(关闭并告警)。 |
"protect" |
portSecurityAgingTime |
int32 |
[1-1440] |
- |
MAC老化时间(分钟)。 |
1440 |
portSecurityAgingType |
string |
0~16个字符。 |
- |
MAC老化类型,取值:absolute(绝对),inactivity(相对)。 |
"absolute" |
ethTrunkMode |
string |
- |
manual |
ethTrunk接口的工作模式。取值:lacp(lacp模式);manual(手工模式)。默认值为manual。 |
"manual" |
ethPnpStartSwitchEnable |
boolean |
|
- |
Eth-Trunk自协商。 |
false |
LswEthTrunkLacpConfigDto |
REFERENCE |
详细请参见表9。 |
交换机Eth-Trunk的LACP配置数据结构,结构体参见LswEthTrunkLacpConfigDto。 |
- |
|
portMemberList |
array<string> |
1-64 个列表项。 |
- |
EthTrunk接口成员列表。 |
["GigabitEthernet0/0/1","GigabitEthernet0/0/2"] |
name |
string |
10~12个字符。 |
- |
EthTrunk端口名称,必须是Eth-Trunk[数字]的格式,数字最大511。 |
"Eth-Trunk1" |
返回状态码为201:创建交换机EthTrunk端口成功,返回EthTrunk端口信息,结构体参见EthTrunkResponseDto。
EthTrunkResponseDto对象的参数列表,详细请参见表5。
响应示例
返回状态码为200:创建交换机EthTrunk端口成功,返回EthTrunk端口信息结构体参见EthTrunkResponseDto。
HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "status" : true, "description" : "LSW interface", "linkType" : "trunk", "defaultVlan" : 1, "allowPassVlan" : "1,3-10", "untaggedVlan" : "11,12-16", "taggedVlan" : "1,3-10", "arpSnoopingEnable" : false, "dhcpSnooping" : false, "dhcpSnoopingTrusted" : false, "ndSnooping" : false, "ndSnoopingTrusted" : false, "portIsolation" : false, "stp" : true, "stpEdgedport" : "normal", "bpduFilter" : "normal", "enableRelay" : false, "enableMadDetection" : false, "domainId" : 16, "naMsgCheck" : false, "nsMsgCheck" : false, "rsMsgCheck" : false, "ipsgCheck" : false, "daiCheck" : false, "collectDynamicMac" : false, "restoreIpSubnetVlanDefault" : false, "ipSubnetVlanEnable" : false, "linkUpDownTrapEnable" : true, "mdnsSnoopingEnable" : false, "dnsSnoopingEnable" : false, "loopbackDetectEnabled" : false, "loopbackDetectAction" : "shutdown", "loopbackDetectVlans" : "1,3-8", "loopbackDetectRecoveryTime" : 16, "trust" : "dscp", "loadBalance" : "src-dst-ip", "lacpPriorityValue" : 32768, "portSecurityEnable" : false, "portSecurityMaxinum" : 1, "stickyEnable" : false, "manualUpStream" : true, "outboundTrafficPolicy" : "aaa", "inboundTrafficPolicy" : "bbb", "voiceVlanEnable" : false, "voiceVlanId" : 2, "voiceVlanMode" : "tag", "isolate" : false, "arpExpireTime" : 1200, "portSecurityAction" : "protect", "portSecurityAgingTime" : 1440, "portSecurityAgingType" : "absolute", "ethTrunkMode" : "manual", "ethPnpStartSwitchEnable" : false, "LswEthTrunkLacpConfigDto" : { "lacpMode" : "customize", "lacpForceForward" : false, "leastActivenum" : 1, "maxActivenum" : 8, "lacpPreempt" : false, "preemptDelayTime" : 30, "lacpTimeoutType" : "fast", "lacpTimeoutNum" : 3 }, "portMemberList" : ["GigabitEthernet0/0/1","GigabitEthernet0/0/2"], "name" : "Eth-Trunk1" } }
返回状态码为201:创建交换机EthTrunk端口成功,返回EthTrunk端口信息,结构体参见EthTrunkResponseDto。
HTTP/1.1 201 Created Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "status" : true, "description" : "LSW interface", "linkType" : "trunk", "defaultVlan" : 1, "allowPassVlan" : "1,3-10", "untaggedVlan" : "11,12-16", "taggedVlan" : "1,3-10", "arpSnoopingEnable" : false, "dhcpSnooping" : false, "dhcpSnoopingTrusted" : false, "ndSnooping" : false, "ndSnoopingTrusted" : false, "portIsolation" : false, "stp" : true, "stpEdgedport" : "normal", "bpduFilter" : "normal", "enableRelay" : false, "enableMadDetection" : false, "domainId" : 16, "naMsgCheck" : false, "nsMsgCheck" : false, "rsMsgCheck" : false, "ipsgCheck" : false, "daiCheck" : false, "collectDynamicMac" : false, "restoreIpSubnetVlanDefault" : false, "ipSubnetVlanEnable" : false, "linkUpDownTrapEnable" : true, "mdnsSnoopingEnable" : false, "dnsSnoopingEnable" : false, "loopbackDetectEnabled" : false, "loopbackDetectAction" : "shutdown", "loopbackDetectVlans" : "1,3-8", "loopbackDetectRecoveryTime" : 16, "trust" : "dscp", "loadBalance" : "src-dst-ip", "lacpPriorityValue" : 32768, "portSecurityEnable" : false, "portSecurityMaxinum" : 1, "stickyEnable" : false, "manualUpStream" : true, "outboundTrafficPolicy" : "aaa", "inboundTrafficPolicy" : "bbb", "voiceVlanEnable" : false, "voiceVlanId" : 2, "voiceVlanMode" : "tag", "isolate" : false, "arpExpireTime" : 1200, "portSecurityAction" : "protect", "portSecurityAgingTime" : 1440, "portSecurityAgingType" : "absolute", "ethTrunkMode" : "manual", "ethPnpStartSwitchEnable" : false, "LswEthTrunkLacpConfigDto" : { "lacpMode" : "customize", "lacpForceForward" : false, "leastActivenum" : 1, "maxActivenum" : 8, "lacpPreempt" : false, "preemptDelayTime" : 30, "lacpTimeoutType" : "fast", "lacpTimeoutNum" : 3 }, "portMemberList" : ["GigabitEthernet0/0/1","GigabitEthernet0/0/2"], "name" : "Eth-Trunk1" } }