响应示例 返回状态码为200：修改SD-WAN Wlan子网参数体。 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 { "errparams" : [ "siteId" ], "errcode" : "0", "errmsg" : "" }

请求示例 HTTP的示例 PUT /controller/campus/ui/v1/sdwan/lan/wlans 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 { "vpnId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "subnets" : [ { "vpnId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "deviceName" : "device1", "id" : "00000000-0000-0000-0000-000000000000", "ssid" : "接入描述。", "effectiveRadio" : "RADIO_2.4GHZ", "vlanId" : "100", "encryptionMethod" : "WPA1", "sharedKey" : "Example@123", "hideSsid" : false, "maxAccessNum" : "30", "downLinkTraffic" : "1200", "upLinkTraffic" : "1400", "enableRadioConfig" : false, "transmitPower" : "1", "countryCode" : "CN", "channelBandwidth" : "20mhz", "channel" : "1", "enableWlan" : true } ] }

响应示例 返回状态码为200：删除SD-WAN Wlan子网返回体。 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 { "errparams" : [ "siteId" ], "errcode" : "0", "errmsg" : "" }

请求示例 HTTP的示例 POST /controller/campus/ui/v1/sdwan/lan/wlans/action/batch-delete 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 { "vpnId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "subnets" : [ { "vpnId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "deviceName" : "device1", "id" : "00000000-0000-0000-0000-000000000000", "ssid" : "接入描述。", "effectiveRadio" : "RADIO_2.4GHZ", "vlanId" : "100", "encryptionMethod" : "WPA1", "sharedKey" : "Example@123", "hideSsid" : false, "maxAccessNum" : "30", "downLinkTraffic" : "1200", "upLinkTraffic" : "1400", "enableRadioConfig" : false, "transmitPower" : "1", "countryCode" : "CN", "channelBandwidth" : "20mhz", "channel" : "1", "enableWlan" : true } ] }

响应示例 返回状态码为200：创建SD-WAN Wlan子网返回体。 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 { "errparams" : [ "siteId" ], "errcode" : "0", "errmsg" : "" }

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表2。 创建SD-WAN Wlan子网参数体。 - 表2 Wlans对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 vpnId 否 uuid 0~36个字符。 - vpn id标识，创建或修改时必填。 "00000000-0000-0000-0000-000000000000" siteId 否 uuid 0~36个字符。 - 站点id标识，创建或修改时必填。 "00000000-0000-0000-0000-000000000000" subnets 否 ARRAY_REFERENCE 0-10000个列表项，详细请参见表3。 站点Wlan子网配置基本数据。 - 表3 Wlan对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 vpnId 是 uuid 0~36个字符。 - 子网附着的VPN ID，创建或修改时必填。 "00000000-0000-0000-0000-000000000000" siteId 是 uuid 0~36个字符。 - 子网附着的站点ID，创建或修改时必填。 "00000000-0000-0000-0000-000000000000" deviceId 否 uuid 0~36个字符。 - 设备ID，创建或修改时必填。 "00000000-0000-0000-0000-000000000000" deviceName 否 string 0~256个字符。 - 设备名称。 "device1" id 否 uuid 0~36个字符。 - 子网ID，用来识别更新还是增加的关键元素，修改时必填。 "00000000-0000-0000-0000-000000000000" ssid 否 string 1~32个字符。 - 可输入的字符串长度为1～32字符,不能包含问号,双引号不能出现在字符甲的首尾，不支持中文字符，创建或修改时必填。 "接入描述。" effectiveRadio 否 string RADIO_2.4GHZ RADIO_5GHZ RADIO_2.4GHZ radio类型，创建或修改时必填。取值范围：RADIO_2.4GHZ、RADIO_5GHZ "RADIO_2.4GHZ" vlanId 否 string 0~32个字符。 - 子网vlan id，需提前创建vlan，创建或修改时必填。 "100" encryptionMethod 否 string WPA1 WPA2 WPA1 认证模式，创建或修改时必填。取值范围：WPA1、WPA2 "WPA1" sharedKey 否 string 0~63个字符。 - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 密码，创建时必填。PSK必须包含如下规则：PSK长度必须在8-63位。PSK必须满足复杂度，即必须包含特殊字符（"`!@#$%^&()_+=-[]{},.;）、英文大写字母（A~Z）、英文小写字母（a~z）、数字（0~9）中的任意两种组合。 "Example@123" hideSsid 否 boolean true false false 是否启用隐藏ssid。 false maxAccessNum 否 string 0~4个字符。 - SSID能接入的最大用户数，创建或修改时必填。 "30" downLinkTraffic 否 string 0~32个字符。 - 下行链路流量带宽限制，创建或修改时必填。 "1200" upLinkTraffic 否 string 0~32个字符。 - 上行链路流量带宽限制，创建或修改时必填。 "1400" enableRadioConfig 否 boolean true false false 是否启用dns。 false transmitPower 否 string 0~12个字符。 - 功率等级。 "1" countryCode 否 string 1~32个字符。 - 国家码。 "CN" channelBandwidth 否 string 20mhz 40mhz-minus 40mhz-plus 80mhz 160mhz 20mhz 信道带宽。取值范围：20mhz、40mhz-minus、40mhz-plus、80mhz "20mhz" channel 否 string 0~12个字符。 - 信道，根据信道带宽这个值也不一样。 "1" enableWlan 否 boolean true false true 是否开启wlan true

请求示例 HTTP的示例 POST /controller/campus/ui/v1/sdwan/lan/wlans 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 { "vpnId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "subnets" : [ { "vpnId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "deviceName" : "device1", "id" : "00000000-0000-0000-0000-000000000000", "ssid" : "接入描述。", "effectiveRadio" : "RADIO_2.4GHZ", "vlanId" : "100", "encryptionMethod" : "WPA1", "sharedKey" : "Example@123", "hideSsid" : false, "maxAccessNum" : "30", "downLinkTraffic" : "1200", "upLinkTraffic" : "1400", "enableRadioConfig" : false, "transmitPower" : "1", "countryCode" : "CN", "channelBandwidth" : "20mhz", "channel" : "1", "enableWlan" : true } ] }

请求示例 HTTP的示例 GET /controller/campus/ui/v1/sdwan/lan/wlans?site_id=00000000-0000-0000-0000-000000000000&vpn_id=00000000-0000-0000-0000-000000000000 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

URI /controller/campus/ui/v1/sdwan/lan/wlans 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 site_id 是 uuid 0~36个字符。 - 站点ID。 "00000000-0000-0000-0000-000000000000" vpn_id 否 uuid 0~36个字符。 - VPN业务ID。 "00000000-0000-0000-0000-000000000000"

响应示例 返回状态码为200：查询成功，查询指定站点的所有LAN子网列表。 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 { "errparams" : [ "siteId" ], "errcode" : "0", "errmsg" : "", "data" : { "Subnets" : [ { "vpnId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "deviceName" : "device1", "id" : "00000000-0000-0000-0000-000000000000", "ssid" : "接入描述。", "effectiveRadio" : "RADIO_2.4GHZ", "vlanId" : "100", "encryptionMethod" : "WPA1", "sharedKey" : "Example@123", "hideSsid" : false, "maxAccessNum" : "30", "downLinkTraffic" : "1200", "upLinkTraffic" : "1400", "enableRadioConfig" : false, "transmitPower" : "1", "countryCode" : "CN", "channelBandwidth" : "20mhz", "channel" : "1", "enableWlan" : true } ] } }