响应参数 返回状态码为200：查询成功，返回结构体参见PnpEnableResponseDto。 表2 PnpEnableResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" data REFERENCE 详细请参见表3。 - - 表3 PnpEnableDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 pnpEnable boolean true false false PNP功能使能。默认值为false。 false pnpLinkAggregationDisable boolean true false false PNP自协商功能使能。默认值为false。 false

URI /controller/campus/v1/networkservice/networkconfig/net/lswmgmtvlan/sites/{siteId}/pnpenable 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 string 32~36个字符。 - 站点ID, UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"

响应示例 返回状态码为200：查询成功，返回结构体参见PnpEnableResponseDto。 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" : { "pnpEnable" : false, "pnpLinkAggregationDisable" : false } }

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

请求示例 HTTP的示例 PUT /controller/campus/v1/networkservice/networkconfig/net/lswmgmtvlan/sites/fbb684c8-0d37-496f-bafa-4b06d5151e2e/pnpenable 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 { "pnpEnable" : false, "pnpLinkAggregationDisable" : false }

URI /controller/campus/v1/networkservice/networkconfig/net/lswmgmtvlan/sites/{siteId}/pnpenable 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 string 32~36个字符。 - 站点ID, UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"

响应示例 返回状态码为200：修改成功，返回结构体参见PnpEnableResponseDto。 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" : { "pnpEnable" : false, "pnpLinkAggregationDisable" : false } }

请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表3。 站点内自协商管理VLAN配置参数体，结构体参见PnpEnableDto。 - 表3 PnpEnableDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 pnpEnable 是 boolean true false false PNP功能使能。默认值为false。 false pnpLinkAggregationDisable 否 boolean true false false PNP自协商功能使能。默认值为false。 false

响应示例 返回状态码为200：修改成功，返回结构体参见MgmtVlanResponseDto。 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" : { "vlanId" : 10, "wiredPnpVlanId" : 10, "wirelessPnpVlanId" : 10, "ipType" : "IPv4", "ip" : "10.0.0.10", "mask" : "24", "gateway" : "10.0.0.254", "isAutoAddUpPort" : false, "isLinkAggregationReceive" : false, "identifyStaticRoute" : true, "destinationMask" : "22", "destinationPrefixIp" : "10.20.0.0", "preference" : 5 } }

请求示例 HTTP的示例 PUT /controller/campus/v1/networkservice/networkconfig/net/lswmgmtvlan/devices/fbb684c8-0d37-496f-bafa-4b06d5151e2e/mgmtvlan 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 { "vlanId" : 10, "wiredPnpVlanId" : 10, "wirelessPnpVlanId" : 10, "ipType" : "IPv4", "ip" : "10.0.0.10", "mask" : "24", "gateway" : "10.0.0.254", "isAutoAddUpPort" : false, "isLinkAggregationReceive" : false, "identifyStaticRoute" : true, "destinationMask" : "22", "destinationPrefixIp" : "10.20.0.0", "preference" : 5 }

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

