响应示例 返回状态码为200：创建交换机EthTrunk端口成功，返回EthTrunk端口信息结构体参见EthTrunkResponseDto。 HTTP/1.1 200 OK Date: Sun,11 May 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,11 May 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" } }

请求示例 HTTP的示例 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-AC CES S-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"] }

URI /controller/campus/v1/networkservice/networkconfig/net/lswport/devices/{deviceId}/ethtrunk-ports 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 是 uuid - - 设备ID。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"

响应示例 返回状态码为200：修改成功，返回配置后的端口配置信息，结构体参见ResponseDto。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "" } 返回状态码为400：校验异常，结构体参见ResponseDto。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "" }

响应参数 返回状态码为200：修改成功，返回配置后的端口配置信息，结构体参见ResponseDto。 表4 ResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" 返回状态码为400：校验异常，结构体参见ResponseDto。 ResponseDto对象的参数列表，详细请参见表4。

URI /controller/campus/v1/networkservice/networkconfig/net/lswport/devices/{deviceId}/changeInterfaceMode 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 是 uuid 36个字符。 - 设备ID。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"

请求示例 HTTP的示例 PUT /controller/campus/v1/networkservice/networkconfig/net/lswport/devices/fbb684c8-0d37-496f-bafa-4b06d5151e2e/changeInterfaceMode 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 { "interfaceNames" : ["GigabitEthernet0/0/1","GigabitEthernet0/0/2"], "targetMode" : "100GE" }

响应示例 返回状态码为200：查询成功，返回设备所有端口列表，结构体参见GetResponseDto。 HTTP/1.1 200 OK Date: Sun,11 May 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" : [ { "ethernetList" : [ { "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", "name" : "GigabitEthernet0/0/1", "autoNegotiationEnable" : false, "speed" : "1Gbps", "duplex" : "full", "stormControl" : false, "stormControlModel" : "packet", "stormControlMaxRate" : 3000, "stormControlMinRate" : 1, "stormControlInterval" : 5, "stormControlAction" : "block", "stormControlLog" : false, "stormControlTrap" : false, "poe" : true, "timeTemplateId" : "b90f8190-e12f-4323-95f3-4018309209c4", "transApPower" : true, "poweronLegacyLevel" : "normal", "poweronDelayTime" : 5, "lldp" : true, "appDpiEnable" : false, "appTrafficStatisticsEnable" : false, "cdp" : false, "congestionMgrEnable" : true, "pnpStartSwitchEnable" : false, "opticalPortLldpEnable" : false, "electricalPortName" : "MultiGE0/0/6", "congestionMgrList" : [ { "id" : 0, "scheduleMode" : "PQ", "weight" : 100 } ], "trafficShapingEnable" : true, "queueShapingList" : [ { "id" : 0, "cir" : 100, "pir" : 100, "cbs" : 4000, "pbs" : 8000 } ], "interfaceShapingList" : [ { "direction" : "inbound", "cir" : 100, "cbs" : 4000 } ], "portEnableDelayTime" : 1800, "isSupportAutoNegotiation" : true, "isSupportPoe" : true, "media" : "copper", "isUpStream" : false } ], "ethTrunkList" : [ { "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", "isUpStream" : false } ] } ] }

请求示例 HTTP的示例 GET /controller/campus/v1/networkservice/networkconfig/net/lswport/devices/fbb684c8-0d37-496f-bafa-4b06d5151e2e/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

请求示例 HTTP的示例 DELETE /controller/campus/v1/networkservice/networkconfig/net/lswport/devices/fbb684c8-0d37-496f-bafa-4b06d5151e2e/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 { "interfaceNames" : ["GigabitEthernet0/0/1","GigabitEthernet0/0/2"] }

响应示例 返回状态码为200：重置交换机端口配置成功，返回结构体参见ConfigResetResponseDto。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "success" : [ "" ], "fail" : [ "" ] }

URI /controller/campus/v1/networkservice/networkconfig/net/lswport/devices/{deviceId}/ports 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 是 string 36个字符。 - 设备ID。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"