WX3540X 如何开放Restful接口进行二次开发 或者 SNMP

mib查询

MIB查询

一、RESTful API（推荐，结构化 JSON 返回，完美替代 display wlan ap/mesh）
1. 开启 RESTful 完整命令配置
plaintext
system-view
# 1. 开启HTTPS REST（生产推荐，HTTP不安全可选）
restful https enable
# 限制访问源（只允许运维服务器IP访问，安全加固）
acl number 3000
rule permit source 192.168.1.0 0.0.0.255
restful acl 3000
# 2. 创建API专用管理员账号（必须带manage权限、http服务）
local-user api-admin class manage
password simple Api@123456
service-type http https
user-role network-admin # 权限足够读取全部WLAN、Mesh、射频信息
# 保存
save force
2. 可获取的目标数据（完全匹配你的需求）
官方 API 文档《H3C Access Controllers REST API Developers Guide》包含无线全量接口：
AP 全量信息（对应 display wlan ap all）
路径示例：GET /restapi/v1/wlan/ap
返回 JSON 包含：AP 名称、型号、序列号、在线状态、射频信道 / 功率、CAPWAP 隧道、CPU / 内存、客户端数量
Mesh 链路信息（对应 display wlan mesh-link ap）
路径示例：GET /restapi/v1/wlan/mesh-link
返回：Mesh 邻居 MAC、RSSI、链路状态 Active/Standby、射频接口、在线时长、Mesh ID
射频资源、在线终端、SSID、漫游、组播等全无线指标
3. 调用示例（Python requests 极简 Demo）
python
运行
import requests
# AC管理IP、账号密码
url = "https://192.168.0.1/restapi/v1/wlan/ap"
auth = ("api-admin", "Api@123456")
# 关闭证书校验（内网环境）
resp = requests.get(url, auth=auth, verify=False)
print(resp.json()) # 输出所有AP结构化数据
4. 优缺点
✅ 优势：数据结构化、直接拿到完整 Mesh 链路 / AP 详情、支持读写配置、无需解析文本；
❌ 限制：需要 Comware V7 R3308 及以上固件，老旧版本 API 接口不全。
二、SNMP 方案（传统监控、自动化采集，MIB 对应无线指标）
1. SNMPv3 安全配置（推荐，v2c 仅测试用）
plaintext
system-view
# 开启SNMP代理
snmp-agent
# 加载无线私有MIB（HH3C-DOT11系列）
snmp-agent mib load HH3C-DOT11-APMT-MIB
snmp-agent mib load HH3C-DOT11-MESH-MIB
# 创建v3用户
snmp-agent usm-user v3 snmpuser auth sha SimpleAuth@123 priv aes 123 SimplePriv@123
# 只读权限
snmp-agent group v3 snmpgroup read-view all
snmp-agent usm-user v3 snmpuser group snmpgroup
# 开启WLAN Trap（AP上下线、Mesh链路变更主动推送告警）
snmp-agent trap enable wlan ap
snmp-agent trap enable wlan mesh
2. 核心无线 MIB&OID（对应你两条查询命令）
（1）AP 全量信息 HH3C-DOT11-APMT-MIB
AP 在线状态：hh3cDot11APACAssociateStatus2
1 = 在线关联，2 = 离线，3 = 固件下载中
AP 名称、型号、序列号、射频信道、发射功率、空口利用率
OID 前缀：1.3.6.1.4.1.25506.2.75.2.1
（2）Mesh 链路专用 MIB HH3C-DOT11-MESH-MIB
Mesh 邻居 MAC、RSSI 信号强度、链路状态（Active/Standby）、射频接口、链路保活时长
完美对应 display wlan mesh-link ap 输出字段
（3）常用采集命令
bash
运行
# 批量walk所有AP信息
snmpwalk -v3 -u snmpuser -l authPriv -a SHA -A SimpleAuth@123 -x AES -X SimplePriv@123 192.168.0.1 HH3C-DOT11-APMT-MIB::hh3cDot11APTable
# 批量walk所有Mesh链路
snmpwalk -v3 ...... 192.168.0.1 HH3C-DOT11-MESH-MIB::hh3cDot11MeshLinkTable
3. 优缺点
✅ 优势：兼容所有监控平台（Zabbix/Prometheus）、主动 Trap 推送 AP/Mesh 变更、部署简单；
❌ 劣势：数据扁平化，Mesh 多链路、多射频需要循环遍历 OID 表，无法一次性拿到完整结构化对象。
三、NETCONF 方案（标准 XML 接口，适合自动化运维平台）
WX3540X 完整支持 NETCONF over SSH，可通过 XML 过滤器精准拉取 WLAN 数据库：
开启配置
plaintext
system-view
netconf server enable
# 复用上面api-admin账号，user-role network-admin
能力：支持筛选 AP 表、Mesh 链路表、射频资源，返回标准 XML 结构化数据；
适用场景：自研自动化平台、Ansible 自动化批量管理。
四、三种方案横向对比（按你的需求优先级）
表格
方案 获取 AP 全量信息 获取 Mesh 链路详情 数据格式 开发难度 适用场景
RESTful API ✅完整 JSON ✅完整 JSON JSON 低（Python/Java 直接解析） 自研二次开发、业务系统对接（首选）
SNMP ✅OID 表格 ✅OID 表格 键值 OID 中（需 MIB 映射） 监控平台、简单定时采集
NETCONF ✅XML ✅XML XML 高（需 XML 解析） 标准自动化运维、Ansible
五、关键补充说明
固件版本门槛
WX3540X Comware V7 R3308 及以上才完整支持 WLAN REST API、HH3C-DOT11-MESH-MIB；版本过低会缺失 Mesh 相关接口 / OID，建议升级至 R3310 稳定版。
权限注意
用于二次开发的管理员账号必须配置 user-role network-admin，低权限 network-operator 无法读取 Mesh、射频详细数据。
Mesh 数据限制
三种方案均可获取 display wlan mesh-link ap 全部字段（邻居 MAC、RSSI、链路主备状态、在线时长），RESTful 返回最直观，无需文本解析。
MIB 文件获取渠道
登录 H3C 官网支持中心，搜索 HH3C-DOT11-MIB、HH3C-DOT11-MESH-MIB 下载完整 MIB 库，用于 SNMP 工具字段映射。
最简落地建议
如果你是自研程序二次开发：优先开启 RESTful HTTPS API，直接调用 /restapi/v1/wlan/ap 和 /restapi/v1/wlan/mesh-link 两个接口，一步拿到 AP、Mesh 全部数据；
如果你是监控平台定时采集：用 SNMPv3 + HH3C-DOT11 私有 MIB，搭配 Zabbix/Prometheus 做可视化监控。