华为乾坤-修改交换机端口配置:响应参数
响应参数
返回状态码为200:修改成功,返回配置后的端口配置信息,结构体参见PutResponseDto。
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
errcode |
string |
0~64个字符。 |
- |
错误码。 |
"0" |
errmsg |
string |
0~256个字符。 |
- |
错误信息。 |
"" |
success |
ARRAY_REFERENCE |
详细请参见表8。 |
交换机端口配置数据,结构体参见LSWEthPortDto。 |
- |
|
fail |
ARRAY_REFERENCE |
详细请参见表9。 |
交换机端口配置数据,结构体参见PutResponseFailDto。 |
- |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
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" |
name |
string |
1~32个字符。 |
- |
接口名称。 |
"GigabitEthernet0/0/1" |
autoNegotiationEnable |
boolean |
|
- |
接口自协商状态,根据款型确定默认值;端口支持自协商时必填。 |
false |
speed |
string |
- |
- |
接口速率。可选值:1Gbps,100Mbps,10Mbps,根据款型确定默认值;自协商关闭时必填。 |
"1Gbps" |
duplex |
string |
- |
- |
双工模式, 根据款型确定默认值,自协商关闭时必填。取值:half(半双工);full(全双工)。 |
"full" |
stormControl |
boolean |
|
false |
风暴控制使能。默认值为false。 |
false |
stormControlModel |
string |
0~7个字符。 |
- |
风暴控制模式。取值:packet(包模式),cir(字节模式), percent(百分比模式)。当stormControl字段值为true时,该字段必填。 |
"packet" |
stormControlMaxRate |
int32 |
[1-59524000] |
- |
风暴控制包模式最大阈值,单位pps。当stormControl字段值为true时,该字段必填。 |
3000 |
stormControlMinRate |
int32 |
[1-59524000] |
- |
风暴控制包模式最小阈值,单位pps。当stormControl字段值为true时,该字段必填。 |
1 |
stormControlInterval |
int32 |
[1-180] |
5 |
风暴控制检测时间间隔,单位s。当stormControl字段值为true时,该字段必填。默认值为5。 |
5 |
stormControlAction |
string |
0~10个字符。 |
block |
风暴控制动作。取值:block(阻塞报文),suppress(抑制报文),error-down(关闭接口),默认值block。 |
"block" |
stormControlLog |
boolean |
|
false |
风暴控制使能记录日志。默认值为false。 |
false |
stormControlTrap |
boolean |
|
false |
风暴控制使能上报告警。默认值为false。 |
false |
poe |
boolean |
|
true |
端口POE使能,支持poe的端口默认值为true;不支持的端口,不能传参。 |
true |
timeTemplateId |
string |
0~36个字符。 |
- |
PoE上电时间模板ID。UUID格式。当poe为true时,timeTemplateId生效。时间模板ID可以通过第三方开放接口/controller/campus/v3/networkconfig/timetemplate得到。 |
"b90f8190-e12f-4323-95f3-4018309209c4" |
transApPower |
boolean |
|
false |
端口传递POE功率到AP使能,支持poe的端口默认值为false;不支持的端口,不能传参。 |
true |
poweronLegacyLevel |
string |
- |
normal |
POE工作模式,poe打开时使用此参数。取值:normal(普通供电);legacy(非标PD供电);force(强制PD供电)。 |
"normal" |
poweronDelayTime |
int32 |
[0-10] |
- |
POE接口供电延迟时间,单位秒。poe打开时使用此参数,该字段非必填。 |
5 |
lldp |
boolean |
|
true |
端口LLDP使能,默认值为true。若使用CDP发现协议的设备需要使用LLDP功能,需要将LLDP置为true,同时CDP为true。 |
true |
appDpiEnable |
boolean |
|
- |
应用识别开关 |
false |
appTrafficStatisticsEnable |
boolean |
|
- |
应用流量统计开关 |
false |
cdp |
boolean |
|
false |
端口CDP使能,默认值为false。 |
false |
congestionMgrEnable |
boolean |
|
false |
接口拥塞管理使能,默认值为false,开启时,congestionMgrList字段不能为空。 |
true |
pnpStartSwitchEnable |
boolean |
|
- |
管理VLAN自协商。 |
false |
opticalPortLldpEnable |
boolean |
|
- |
光口LLDP代理使能,仅S5732-H48XUM2CC生效。 |
false |
electricalPortName |
string |
- |
- |
电口名称,仅S5732-H48XUM2CC生效。 |
"MultiGE0/0/6" |
congestionMgrList |
ARRAY_REFERENCE |
0-8个列表项,详细请参见表5。 |
拥塞管理队列,配置时需使能拥塞管理开关,结构体参见CongestionMgrInfo。 |
- |
|
trafficShapingEnable |
boolean |
|
false |
接口流量整形使能,默认值为false,开启时,queueShapingList字段和interfaceShapingList字段不能同时为空。 |
true |
queueShapingList |
ARRAY_REFERENCE |
0-8个列表项,详细请参见表6。 |
队列整形,配置时需使能接口流量整形开关,结构体参见QueueShapingInfo。 |
- |
|
interfaceShapingList |
ARRAY_REFERENCE |
0-2个列表项,详细请参见表7。 |
接口整形,配置时需使能接口流量整形开关,结构体参见InterfaceShapingInfo。 |
- |
|
portEnableDelayTime |
int32 |
[0-3600] |
- |
接口UP延迟时间(秒),非V600版本设备必须是10的倍数。非V600版本设备范围0-1800,V600版本设备0-3600。 |
1800 |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
errcode |
string |
0~64个字符。 |
- |
错误码。 |
"0" |
errmsg |
string |
0~256个字符。 |
- |
错误信息。 |
"" |
data |
REFERENCE |
详细请参见表8。 |
交换机以太端口配置数据,结构体参见LSWEthPortDto。 |
- |