查询AP站点模板射频配置信息
典型场景
提供查询AP站点模板射频配置信息接口。
接口功能
查询AP站点模板射频配置信息。
接口约束
该接口支持租户视图或msp代维视图下,用户角色为“Open Api Operator”的用户访问,必须在用户会话建立后使用。
调用方法
GET
URI
/controller/campus/v3/networkconfig/site-templates/{siteTemplateId}/apradio
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
siteTemplateId |
是 |
string |
- |
- |
站点模板ID,UUID格式。 |
"fbde1c5d-5b94-49e3-a912-48641015e45c" |
请求参数
无
请求示例
GET /controller/campus/v3/networkconfig/site-templates/fbde1c5d-5b94-49e3-a912-48641015e45c/apradio 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:查询AP站点模板射频配置结果,返回结构体参见。
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
errcode |
string |
- |
- |
错误码。 |
"0" |
errmsg |
string |
- |
- |
错误信息。 |
"" |
data |
REFERENCE |
详细请参见表3。 |
站点模板射频配置信息,结构体参见SiteTemplateGroupRadioDto。 |
- |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
countryCode |
string |
- |
CN |
国家码。支持的最大长度为2。默认为CN。对应关系参考:阿根廷:AR,亚美尼亚:AM,澳大利亚:AU,奥地利:AT,阿塞拜疆:AZ,巴林群岛:BH,孟加拉国:BD,比利时:BE,伯利兹:BZ,玻利维亚:BO,巴西:BR,文莱:BN,保加利亚:BG,加拿大:CA,智利:CL,中国:CN,哥伦比亚:CO,哥斯达黎加:CR,克罗地亚:HR,塞浦路斯:CY,捷克:CZ,丹麦:DK,多米尼加共和国:DO,萨尔瓦多:SV,厄瓜多尔:EC,埃及:EG,爱沙尼亚:EE,芬兰:FI,法国:FR,格鲁吉亚:GE,德国:DE,希腊:GR,危地马拉:GT,洪都拉斯:HN,中国香港:HK,匈牙利:HU,冰岛:IS,印度:IN,印度尼西亚:ID,爱尔兰:IE,以色列:IL,意大利:IT,日本:JP,约旦:JO,哈萨克斯坦:KZ,肯尼亚:KE,韩国:KR,科威特:KW,拉脱维亚:LV,列支敦士登:LI,立陶宛:LT,卢森堡:LU,中国澳门:MO,马其顿:MK,马来西亚:MY,马耳他:MT,墨西哥:MX,摩纳哥:MC,摩洛哥:MA,荷兰:NL,新西兰:NZ,尼日利亚:NG,挪威:NO,阿曼:OM,巴基斯坦:PK,巴拿马:PA,秘鲁:PE,菲律宾:PH,波兰:PL,葡萄牙:PT,波多黎各:PR,卡塔尔:QA,罗马尼亚:RO,俄罗斯:RU,西班牙:ES,斯里兰卡:LK,沙特阿拉伯:SA,塞尔维亚:RS,新加坡:SG,斯洛伐克:SK,斯洛文尼亚:SI,南非:ZA,瑞典:SE,瑞士:CH,泰国:TH,特立尼达和多巴哥:TT,突尼斯:TN,土耳其:TR,乌克兰:UA,阿拉伯联合酋长国:AE,大不列颠联合王国:GB,美国:US,乌拉圭:UY,乌兹别克斯坦:UZ,委内瑞拉:VE,越南:VN,也门:YE,白俄罗斯:BY,台湾:TW |
"CN" |
autoEnable |
boolean |
|
false |
定时开启,可选值: true,false。默认值为false |
true |
timeTemplateId |
string |
0~36个字符。 |
- |
定时开启时的时间模板ID,仅autoEnable为true时,该字段可填值。时间模板ID可以通过第三方开放接口/controller/campus/v3/networkconfig/timetemplate得到 |
"b90f8190-e12f-4323-95f3-4018309209c4" |
calibrate |
string |
- |
manual |
调优模式,只能为manual(手动调优),auto(自动调优),schedule(定时调优)其中一种。默认值为manual。 |
"auto" |
dcaStartTime |
hh:mm:ss |
- |
- |
自动调优模式下有效。自动调优开始时间,时间格式hh:mm:ss。 |
"03:00:00" |
dcaInterval |
int32 |
[30-1440] |
- |
自动调优模式下有效。自动调优时间周期,取值范围为30到1440之间的整数,单位(min)。 |
1440 |
calibratePolicy |
string |
0~36个字符。 |
close |
自动调优模式下射频调优策略(calibrate为auto时生效),取值范围:close或者rogueAp(入侵模式),noise(底噪调优),nonWifi(非Wi-Fi)三个中选择一个或多个,英文逗号分隔。默认值为close。 |
"rogueAp,noise,nonWifi" |
dcaScheduleTime |
hh:mm:ss |
- |
- |
定时调优模式下有效。定时调优开始时间,时间格式hh:mm:ss。 |
"03:00:00" |
scanSwitch |
boolean |
|
- |
空口扫描是否开启,可选值: true(默认),false。当开启时,扫描时长,扫描间隔,扫描信道为必填项。 |
true |
scanSwitch5g |
boolean |
|
- |
空口扫描是否开启,可选值: true(默认),false。当开启时,扫描时长,扫描间隔,扫描信道为必填项。 |
true |
scanDuration |
string |
- |
- |
扫描时长,范围60~100,单位(ms)。 |
"60" |
scanInterval |
string |
- |
- |
扫描间隔,范围300~600000,单位(ms)。 |
"10000" |
scanChannel |
string |
- |
country-channel |
扫描信道,只能为country-channel(区域信道),dca-channel(调优信道),work-channel(作信道)其中一种。默认值为country-channel。 |
"country-channel" |
beaconCycle |
int32 |
[60-1000] |
100 |
beacon周期。取值范围为60到1000之间的整数。单位(TUs)。默认值为100。 |
100 |
dynamicSwitch |
boolean |
|
false |
负载均衡。默认值为false。 |
true |
deauthFailTimes |
int16 |
[0-5] |
0 |
deauth方式迁移次数。默认为0 |
0 |
referenceDataAnalysis |
boolean |
|
- |
基于历史数据进行射频调优,可选值: true(默认),false。 |
true |
selfCalibrate |
boolean |
|
- |
同一个站点下跨二层AP自调优,可选值: true,false(默认)。 |
false |
mode |
string |
|
- |
射频模式。取值范围为default(默认模式)、2RadioStandard(2射频标准)、2Radio2gEnhanced(2射频2G增强)、3Radio(3射频)、2RadioIndependentScan(2射频独立扫描)。 |
"default" |
spectrumAnalysis |
boolean |
|
false |
频谱分析,可选值: false(默认),true。 |
false |
rtsCtsMode |
string |
|
rts-cts |
RTS-CTS模式。取值范围为cts-to-self、rts-cts、disable,默认值为rts-cts。 |
"cts-to-self" |
rtsCtsThreshold |
int32 |
[64-2347] |
1400 |
RTS-CTS阈值(byte),默认值为1400。 |
1400 |
airTimeFairSchedule |
boolean |
|
true |
空口时间公平调度开关。默认值为true。 |
true |
powerAutoAdjust |
boolean |
|
- |
逐包功率控制开关。 |
true |
beamforming |
boolean |
|
- |
波束成形功能开关。 |
true |
smartRoam |
boolean |
|
- |
智能漫游开关。 |
false |
smartRoamThresholdSnr |
int32 |
[15-45] |
20 |
智能漫游信噪比阈值 |
20 |
beEdcaMode |
boolean |
|
- |
BE动态优化开关。 |
false |
beEdcaThreshold |
int32 |
[1-1000] |
- |
BE优化阈值,BE动态优化开关打开时使用。取值范围为1-1000,单位为(包/秒)。 |
6 |
mediaEdcaMode |
boolean |
|
- |
多媒体动态优化开关。 |
false |
mediaVoiceThreshold |
int32 |
[10-1000] |
- |
音频优化阈值,多媒体动态优化开关打开时使用。取值范围为10-1000,单位为(包/秒)。 |
30 |
mediaVideoThreshold |
int32 |
[10-1000] |
- |
视频优化阈值,多媒体动态优化开关打开时使用。取值范围为10-1000,单位为(包/秒)。 |
100 |
tcpWindowTuningSwitch |
boolean |
|
- |
TCP调窗功能开关,打开后当语音视频业务时延达到阈值,且大流量上行TCP背景业务发包时长达到阈值时,即可对TCP ACK中回复的RWND(Receiver Window,接收窗口值)进行动态调整,达到降低终端实际发送上行数据量以保障语音视频业务的用户体验。 |
true |
mediaVoiceDelay |
integer |
[1-4] |
- |
多媒体语音切片时延。取值范围为1:低,2:中,3:高,4:关。默认值为2。 |
2 |
mediaVideoDelay |
integer |
[1-4] |
- |
多媒体视频切片时延。取值范围为1:低,2:中,3:高,4:关。默认值为2。 |
2 |
mediaVoiceRatio |
integer |
[1-4] |
- |
多媒体语音切片占比。取值范围为1:低,2:中,3:高,4:关。默认值为2。 |
2 |
mediaVideoRatio |
integer |
[1-4] |
- |
多媒体视频切片占比。取值范围为1:低,2:中,3:高,4:关。默认值为2。 |
2 |
wmmScene |
string |
|
- |
WMM场景,BE动态优化开关和多媒体动态优化开关同时关闭时使用。取值范围为default(默认)、voice(音频)、voiceAndVideo(音频和视频)。 |
"default" |
wmmMode |
boolean |
|
true |
报文信道竞争开关,默认打开。 |
true |
edcaClient |
ARRAY_REFERENCE |
0-4个列表项,详细请参见表4。 |
2.4G和5G射频模板自定义信道竞争参数,当wmmMode为true时可为空,此时下发默认配置,结构体参见DeviceRadioEdcaDto。 |
- |
|
channelMonitor |
boolean |
|
false |
全信道扫描开关,可选值: false(默认),true。 |
false |
coSrEnable |
boolean |
|
- |
CO-SR 开关 |
true |
groupRadio2g |
REFERENCE |
详细请参见表5。 |
站点模板2G射频配置信息,结构体参见GroupRadio2gConfigDto。 |
- |
|
groupRadio5g |
REFERENCE |
详细请参见表6。 |
站点模板5G射频配置信息,结构体参见GroupRadio5gConfigDto。 |
- |
|
groupRadio6g |
REFERENCE |
详细请参见表7。 |
站点模板6G射频配置信息,结构体参见GroupRadio6gConfigDto。 |
- |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
ac |
string |
- |
- |
报文的4个接入类别。可取值为:acVo、acVi、acBe、acBk。WMM协议将数据报文分为4个接入类别,分别为AC_VO(Voice)、AC_VI(Video)、AC_BE(BestEffort)、AC_BK(Background)。当ac为acVo时,表示接入类别为语音流;当ac为acVi时,表示接入类别为视频流;当ac为acBe时,表示接入类别为尽力而为流;当ac为acBk时,表示接入类别为背景流。 |
"acVo" |
aifsn |
int32 |
[1-15] |
- |
指定仲裁帧间隙数,决定了用户的空闲等待时间长短。aifsn数值越大,用户的空闲等待时间越长,优先级越低。范围为1~15。 |
3 |
ecwMin |
int32 |
[0-15] |
- |
指定最小竞争窗口指数,此参数与ecwMax一起决定了用户的平均退避时间。这两个数值越大,用户的平均退避时间越长,优先级越低。取值范围:0~15,且须小于或等于ecwMax。 |
4 |
ecwMax |
int32 |
[0-15] |
- |
指定最大竞争窗口指数,此参数与ecwMin一起决定了用户的平均退避时间。这两个数值越大,用户的平均退避时间越长,优先级越低。取值范围:0~15,且须大于或等于ecwMin。 |
6 |
txoplimit |
int32 |
[0-255] |
- |
用户一次竞争信道成功后,可占用信道的最大时间,这个数值越大,用户一次能占用的信道时长越大。如果是0,则每次占用信道后,只能发送一个报文。取值范围:0~255。 |
0 |
ackPolicy |
string |
- |
- |
ACK策略类型,对于发送端发送的每个单播报文,接收端在成功接收到报文后,都需要发送ACK帧进行确认。只可在normal和noAck中选择。normal表示正常发送ACK帧,noAck表示不发送ACK帧。 |
"normal" |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
dca2gChannelSet |
string |
- |
1,6,11 |
2.4G调优信道集。可选"1,6,11"和"1,5,9,13"两种信道集。默认值为'1,6,11'。 |
"1,6,11" |
radio2gBaseRate |
string |
- |
1,2 |
2.4基础速率。支持的速率有1,2,5.5,6,9,11,12,18,24,36,48,54。单位(Mbps)(radio2gType填dot11b时,取值范围为1,2,5.5,11)。至少选择一项。默认值为'1,2'。 |
"1,2" |
radio2gSupportRate |
string |
- |
1,2,5.5,6,9,11,12,18,24,36,48,54 |
2.4G支持速率。支持的速率有1,2,5.5,6,9,11,12,18,24,36,48,54。单位(Mbps)(radio2gType填dot11b时,取值范围为1,2,5.5,11)。至少选择一项。默认值为'1,2,5.5,6,9,11,12,18,24,36,48,54'。 |
"1,2,5.5,6,9,11,12,18,24,36,48,54" |
radio2gMulticastRate |
string |
- |
- |
2.4G射频模板无线组播速率,缺省值为0(自适应),取值范围为1,2,5.5,6,9,11,12,18,24,36,48,54。单位Mbps。 |
"5.5" |
radio2gType |
string |
- |
dot11ax |
2.4G射频类型选择,可填dot11b(802.11b模式)、dot11g(802.11g模式,可向前兼容)、dot11n(802.11n模式,可向前兼容)、dot11ax(默认,802.11ax模式,可向前兼容)、dot11be(802.11be模式,可向前兼容)。当2G射频模板视图配置dot11b时,引用了此2G射频模板的AP 2GHz射频上生效的管理帧发送速率和无线报文组播发送速率均固定为1Mbps且再进行组播速率(multicast-rate)和管理帧发送速率(beacon-2g-rate)配置不生效。 |
"dot11ax" |
tpc2gMaxTxPwr |
int32 |
[1-127] |
127 |
2.4G的TPC上限。取值范围为1到127之间的整数。单位(dBm)。默认值为127。2.4G的TPC上限需大于下限。 |
127 |
tpc2gMinTxPwr |
int32 |
[1-127] |
9 |
2.4G的TPC下限。取值范围为1到127之间的整数。单位(dBm),默认值为9。 |
9 |
tpc2gCoverageThreshold |
int32 |
[-85--35] |
-60 |
2.4G的TPC阈值。取值范围为-85到-35之间的整数。 |
-60 |
uca2gClientEnable |
boolean |
|
- |
2.4G射频接入用户数限制开关。 |
false |
access2gThrehold |
int32 |
[1-512] |
- |
2.4G射频接入用户数阈值,接入用户数限制开关打开时使用。取值范围为1-512。 |
64 |
reachthresHold2G |
int32 |
[1-3] |
- |
2.4G射频接入阈值策略,接入用户数限制开关打开时使用。取值范围为1(新用户禁止接入)、2(新用户禁止接入且隐藏SSID)、3(VIP用户优先接入)。 |
1 |
radio2Dot4GuardIntervalMode |
string |
- |
- |
2.4G射频间隔(GI)模式,可填default(默认)、short(短间隔)或normal(普通间隔)。普通间隔的时间为800ns,在802.11n和802.11ac标准中允许使用短间隔,为400ns,可以提高802.11n和802.11ac的传输率。 |
"short" |
radio11ax2Dot4GuardIntervalMode |
string |
- |
dot8 |
2.4G射频802.11ax的间隔(GI)模式,可填dot8(代表800ns)、1dot6(代表1600ns)或3dot2(代表3200ns)。间隔时间越小,传输效率越高,间隔时间越大,抗干扰能力越强。室内环境干扰因素小,建议使用小的GI,室外环境干扰因素大,建议使用大的GI,默认值为dot8。 |
"dot8" |
enableFlag2g |
boolean |
|
- |
2.4G射频弱信号终端强制下线开关。 |
false |
smartRoamScene2g |
string |
|
- |
2.4G射频弱信号终端强制下线场景,弱信号终端强制下线开关打开时使用。取值范围为general(普通)、highDensity(高密)、userDefined(自定义)。 |
"general" |
snr2g |
int32 |
[5-45] |
- |
信噪比阈值,单位(dB),弱信号终端强制下线开关打开且场景为userDefined(自定义)时使用。取值范围为5-45。 |
5 |
checkInterval2g |
int32 |
[300-3000] |
- |
检测周期,单位(ms),弱信号终端强制下线开关打开且场景为userDefined(自定义)时使用。取值范围为300-3000。 |
300 |
utmostPower2g |
int32 |
[0-2] |
- |
2.4G射频极限功率开关。取值范围为(0) 开启、1(默认)、2(关闭)。 |
1 |
vipUser2dot4ModeUserDefine |
int32 |
[0-100] |
- |
2.4G射频VIP用户带宽预留比例。取值范围为0-100。 |
20 |
flexibleRadio |
int32 |
[0-2] |
- |
2.4G射频双频动态调整开关。取值范围为0(关闭)、1(自动切换成5G)、2(自动关闭2.4G)。 |
0 |
fastpassusers2gEnable |
boolean |
|
- |
是否开启2G VIP超帧 |
true |
fastpassusers2gNum |
int32 |
[0-10] |
- |
2G VIP超帧 保障用户数 |
5 |
fastpassusers2gPeriod |
string |
4~5个字符。满足正则表达^(20|40|60|80|100)ms$。 |
- |
2G VIP超帧 调度周期 (已废弃) |
"20ms" |
fastpassusers2gRatio |
int32 |
[5-75] |
- |
VIP超帧 调度周期超帧保障占比 (已废弃) |
25 |
startThreshold2g |
int32 |
[0-100] |
- |
双频间负载均衡负载起始阈值(终端数) |
100 |
gapThreshold2g |
int32 |
[0-100] |
- |
双频间负载均衡负载差值阈值(%) |
90 |
snrThreshold2g |
int32 |
[10-35] |
- |
双频间负载均衡SNR阈值(dB) |
20 |
denyThreshold2g |
int32 |
[0-10] |
- |
拒绝终端关联最大次数 |
0 |
clientBandExpire2g |
int64 |
[10-65535] |
- |
终端支持频段信息老化probe次数 |
35 |
vipUser2gPhyProtection |
string |
满足正则表达^(security-priority|business-priority|disable)$。 |
disable |
密盾功能。可选:security-priority 安全优先,对于不支持MU-MIMO功能的终端会拒绝接入;business-priority 业务优先只保障支持MU-MIMO功能的终端的业务安全性;disable:不使能。 |
"security-priority" |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
dcaBandwidth |
string |
- |
20mhz |
5G调优频宽,只能为20mhz,40mhz,80mhz其中一种。默认值为20mhz。 |
"20mhz" |
dca5gChannelSet |
string |
- |
44,56,36,48,161,153,165,157,149,60,40,52,64 |
5G调优信道集。当5G调优频宽为20MHz时,支持的信道有36,40,44,48,52,56,60,64,149,153,157,161,165; 当5G调优信道为40MHz或80MHz时,支持的信道有36,40,44,48,52,56,60,64,149,153,157,161。 为了确保校准结果,请选择至少三个选项。若可选信道少于三个,则此国家不支持配置此调优频宽。默认值为'44,56,36,48,161,153,165,157,149,60,40,52,64'。 |
"44,56,36,48,161,153,165,157,149,60,40,52,64" |
radio5gBaseRate |
string |
- |
6,12,24 |
5G基础速率。支持的速率有6,9,12,18,24,36,48,54。单位(Mbps)。至少选择一项。默认值为'6,12,24'。 |
"6,12,24" |
radio5gSupportRate |
string |
- |
6,9,12,18,24,36,48,54 |
5G支持速率。支持的速率有6,9,12,18,24,36,48,54。单位(Mbps)。至少选择一项。默认值为'6,9,12,18,24,36,48,54'。 |
"6,9,12,18,24,36,48,54" |
radio5gMulticastRate |
string |
- |
- |
5G射频模板无线组播速率,缺省值为0(自适应),取值范围:6,9,12,18,24,36,48,54。单位:Mbps。 |
"6" |
radio5gType |
string |
- |
dot11ax |
5G射频类型选择,可填dot11a(802.11a模式)、dot11n(802.11n模式,可向前兼容)、dot11ac(802.11ac模式,可向前兼容)、dot11ax(默认,802.11ax模式,可向前兼容)、dot11be(802.11be模式,可向前兼容)。射频类型配置为dot11a时,禁止非HT终端接入功能失效;射频类型配置超出AP支持的能力范围时,则按照AP实际支持的能力生效;对于使能了WDS或Mesh功能的射频,如果射频类型配置为不支持802.11n/ac,则会降低空口回传性能。 |
"dot11ax" |
radio5gVhtAMsduEnable |
boolean |
|
false |
A-MSDU聚合开关,默认为关闭。 |
false |
radio5gMaxFrameNum |
int32 |
[2-15] |
2 |
最大聚合子帧数,取值范围:2~15,默认值为2。 |
2 |
tpc5gMaxTxPwr |
int32 |
[1-127] |
127 |
5G的TPC上限。取值范围为1到127之间的整数。单位(dBm)。默认值为127。5G的TPC上限需大于下限。 |
127 |
tpc5gMinTxPwr |
int32 |
[1-127] |
9 |
5G的TPC下限。取值范围为1到127之间的整数。单位(dBm)。默认值为9。 |
9 |
tpc5gCoverageThreshold |
int32 |
[-85--35] |
-60 |
5G的TPC阈值。取值范围为-85到-35之间的整数。默认值为-60。 |
-60 |
radio5GuardIntervalMode |
string |
- |
- |
5G射频间隔(GI)模式,可填default(默认)、short(短间隔)或normal(普通间隔)。普通间隔的时间为800ns,在802.11n和802.11ac标准中允许使用短间隔,为400ns,可以提高802.11n和802.11ac的传输率。 |
"short" |
radio11ax5GuardIntervalMode |
string |
- |
dot8 |
5G射频802.11ax的间隔(GI)模式,可填dot8(代表800ns)、1dot6(代表1600ns)或3dot2(代表3200ns)。间隔时间越小,传输效率越高,间隔时间越大,抗干扰能力越强。室内环境干扰因素小,建议使用小的GI,室外环境干扰因素大,建议使用大的GI,默认值为dot8。 |
"1dot6" |
antennaMode |
string |
- |
omnidirection |
天线模式,可填omnidirection(全向天线)或direction(定向天线)。 |
"omnidirection" |
uca5gClientEnable |
boolean |
|
- |
5G射频接入用户数限制开关。 |
false |
access5gThrehold |
int32 |
[1-512] |
- |
5G射频接入用户数阈值,接入用户数限制开关打开时使用。取值范围为1-512。 |
64 |
reachthresHold5G |
int32 |
[1-3] |
- |
5G射频接入阈值策略,接入用户数限制开关打开时使用。取值范围为1(新用户禁止接入)、2(新用户禁止接入且隐藏SSID)、3(VIP用户优先接入)。 |
1 |
enableFlag5g |
boolean |
|
- |
5G射频弱信号终端强制下线开关。 |
false |
smartRoamScene5g |
string |
- |
- |
5G射频弱信号终端强制下线场景,弱信号终端强制下线开关打开时使用。取值范围为general(普通)、highDensity(高密)、userDefined(自定义)。 |
"general" |
snr5g |
int32 |
[5-45] |
- |
信噪比阈值,单位(dB),弱信号终端强制下线开关打开且场景为userDefined(自定义)时使用。取值范围为5-45。 |
5 |
checkInterval5g |
int32 |
[300-3000] |
- |
检测周期,单位(ms),弱信号终端强制下线开关打开且场景为userDefined(自定义)时使用。取值范围为300-3000。 |
300 |
utmostPower5g |
int32 |
[0-2] |
- |
5G射频极限功率开关。取值范围为(0) 开启、1(默认)、2(关闭)。 |
1 |
vipUser5ModeUserDefine |
int32 |
[0-100] |
- |
5G射频VIP用户带宽预留比例。取值范围为0-100。 |
20 |
radio5gSliceEnable |
boolean |
|
- |
使能5G空口切片 |
false |
radio5gSliceRtt |
int32 |
[10-1000] |
- |
5g空口切片时延,默认20ms |
20 |
radio5gSliceRatio |
int32 |
[0-80] |
- |
5g空口切片时间占比,默认80% |
60 |
radio5gSliceFrerEnhance |
boolean |
|
- |
双发选收增强开关 |
false |
fastpassusers5gEnable |
boolean |
|
- |
是否开启 VIP超帧 |
true |
fastpassusers5gNum |
int32 |
[0-10] |
- |
VIP超帧 保障用户数 |
5 |
fastpassusers5gPeriod |
string |
4~5个字符。满足正则表达^(20|40|60|80|100)ms$。 |
- |
VIP超帧 调度周期 (已废弃) |
"20ms" |
fastpassusers5gRatio |
int32 |
[5-75] |
- |
VIP超帧 调度周期超帧保障占比 (已废弃) |
25 |
vipUser5gPhyProtection |
string |
满足正则表达^(security-priority|business-priority|disable)$。 |
disable |
密盾功能。可选:security-priority 安全优先,对于不支持MU-MIMO功能的终端会拒绝接入;business-priority 业务优先只保障支持MU-MIMO功能的终端的业务安全性;disable:不使能。 |
"security-priority" |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
dca6gChannelSet |
string |
0~500个字符。 |
- |
6G调优信道集。当5G调优频宽为20MHz时,支持的信道有1,5,9,13,17...233; 当6G调优信道为40MHz时,相邻2信道捆绑成一个信道,支持的信道有1,9,17,25...225或者5,13,21,29...229; 当6G调优信道为80MHz时,相邻4信道捆绑成一个信道,支持的信道有1,17,33,49...209; 当6G调优信道为160MHz时,相邻8信道捆绑成一个信道,支持的信道有1,33,65,97,129,161,193; 当6G调优信道为320MHz时,相邻16信道捆绑成一个信道,支持的信道有1,65,129; 为了确保校准结果,请选择至少三个选项。若可选信道少于三个,则此国家不支持配置此调优频宽。 |
"44,56,36,48,161,153,165,157,149,60,40,52,64" |
dca6gBandwidth |
string |
|
- |
6G调优频宽,只能为20mhz,40mhz,80mhz,160mhz其中一种。 |
"20mhz" |
scanSwitch6g |
boolean |
|
- |
空口扫描是否开启,可选值: true(默认),false。当开启时,扫描时长,扫描间隔,扫描信道为必填项 |
true |
radio11ax6GuardIntervalMode |
string |
0~10个字符。 |
dot8 |
6G射频802.11ax的间隔(GI)模式,可填dot8(代表800ns)、1dot6(代表1600ns)或3dot2(代表3200ns)。间隔时间越小,传输效率越高,间隔时间越大,抗干扰能力越强。室内环境干扰因素小,建议使用小的GI,室外环境干扰因素大,建议使用大的GI,默认值为dot8。 |
"1dot6" |
tpc6gMinTxPwr |
int32 |
[1-127] |
- |
6G TPC下限。 |
9 |
tpc6gMaxTxPwr |
int32 |
[1-127] |
- |
6G TPC上限,需大于6G TPC下限。 |
127 |
tpc6gCoverageThreshold |
int32 |
[-85--35] |
- |
6G TPC阈值。 |
-60 |
uacClientEnableFlag6g |
boolean |
|
- |
6G接入用户阈值使能,可选值: true,false |
false |
uacAccess6gThrehold |
int32 |
[1-512] |
- |
6G接入用户阈值 |
64 |
uacReachthresHold6G |
int32 |
[1-3] |
- |
6G用户优先保障策略 范围:1:新用户禁止接入 2:用户禁止进入且隐藏 3:VIP用户优先接入 |
1 |
radio6gVhtAMsduEnable |
boolean |
|
false |
6G射频模板A-MSDU聚合开关,默认为关闭。 |
false |
radio6gMaxFrameNum |
int32 |
[2-15] |
2 |
6G射频模板最大聚合子帧数,取值范围2~15,默认值为2。 |
2 |
radio6gMulticastRate |
string |
0~3个字符。 |
- |
6G射频模板无线组播速率,缺省值为0(自适应),取值范围:6,9,12,18,24,36,48,54。单位Mbps。 |
"6" |
smartRoamScene6g |
string |
|
- |
6G弱信号终端强制下线场景,uacClientEnableFlag6g为true时生效,取值范围:general, highDensity, userDefined。 |
"general" |
smartRoamSnr6g |
int32 |
[5-45] |
- |
6G信噪比阈值(dB),smartRoamScene6g为userDefined时生效。 |
5 |
smartRoamCheckInterval6g |
int32 |
[300-3000] |
- |
6G检测周期(ms),smartRoamScene6g为userDefined时生效。 |
300 |
utmostPower6g |
int32 |
[0-2] |
- |
6G极限功率,0 开启,1 默认,2 关闭 |
1 |
vipUser6gModeUserDefine |
int32 |
[0-100] |
- |
6gVIP用户带宽预留比例(%) |
20 |
enableFlag6g |
boolean |
|
- |
6G弱信号终端强制下线。 |
false |
fastpassusers6gEnable |
boolean |
|
- |
是否开启 VIP超帧 |
true |
fastpassusers6gNum |
int32 |
[0-10] |
- |
VIP超帧 保障用户数 |
5 |
fastpassusers6gPeriod |
string |
4~5个字符。满足正则表达^(20|40|60|80|100)ms$。 |
- |
VIP超帧 调度周期 (已废弃) |
"20ms" |
fastpassusers6gRatio |
int32 |
[5-75] |
- |
VIP超帧 调度周期超帧保障占比 (已废弃) |
25 |
vipUser6gPhyProtection |
string |
满足正则表达^(security-priority|business-priority|disable)$。 |
disable |
密盾功能。可选:security-priority 安全优先,对于不支持MU-MIMO功能的终端会拒绝接入;business-priority 业务优先只保障支持MU-MIMO功能的终端的业务安全性;disable:不使能。 |
"security-priority" |
返回状态码为400:校验异常。
详细信息请参见实际响应消息体。
返回状态码为500:内部服务错误。
详细信息请参见实际响应消息体。
响应示例
返回状态码为200:查询AP站点模板射频配置结果,返回结构体参见。
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" : { "countryCode" : "CN", "autoEnable" : true, "timeTemplateId" : "b90f8190-e12f-4323-95f3-4018309209c4", "calibrate" : "auto", "dcaStartTime" : "03:00:00", "dcaInterval" : 1440, "calibratePolicy" : "rogueAp,noise,nonWifi", "dcaScheduleTime" : "03:00:00", "scanSwitch" : true, "scanSwitch5g" : true, "scanDuration" : "60", "scanInterval" : "10000", "scanChannel" : "country-channel", "beaconCycle" : 100, "dynamicSwitch" : true, "deauthFailTimes" : 0, "referenceDataAnalysis" : true, "selfCalibrate" : false, "mode" : "default", "spectrumAnalysis" : false, "rtsCtsMode" : "cts-to-self", "rtsCtsThreshold" : 1400, "airTimeFairSchedule" : true, "powerAutoAdjust" : true, "beamforming" : true, "smartRoam" : false, "smartRoamThresholdSnr" : 20, "beEdcaMode" : false, "beEdcaThreshold" : 6, "mediaEdcaMode" : false, "mediaVoiceThreshold" : 30, "mediaVideoThreshold" : 100, "tcpWindowTuningSwitch" : true, "mediaVoiceDelay" : 2, "mediaVideoDelay" : 2, "mediaVoiceRatio" : 2, "mediaVideoRatio" : 2, "wmmScene" : "default", "wmmMode" : true, "edcaClient" : [ { "ac" : "acVo", "aifsn" : 3, "ecwMin" : 4, "ecwMax" : 6, "txoplimit" : 0, "ackPolicy" : "normal" } ], "channelMonitor" : false, "coSrEnable" : true, "groupRadio2g" : { "dca2gChannelSet" : "1,6,11", "radio2gBaseRate" : "1,2", "radio2gSupportRate" : "1,2,5.5,6,9,11,12,18,24,36,48,54", "radio2gMulticastRate" : "5.5", "radio2gType" : "dot11ax", "tpc2gMaxTxPwr" : 127, "tpc2gMinTxPwr" : 9, "tpc2gCoverageThreshold" : -60, "uca2gClientEnable" : false, "access2gThrehold" : 64, "reachthresHold2G" : 1, "radio2Dot4GuardIntervalMode" : "short", "radio11ax2Dot4GuardIntervalMode" : "dot8", "enableFlag2g" : false, "smartRoamScene2g" : "general", "snr2g" : 5, "checkInterval2g" : 300, "utmostPower2g" : 1, "vipUser2dot4ModeUserDefine" : 20, "flexibleRadio" : 0, "fastpassusers2gEnable" : true, "fastpassusers2gNum" : 5, "fastpassusers2gPeriod" : "20ms", "fastpassusers2gRatio" : 25, "startThreshold2g" : 100, "gapThreshold2g" : 90, "snrThreshold2g" : 20, "denyThreshold2g" : 0, "clientBandExpire2g" : 35, "vipUser2gPhyProtection" : "security-priority" }, "groupRadio5g" : { "dcaBandwidth" : "20mhz", "dca5gChannelSet" : "44,56,36,48,161,153,165,157,149,60,40,52,64", "radio5gBaseRate" : "6,12,24", "radio5gSupportRate" : "6,9,12,18,24,36,48,54", "radio5gMulticastRate" : "6", "radio5gType" : "dot11ax", "radio5gVhtAMsduEnable" : false, "radio5gMaxFrameNum" : 2, "tpc5gMaxTxPwr" : 127, "tpc5gMinTxPwr" : 9, "tpc5gCoverageThreshold" : -60, "radio5GuardIntervalMode" : "short", "radio11ax5GuardIntervalMode" : "1dot6", "antennaMode" : "omnidirection", "uca5gClientEnable" : false, "access5gThrehold" : 64, "reachthresHold5G" : 1, "enableFlag5g" : false, "smartRoamScene5g" : "general", "snr5g" : 5, "checkInterval5g" : 300, "utmostPower5g" : 1, "vipUser5ModeUserDefine" : 20, "radio5gSliceEnable" : false, "radio5gSliceRtt" : 20, "radio5gSliceRatio" : 60, "radio5gSliceFrerEnhance" : false, "fastpassusers5gEnable" : true, "fastpassusers5gNum" : 5, "fastpassusers5gPeriod" : "20ms", "fastpassusers5gRatio" : 25, "vipUser5gPhyProtection" : "security-priority" }, "groupRadio6g" : { "dca6gChannelSet" : "44,56,36,48,161,153,165,157,149,60,40,52,64", "dca6gBandwidth" : "20mhz", "scanSwitch6g" : true, "radio11ax6GuardIntervalMode" : "1dot6", "tpc6gMinTxPwr" : 9, "tpc6gMaxTxPwr" : 127, "tpc6gCoverageThreshold" : -60, "uacClientEnableFlag6g" : false, "uacAccess6gThrehold" : 64, "uacReachthresHold6G" : 1, "radio6gVhtAMsduEnable" : false, "radio6gMaxFrameNum" : 2, "radio6gMulticastRate" : "6", "smartRoamScene6g" : "general", "smartRoamSnr6g" : 5, "smartRoamCheckInterval6g" : 300, "utmostPower6g" : 1, "vipUser6gModeUserDefine" : 20, "enableFlag6g" : false, "fastpassusers6gEnable" : true, "fastpassusers6gNum" : 5, "fastpassusers6gPeriod" : "20ms", "fastpassusers6gRatio" : 25, "vipUser6gPhyProtection" : "security-priority" } } }
返回状态码为400:校验异常。
HTTP/1.1 400 Bad Request 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
返回状态码为500:内部服务错误。
HTTP/1.1 500 Internal Server Error 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