请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表3。 站点内交换机的管理VLAN配置参数体，结构体参见MgmtVlanDto。 - 表3 MgmtVlanDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 vlanId 否 int32 [1-4094] - 管理VLAN，该参数可选值为“默认”、“自定义”，当选择“自定义”时，该值为必填。 10 wiredPnpVlanId 否 int32 [1-4094] - 有线自协商管理VLAN。 10 wirelessPnpVlanId 否 int32 [1-4094] - 无线自协商管理VLAN。 10 ipType 否 string 0~10个字符。 IPv4 IP类型，支持IPv4和IPv6。当ip，mask，gateway没传时，IP获取类方式默认为动态，此参数无效，会根据设备所在站点的南向接入IP类型自动判断是IPv4还是IPv6；当ip，mask，gateway传值时，此参数生效。为了向前兼容，该缺省值为IPv4。 "IPv4" ip 否 string - - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 静态IP地址，支持配置单播IP地址，IP格式需要与ipType字段中的IP类型匹配。参数ip、mask、gateway填写时需同时填写。 "10.0.0.10" mask 否 string - - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 掩码范围是（IPv4:1~32,IPv6:1~128）范围内的整数。参数ip、mask、gateway填写时需同时填写。 "24" gateway 否 string - - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 网关地址，支持配置单播IP地址，IP格式需要与ipType字段中的IP类型匹配。参数ip、mask、gateway填写时需同时填写。 "10.0.0.254" isAutoAddUpPort 否 boolean true false false 上行口自动放行。默认值为false。 false isLinkAggregationReceive 否 boolean true false - 支持Eth-trunk自协商固化配置,设备上线协商后才支持配置,默认为空,相关节点不做下发 false identifyStaticRoute 否 boolean true false false 自定义静态路由。默认值为false。 true destinationMask 否 string 1~3个字符。 - 掩码，不允许修改。范围：（IPv4:1~32,IPv6:1~128） "22" destinationPrefixIp 否 string 1~45个字符。 - 目的地址，必填。必须是合法的IPv4或IPv6地址，IP格式需要与ipType字段中的IP类型匹配，不允许修改。 "10.20.0.0" preference 否 integer [1-255] - 优先级。取值越小，优先等级越高，不填时默认为60。 5

响应示例 返回状态码为200：查询成功,返回结构体参见MgmtVlanResponseDto。 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" : { "vlanId" : 10, "wiredPnpVlanId" : 10, "wirelessPnpVlanId" : 10, "ipType" : "IPv4", "ip" : "10.0.0.10", "mask" : "24", "gateway" : "10.0.0.254", "isAutoAddUpPort" : false, "isLinkAggregationReceive" : false, "identifyStaticRoute" : true, "destinationMask" : "22", "destinationPrefixIp" : "10.20.0.0", "preference" : 5 } }

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

响应参数 返回状态码为200：查询成功,返回结构体参见MgmtVlanResponseDto。 表2 MgmtVlanResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" data REFERENCE 详细请参见表3。 - - 表3 MgmtVlanDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 vlanId int32 [1-4094] - 管理VLAN，该参数可选值为“默认”、“自定义”，当选择“自定义”时，该值为必填。 10 wiredPnpVlanId int32 [1-4094] - 有线自协商管理VLAN。 10 wirelessPnpVlanId int32 [1-4094] - 无线自协商管理VLAN。 10 ipType string 0~10个字符。 IPv4 IP类型，支持IPv4和IPv6。当ip，mask，gateway没传时，IP获取类方式默认为动态，此参数无效，会根据设备所在站点的南向接入IP类型自动判断是IPv4还是IPv6；当ip，mask，gateway传值时，此参数生效。为了向前兼容，该缺省值为IPv4。 "IPv4" ip string - - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 静态IP地址，支持配置单播IP地址，IP格式需要与ipType字段中的IP类型匹配。参数ip、mask、gateway填写时需同时填写。 "10.0.0.10" mask string - - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 掩码范围是（IPv4:1~32,IPv6:1~128）范围内的整数。参数ip、mask、gateway填写时需同时填写。 "24" gateway string - - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 网关地址，支持配置单播IP地址，IP格式需要与ipType字段中的IP类型匹配。参数ip、mask、gateway填写时需同时填写。 "10.0.0.254" isAutoAddUpPort boolean true false false 上行口自动放行。默认值为false。 false isLinkAggregationReceive boolean true false - 支持Eth-trunk自协商固化配置,设备上线协商后才支持配置,默认为空,相关节点不做下发 false identifyStaticRoute boolean true false false 自定义静态路由。默认值为false。 true destinationMask string 1~3个字符。 - 掩码，不允许修改。范围：（IPv4:1~32,IPv6:1~128） "22" destinationPrefixIp string 1~45个字符。 - 目的地址，必填。必须是合法的IPv4或IPv6地址，IP格式需要与ipType字段中的IP类型匹配，不允许修改。 "10.20.0.0" preference integer [1-255] - 优先级。取值越小，优先等级越高，不填时默认为60。 5