本文导读

典型场景
接口功能
接口约束
调用方法
URI
请求参数
请求示例
响应参数
响应示例

展开导读

文档首页/ 华为乾坤/ 云管理网络/ API参考/ 接口参考/ Lan网络/ 站点/ AP/ AP站点射频配置/ 修改AP站点射频配置信息

修改AP站点射频配置信息

更新时间：2025-02-17 GMT+08:00

查看PDF

典型场景

提供修改AP射频配置信息接口。

接口功能

修改AP站点射频配置信息。

接口约束

该接口支持租户视图或msp代维视图下，用户角色为“Open Api Operator”的用户访问，必须在用户会话建立后使用。

调用方法

PUT

URI

/controller/campus/v3/networkconfig/site/{siteId}/apradio

表1 path参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
siteId	是	UUID	-	-	站点ID，UUID格式。	"fbde1c5d-5b94-49e3-a912-48641015e45c"

请求参数

表2 body参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
groupRadioConfigApiDto	是	REFERENCE	详细请参见表3。		修改AP站点射频配置入参，结构体参见GroupRadioConfigApiDto。	-

表3 GroupRadioConfigApiDto对象的参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
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"
scanSwitch	否	boolean	true false	true	空口扫描是否开启，可选值: true(默认)，false。当开启时，扫描时长，扫描间隔，扫描信道为必填项。	true
scanSwitch5g	否	boolean	true false	-	空口扫描是否开启，可选值: 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"
dca2gChannelSet	否	string	-	1,6,11	2.4G调优信道集。可选"1，6，11"和"1，5，9，13"两种信道集。默认值为'1,6,11'。	"1,6,11"
dcaBandwidth	否	string	-	20mhz	5G调优频宽，只能为20mhz，40mhz，80mhz其中一种。默认值为20mhz。	"20mhz"
dca5gChannelSet	否	string	-	-	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"
calibrate	否	string	-	manual	调优模式，只能为manual（手动调优），auto（自动调优），schedule（定时调优）其中一种。默认值为manual。	"auto"
dcaStartTime	否	hh:mm:ss	-	-	自动调优模式下开始时间。	"03:00:00"
dcaInterval	否	int32	[30-1440]	-	自动调优模式下周期，单位（min）。	1440
dcaScheduleTime	否	hh:mm:ss	-	-	定时调优模式下调优时间。	"03:00:00"
tpcMaxTxPwr	否	int32	[1-127]	127	2.4G TPC上限。默认值为127。	127
tpcMinTxPwr	否	int32	[1-127]	9	2.4G TPC下限。默认值为9。	9
tpcCoverageThreshold	否	int32	[-85--35]	-60	2.4G TPC阈值。默认值为-60。	-60
radio2Dot4GuardIntervalMode	否	string	-	-	2.4G射频间隔(GI)模式，可填default(默认)、short(短间隔)或normal(普通间隔)。普通间隔的时间为800ns，在802.11n和802.11ac标准中允许使用短间隔，为400ns，可以提高802.11n和802.11ac的传输率。	"short"
radio5GuardIntervalMode	否	string	-	-	5G射频间隔(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"
radio11ax5GuardIntervalMode	否	string	-	dot8	5G射频802.11ax的间隔(GI)模式，可填dot8（代表800ns）、1dot6（代表1600ns）或3dot2（代表3200ns）。间隔时间越小，传输效率越高，间隔时间越大，抗干扰能力越强。室内环境干扰因素小，建议使用小的GI，室外环境干扰因素大，建议使用大的GI，默认值为dot8。	"1dot6"
referenceDataAnalysis	否	boolean	true false	-	基于历史数据进行射频调优，可选值: true(默认)，false。	true
selfCalibrate	否	boolean	true false	-	同一个站点下跨二层AP自调优，可选值: true，false(默认)。	false
radio2gMulticastRate	否	string	-	-	2.4G射频模板无线组播速率，缺省值为0（自适应），取值范围：1，2，5.5，6，9，11，12，18，24，36，48，54。单位Mbps	"5.5"
radio5gMulticastRate	否	string	-	-	5G射频模板无线组播速率，缺省值为0（自适应），取值范围：6，9，12，18，24，36，48，54。单位Mbps。	"6"
radio5gVhtAMsduEnable	否	boolean	true false	false	5G射频模板A-MSDU聚合开关，默认为关闭。	false
radio5gMaxFrameNum	否	int32	[2-15]	2	5G射频模板最大聚合子帧数，取值范围2~15，默认值为2。	2
wmmMode	否	boolean	true false	true	报文信道竞争开关，默认打开。	true
edcaClient	否	ARRAY_REFERENCE	0-4个列表项，详细请参见表4。		2.4G和5G射频模板的信道竞争参数，在wmmMode为true时，可选填该数组。若不填则不更改此配置，结构体参见DeviceRadioEdcaDto。	-
spectrumAnalysis	否	boolean	true false	false	频谱分析开关，可选值: false(默认)，true。	false
channelMonitor	否	boolean	true false	false	全信道扫描开关，可选值: false(默认)，true。	false
antennaMode	否	string	-	omnidirection	天线模式，可填omnidirection（全向天线）或direction（定向天线）。默认值为omnidirection。	"omnidirection"
beaconCycle	否	int32	[60-1000]	-	beacon周期(ms)	60
rtsCtsMode	否	string	cts-to-self rts-cts disable	rts-cts	RTS-CTS模式，默认值为rts-cts。	"cts-to-self"
rtsCtsThreshold	否	int32	[64-2347]	1400	RTS-CTS阈值(byte)，默认值为1400。	1400
autoEnable	否	boolean	true false	false	定时开启，可选值: true，false。默认值为false	true
timeTemplateId	否	string	32~36个字符。	-	定时开启的时间模板id，仅autoEnable为true时可传值。	"94386ba0-9976-4f92-b699-f3ca00de56e5"
airTimeFairSchedule	否	boolean	true false	true	空口时间公平调度，可选值: true，false。默认值为true	true
powerAutoAdjust	否	boolean	true false	-	逐包功控，可选值: true，false。	true
beamforming	否	boolean	true false	-	波束成形，可选值: true，false。	true
dynamicSwitch	否	boolean	true false	-	负载均衡，可选值: true，false。	false
deauthFailTimes	否	int16	[0-5]	0	deauth方式迁移次数。默认值为0。	0
smartRoam	否	boolean	true false	-	智能漫游，可选值: true，false。	false
smartRoamThresholdSnr	否	int32	[15-45]	20	智能漫游信噪比阈值	20
uca2gClientEnable	否	boolean	true false	-	2.4G接入用户阈值使能，可选值: true，false。	false
access2gThrehold	否	int32	[1-512]	-	2.4G接入用户阈值	64
reachthresHold2G	否	int32	[1-3]	-	2.4G用户优先保障策略范围：1：新用户禁止接入 2：用户禁止进入且隐藏 3：VIP用户优先接入	1
uca5gClientEnable	否	boolean	true false	-	5G接入用户阈值使能，可选值: true，false。	false
access5gThrehold	否	int32	[1-512]	-	5G接入用户阈值	64
reachthresHold5G	否	int32	[1-3]	-	5G用户优先保障策略范围：1：新用户禁止接入 2：用户禁止进入且隐藏 3：VIP用户优先接入	1
calibratePolicy	否	string	0~64个字符。	close	自动调优模式下射频调优策略(calibrate为auto时生效)，取值范围：close或者rogueAp（入侵模式）,noise（底噪调优）,nonWifi（非Wi-Fi）三个中选择一个或多个，英文逗号分隔。默认值为close。	"rogueAp,noise"
radio2gBaseRate	否	string	0~64个字符。	-	2.4G基础速率，取值范围：1, 2, 5.5, 6, 9, 11, 12, 18, 24, 36, 48, 54中选择一个或多个(radio2gType填dot11b时，取值范围为1,2,5.5,11)，英文逗号分隔，单位Mbps。	"6,9,11"
radio2gSupportRate	否	string	0~64个字符。	-	2.4G支持速率，取值范围：1, 2, 5.5, 6, 9, 11, 12, 18, 24, 36, 48, 54中选择一个或多个(radio2gType填dot11b时，取值范围为1,2,5.5,11)，英文逗号分隔，单位Mbps。	"6,9,11"
radio5gBaseRate	否	string	0~64个字符。	-	5G基础速率，取值范围：6, 9, 12, 18, 24, 36, 48, 54中选择一个或多个，英文逗号分隔，单位Mbps。	"6,9,12"
radio5gSupportRate	否	string	0~64个字符。	-	5G支持速率，取值范围：6, 9, 12, 18, 24, 36, 48, 54中选择一个或多个，英文逗号分隔，单位Mbps。	"6,9,12"
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"
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"
tpc5gMinTxPwr	否	int32	[1-127]	-	5G TPC下限。	9
tpc5gMaxTxPwr	否	int32	[1-127]	-	5G TPC上限，需不小于5G TPC下限。	127
tpc5gCoverageThreshold	否	int32	[-85--35]	-	5G TPC阈值。	-60
enableFlag2g	否	boolean	true false	-	2.4G弱信号终端强制下线。	false
enableFlag5g	否	boolean	true false	-	5G弱信号终端强制下线。	false
smartRoamScene2g	否	string	general highDensity userDefined	-	2.4G弱信号终端强制下线场景，enableFlag2g为true时生效，取值范围：general, highDensity, userDefined。	"general"
smartRoamScene5g	否	string	general highDensity userDefined	-	5G弱信号终端强制下线场景，enableFlag2g为true时生效，取值范围：general, highDensity, userDefined。	"general"
snr2g	否	int32	[5-45]	-	2.4G信噪比阈值(dB)，smartRoamScene2g为userDefined时生效。	5
checkInterval2g	否	int32	[300-3000]	-	2.4G检测周期(ms)，smartRoamScene2g为userDefined时生效。	300
snr5g	否	int32	[5-45]	-	5G信噪比阈值(dB)，smartRoamScene5g为userDefined时生效。	5
checkInterval5g	否	int32	[300-3000]	-	5G检测周期(ms)，smartRoamScene5g为userDefined时生效。	300
beEdcaMode	否	boolean	true false	-	BE动态优化。	true
beEdcaThreshold	否	int32	[1-1000]	-	BE优化阈值(包/秒)，beEdcaMode为true时生效。	30
mediaEdcaMode	否	boolean	true false	-	多媒体动态优化。	true
mediaVoiceThreshold	否	int32	[10-1000]	-	音频优化阈值(包/秒)，mediaEdcaMode为true时生效。	30
mediaVideoThreshold	否	int32	[10-1000]	-	视频优化阈值(包/秒)，mediaEdcaMode为true时生效。	30
tcpWindowTuningSwitch	否	boolean	true false	-	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	default voice voiceAndVideo	-	WMM场景，beEdcaMode，mediaEdcaMode同时为false时生效，取值范围：default, voice, voiceAndVideo。	"default"
flexibleRadio	否	int32	[0-2]	-	双频动态调整，0为关闭，1为冗余2.4G射频调整方式自动切换成5G，2为冗余2.4G射频调整方式自动关闭2.4G。	2
utmostPower2g	否	int32	[0-2]	-	2.4G极限功率，0 开启，1 默认，2 关闭	2
utmostPower5g	否	int32	[0-2]	-	5G极限功率，0 开启，1 默认，2 关闭	1
vipUser2dot4ModeUserDefine	否	int32	[0-100]	-	2.4GVIP用户带宽预留比例(%)	20
vipUser5ModeUserDefine	否	int32	[0-100]	-	5G VIP用户带宽预留比例(%)	20
mode	否	string	default 2RadioStandard 2Radio2gEnhanced 3Radio 2RadioIndependentScan	-	射频模式，取值范围：default（默认）, 2RadioStandard（2射频标注）, 2Radio2gEnhanced（2射频增强）, 3Radio（3射频）, 2RadioIndependentScan（2射频独立扫描）。	"default"
radio5gSliceEnable	否	boolean	true false	-	使能5G空口切片	false
radio5gSliceRtt	否	int32	[10-1000]	-	5g空口切片时延，默认20ms	20
radio5gSliceFrerEnhance	否	boolean	true false	-	双发选收增强开关	false
coSrEnable	否	boolean	true false	-	CO-SR 开关	true
radio5gSliceRatio	否	int32	[0-80]	-	5g空口切片时间占比，默认80%	80
6gRadioConfig	否	REFERENCE	详细请参见表5。		6g射频信息，结构体参见6gRadioConfig。	-
fastpassusers2gEnable	否	boolean	true false	-	是否开启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
fastpassusers5gEnable	否	boolean	true false	-	是否开启 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
fastpassusers6gEnable	否	boolean	true false	-	是否开启 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
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
vipUser2dot4ModePhyProtection	否	string	满足正则表达^(security-priority\|business-priority\|disable)$。	disable	密盾功能。可选:security-priority 安全优先，对于不支持MU-MIMO功能的终端会拒绝接入；business-priority 业务优先只保障支持MU-MIMO功能的终端的业务安全性；disable:不使能。	"security-priority"
vipUser5ModePhyProtection	否	string	满足正则表达^(security-priority\|business-priority\|disable)$。	disable	密盾功能。可选:security-priority 安全优先，对于不支持MU-MIMO功能的终端会拒绝接入；business-priority 业务优先只保障支持MU-MIMO功能的终端的业务安全性；disable:不使能。	"security-priority"

表4 DeviceRadioEdcaDto对象的参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
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"

表5 6gRadioConfig对象的参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
dca6gChannelSet	否	string	-	-	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；为了确保校准结果,请选择至少三个选项。若可选信道少于三个,则此国家不支持配置此调优频宽。	"1,5,9,13,17,21,25,29"
dca6gBandwidth	否	string	-	-	6G调优频宽，只能为20mhz，40mhz，80mhz，160mhz，320mhz其中一种。	"20mhz"
scanSwitch6g	否	boolean	true false	-	空口扫描是否开启，可选值: true(默认)，false。当开启时，扫描时长，扫描间隔，扫描信道为必填项	true
radio11ax6GuardIntervalMode	否	string	-	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	true false	-	6G接入用户阈值使能，可选值: true，false	false
uacAccess6gThrehold	否	int32	[1-512]	-	6G接入用户阈值	64
uacReachthresHold6G	否	int32	[1-3]	-	6G用户优先保障策略范围：1：新用户禁止接入 2：用户禁止进入且隐藏 3：VIP用户优先接入	1
radio6gVhtAMsduEnable	否	boolean	true false	false	6G射频模板A-MSDU聚合开关，默认为关闭。	false
radio6gMaxFrameNum	否	int32	[2-15]	2	6G射频模板最大聚合子帧数，取值范围2~15，默认值为2。	2
radio6gMulticastRate	否	string	-	-	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	true false	-	6G弱信号终端强制下线。	false
vipUser6ModePhyProtection	否	string	满足正则表达^(security-priority\|business-priority\|disable)$。	disable	密盾功能。可选:security-priority 安全优先，对于不支持MU-MIMO功能的终端会拒绝接入；business-priority 业务优先只保障支持MU-MIMO功能的终端的业务安全性；disable:不使能。	"security-priority"

请求示例

HTTP的示例

PUT /controller/campus/v3/networkconfig/site/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
{
	"countryCode" : "CN",
	"scanSwitch" : true,
	"scanSwitch5g" : true,
	"scanDuration" : "60",
	"scanInterval" : "10000",
	"scanChannel" : "country-channel",
	"dca2gChannelSet" : "1,6,11",
	"dcaBandwidth" : "20mhz",
	"dca5gChannelSet" : "44,56,36,48,161,153,165,157,149,60,40,52,64",
	"calibrate" : "auto",
	"dcaStartTime" : "03:00:00",
	"dcaInterval" : 1440,
	"dcaScheduleTime" : "03:00:00",
	"tpcMaxTxPwr" : 127,
	"tpcMinTxPwr" : 9,
	"tpcCoverageThreshold" : -60,
	"radio2Dot4GuardIntervalMode" : "short",
	"radio5GuardIntervalMode" : "short",
	"radio11ax2Dot4GuardIntervalMode" : "dot8",
	"radio11ax5GuardIntervalMode" : "1dot6",
	"referenceDataAnalysis" : true,
	"selfCalibrate" : false,
	"radio2gMulticastRate" : "5.5",
	"radio5gMulticastRate" : "6",
	"radio5gVhtAMsduEnable" : false,
	"radio5gMaxFrameNum" : 2,
	"wmmMode" : true,
	"edcaClient" : [
		{
			"ac" : "acVo",
			"aifsn" : 3,
			"ecwMin" : 4,
			"ecwMax" : 6,
			"txoplimit" : 0,
			"ackPolicy" : "normal"
		}
	],
	"spectrumAnalysis" : false,
	"channelMonitor" : false,
	"antennaMode" : "omnidirection",
	"beaconCycle" : 60,
	"rtsCtsMode" : "cts-to-self",
	"rtsCtsThreshold" : 1400,
	"autoEnable" : true,
	"timeTemplateId" : "94386ba0-9976-4f92-b699-f3ca00de56e5",
	"airTimeFairSchedule" : true,
	"powerAutoAdjust" : true,
	"beamforming" : true,
	"dynamicSwitch" : false,
	"deauthFailTimes" : 0,
	"smartRoam" : false,
	"smartRoamThresholdSnr" : 20,
	"uca2gClientEnable" : false,
	"access2gThrehold" : 64,
	"reachthresHold2G" : 1,
	"uca5gClientEnable" : false,
	"access5gThrehold" : 64,
	"reachthresHold5G" : 1,
	"calibratePolicy" : "rogueAp,noise",
	"radio2gBaseRate" : "6,9,11",
	"radio2gSupportRate" : "6,9,11",
	"radio5gBaseRate" : "6,9,12",
	"radio5gSupportRate" : "6,9,12",
	"radio2gType" : "dot11ax",
	"radio5gType" : "dot11ax",
	"tpc5gMinTxPwr" : 9,
	"tpc5gMaxTxPwr" : 127,
	"tpc5gCoverageThreshold" : -60,
	"enableFlag2g" : false,
	"enableFlag5g" : false,
	"smartRoamScene2g" : "general",
	"smartRoamScene5g" : "general",
	"snr2g" : 5,
	"checkInterval2g" : 300,
	"snr5g" : 5,
	"checkInterval5g" : 300,
	"beEdcaMode" : true,
	"beEdcaThreshold" : 30,
	"mediaEdcaMode" : true,
	"mediaVoiceThreshold" : 30,
	"mediaVideoThreshold" : 30,
	"tcpWindowTuningSwitch" : true,
	"mediaVoiceDelay" : 2,
	"mediaVideoDelay" : 2,
	"mediaVoiceRatio" : 2,
	"mediaVideoRatio" : 2,
	"wmmScene" : "default",
	"flexibleRadio" : 2,
	"utmostPower2g" : 2,
	"utmostPower5g" : 1,
	"vipUser2dot4ModeUserDefine" : 20,
	"vipUser5ModeUserDefine" : 20,
	"mode" : "default",
	"radio5gSliceEnable" : false,
	"radio5gSliceRtt" : 20,
	"radio5gSliceFrerEnhance" : false,
	"coSrEnable" : true,
	"radio5gSliceRatio" : 80,
	"6gRadioConfig" : {
		"dca6gChannelSet" : "1,5,9,13,17,21,25,29",
		"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,
		"vipUser6ModePhyProtection" : "security-priority"
	},
	"fastpassusers2gEnable" : true,
	"fastpassusers2gNum" : 5,
	"fastpassusers2gPeriod" : "20ms",
	"fastpassusers2gRatio" : 25,
	"fastpassusers5gEnable" : true,
	"fastpassusers5gNum" : 5,
	"fastpassusers5gPeriod" : "20ms",
	"fastpassusers5gRatio" : 25,
	"fastpassusers6gEnable" : true,
	"fastpassusers6gNum" : 5,
	"fastpassusers6gPeriod" : "20ms",
	"fastpassusers6gRatio" : 25,
	"startThreshold2g" : 100,
	"gapThreshold2g" : 90,
	"snrThreshold2g" : 20,
	"denyThreshold2g" : 0,
	"clientBandExpire2g" : 35,
	"vipUser2dot4ModePhyProtection" : "security-priority",
	"vipUser5ModePhyProtection" : "security-priority"
}

响应参数

返回状态码为200：修改AP站点射频配置结果，返回结构体参见GroupRadioConfigResponsesDto。

GroupRadioConfigResponsesDto对象的参数列表，详细请参见表2。

返回状态码为400：校验异常。

详细信息请参见实际响应消息体。

响应示例

返回状态码为200：修改AP站点射频配置结果，返回结构体参见GroupRadioConfigResponsesDto。

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",
		"scanSwitch" : true,
		"scanSwitch5g" : true,
		"scanDuration" : "60",
		"scanInterval" : "10000",
		"scanChannel" : "country-channel",
		"dca2gChannelSet" : "1,6,11",
		"dcaBandwidth" : "20mhz",
		"dca5gChannelSet" : "44,56,36,48,161,153,165,157,149,60,40,52,64",
		"calibrate" : "auto",
		"dcaStartTime" : "03:00:00",
		"dcaInterval" : 1440,
		"dcaScheduleTime" : "03:00:00",
		"tpcMaxTxPwr" : 127,
		"tpcMinTxPwr" : 1,
		"tpcCoverageThreshold" : -60,
		"radio2Dot4GuardIntervalMode" : "short",
		"radio5GuardIntervalMode" : "short",
		"radio11ax2Dot4GuardIntervalMode" : "dot8",
		"radio11ax5GuardIntervalMode" : "1dot6",
		"referenceDataAnalysis" : true,
		"selfCalibrate" : false,
		"radio2gMulticastRate" : "5.5",
		"radio5gMulticastRate" : "6",
		"radio5gVhtAMsduEnable" : false,
		"radio5gMaxFrameNum" : 2,
		"wmmMode" : true,
		"edcaClient" : [
			{
				"ac" : "acVo",
				"aifsn" : 3,
				"ecwMin" : 4,
				"ecwMax" : 6,
				"txoplimit" : 0,
				"ackPolicy" : "normal"
			}
		],
		"spectrumAnalysis" : false,
		"channelMonitor" : false,
		"antennaMode" : "omnidirection",
		"beaconCycle" : 60,
		"rtsCtsMode" : "cts-to-self",
		"rtsCtsThreshold" : 1400,
		"autoEnable" : true,
		"timeTemplateId" : "94386ba0-9976-4f92-b699-f3ca00de56e5",
		"airTimeFairSchedule" : true,
		"powerAutoAdjust" : true,
		"beamforming" : true,
		"dynamicSwitch" : false,
		"deauthFailTimes" : 0,
		"smartRoam" : false,
		"smartRoamThresholdSnr" : 20,
		"uca2gClientEnable" : false,
		"access2gThrehold" : 64,
		"reachthresHold2G" : 1,
		"uca5gClientEnable" : false,
		"access5gThrehold" : 64,
		"reachthresHold5G" : 1,
		"calibratePolicy" : "rogueAp,noise",
		"radio2gBaseRate" : "6,9,11",
		"radio2gSupportRate" : "6,9,11",
		"radio5gBaseRate" : "6,9,12",
		"radio5gSupportRate" : "6,9,12",
		"radio2gType" : "dot11ax",
		"radio5gType" : "dot11ax",
		"tpc5gMinTxPwr" : 9,
		"tpc5gMaxTxPwr" : 127,
		"tpc5gCoverageThreshold" : -60,
		"enableFlag2g" : false,
		"enableFlag5g" : false,
		"smartRoamScene2g" : "general",
		"smartRoamScene5g" : "general",
		"snr2g" : 5,
		"checkInterval2g" : 300,
		"snr5g" : 5,
		"checkInterval5g" : 300,
		"beEdcaMode" : true,
		"beEdcaThreshold" : 30,
		"mediaEdcaMode" : true,
		"mediaVoiceThreshold" : 30,
		"mediaVideoThreshold" : 30,
		"tcpWindowTuningSwitch" : true,
		"mediaVoiceDelay" : 2,
		"mediaVideoDelay" : 2,
		"mediaVoiceRatio" : 2,
		"mediaVideoRatio" : 2,
		"wmmScene" : "default",
		"flexibleRadio" : 2,
		"utmostPower2g" : 2,
		"utmostPower5g" : 1,
		"vipUser2dot4ModeUserDefine" : 20,
		"vipUser5ModeUserDefine" : 20,
		"mode" : "default",
		"radio5gSliceEnable" : false,
		"radio5gSliceRtt" : 20,
		"radio5gSliceRatio" : 80,
		"radio5gSliceFrerEnhance" : false,
		"coSrEnable" : true,
		"6gRadioConfig" : {
			"dca6gChannelSet" : "1,5,9,13,17,21,25,29",
			"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,
			"vipUser6ModePhyProtection" : "security-priority"
		},
		"fastpassusers2gEnable" : true,
		"fastpassusers2gNum" : 5,
		"fastpassusers2gPeriod" : "20ms",
		"fastpassusers2gRatio" : 25,
		"fastpassusers5gEnable" : true,
		"fastpassusers5gNum" : 5,
		"fastpassusers5gPeriod" : "20ms",
		"fastpassusers5gRatio" : 25,
		"fastpassusers6gEnable" : true,
		"fastpassusers6gNum" : 5,
		"fastpassusers6gPeriod" : "20ms",
		"fastpassusers6gRatio" : 25,
		"startThreshold2g" : 100,
		"gapThreshold2g" : 90,
		"snrThreshold2g" : 20,
		"denyThreshold2g" : 0,
		"clientBandExpire2g" : 35
	}
}

返回状态码为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

父主题： AP站点射频配置

上一篇：查询AP站点射频配置信息

下一篇：AP站点IPV6业务开关配置

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

修改AP站点射频配置信息

典型场景

接口功能

接口约束

调用方法

URI

请求参数

请求示例

响应参数

响应示例

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