华为云用户手册

  • 背景信息 为了提升安全性,建议在二层网络中专门划分一个管理VLAN用于云化设备的配置和运维。通过华为乾坤云平台,可以为站点内的防火墙/交换机/AP统一配置管理VLAN。 请务必按网络层级自下而上的顺序依次切换各云化设备的管理VLAN,否则会造成设备脱管。 当前系统最多支持创建和管理512个VLAN。 对于防火墙和交换机,还可以配置“自协商管理VLAN”功能。后续新增的下行云化设备可以自动使用防火墙/交换机上配置的“自协商管理VLAN”作为管理VLAN,通过该管理VLAN从DHCP服务器获取IP地址,并注册到华为乾坤云平台。 如下及之后版本的云化设备支持通过华为乾坤云平台配置自协商管理VLAN。 防火墙:V500R005C00 交换机:V200R012C00 当交换机的上行口设置为Eth-Trunk场景时,设备侧已经预配置上行口为Eth-Trunk,那么有以下两种处理方法。 在华为乾坤云平台侧配置上行口为Eth-Trunk口,且配置与设备侧相同。 关闭交换机管理VLAN的参数“上行口自动放行”。
  • 参数说明 表1 全局DHCP配置的部分参数说明 参数 说明 DHCP使能 是否使能全局DHCP功能,默认使能。 网关IP地址 设置网关IP地址,默认是10.1.1.1。 子网掩码 设置子网掩码,默认是24位。 日志记录 默认关闭,开启后AP可以记录DHCP服务器配置成功或者失败的日志信息,然后向华为乾坤云平台上报。 租期 DHCP服务器动态分配的IP地址租期。 首选WINS 分配给DHCP客户端的首选WINS服务器地址。 备选WINS 分配给DHCP客户端的备用WINS服务器地址。 静态地址绑定 单击“增加”为特定DHCP客户端分配固定的IP地址,单击“删除”可以取消绑定的静态地址。 VLAN ID 业务子网对应的VLAN,也是AP上设置的子网网关VLANIF接口编号。
  • 背景信息 在AR上配置网口,使其接入到有线网络中。配置的接口必须与安装连线时选用的网络接口相匹配。 设备上线前若对接口进行了个性化配置,且上线之后该接口为上行接口,设备上线后为避免下发到该上行接口上的配置失败,会对该接口进行配置修复,该接口下的个性化配置将丢失。为防止配置丢失,可以待设备直接上线之后再做接口的个性化配置。 当设备的角色(网关+核心或者网关+路由反射器)不同时,为防止与其他配置冲突,此部分界面显示的参数有区别。
  • 使用指引 表1 网络运维操作指引 使用场景 配置指引 说明 1.我想要了解服务概况 服务首页介绍 服务首页支持查看网络设计与建设、网络运维与分析、网络体验优化以及网络基本运营报表和事件统计信息。 网络大屏介绍 大屏支持查看网络规划与建设、网络优化和网络维护三块内容,可以全面了解网络质量和网络短板,以便及时优化网络。 2. 我想要进行网络智能运维和优化 开启设备数据上报 完成网络规划与部署后,设备侧需要上报基础数据和运维数据,以便华为乾坤云平台实时监控设备状态,同时进行智能分析和运维。 网络环境监控 网络环境监控可以评估网络健康度,智能分析定位网络异常情况,给出修复建议。 用户体验保障 用户体验保障支持用户体验可视化管理,支持回放用户旅程以及回放用户接入协议交互过程,识别异常问题根因并给出修复建议。 智能调优 智能调优,可以帮助用户进行无线射频智能调优,支持无线智能漫游。 应用分析 应用分析,可以帮助用户统计和分析全网应用数据,保障网络应用畅通无阻。
  • 后续操作 用户组支持的后续操作。 搜索用户组:在搜索框输入用户组名称,单击按钮或回车键进行搜索。 编辑用户组:单击,选择“修改”,支持编辑用户组相关信息,包括用户组名称、地址、邮编等。 查看用户组:选择用户组,单击,选择“查看”。可查看当前用户组信息。 用户支持的后续操作。 搜索用户:在搜索框输入关键字,单击按钮或回车键进行搜索。 查看详情:选择需要查看的用户,单击用户列表中查看用户详细信息。 修改用户:单击用户列表中编辑用户信息,包括最大接入终端数、过期时间等。 删除用户: 单个删除:选择需要删除的用户,单击用户列表中删除用户。 批量删除:选择需要删除的用户,单击用户列表右上方“删除”。 停用/启用用户:选择用户,单击“停用”,停用用户,单击“启用”,启用用户。 重置密码:选择用户,单击用户列表中重置用户密码。 重置密码操作会自动开启下次登录修改密码功能。如果帐号在线,重置密码操作会强制该帐号下线。 访客帐号页面支持的后续操作。 搜索访客账号:在搜索框输入用户名,单击按钮或回车键进行搜索。 查看详情:选择需要查看的访客帐号,单击列表中查看访客帐号详细信息。 删除访客账号: 单个删除:选择需要删除的访客帐号,单击列表中删除。 批量删除:选择需要删除的访客帐号,单击列表右上方“删除”。 重置密码:选择访客帐号,单击列表中重置密码。 重置密码操作会自动开启下次登录修改密码功能。如果帐号在线,重置密码操作会强制该帐号下线。 社交媒体页面支持的后续操作。 删除公众号:单击公众号列表中删除公众号。 编辑公众号:单击公众号列表中编辑公众号信息,包括公众号名称、URL对接密钥、失效时间等。
  • 后续操作 认证规则支持的后续操作。 设置规则优先级:单击规则列表中“优先级”列中设置优先级,优先级设置不可重复。 搜索:在搜索框输入名称,单击按钮或回车键进行搜索。 停用/启用:选择认证规则,单击列表右上方“停用”,停用认证规则,单击列表右上方“启用”,启用认证规则。 修改规则信息:单击规则列表中修改规则信息,包括名称、启用Portal-HACA协议、用户信息和位置信息等。 查看详情:单击规则列表中查看规则详情。 删除认证规则: 单个删除:选择需要删除的规则,单击列表中删除。 批量删除:选择需要删除的规则,单击列表右上方“删除”。 授权结果支持的后续操作。 搜索:在搜索框输入关键字,单击按钮或回车键进行搜索。 查看详情:单击授权结果列表中查看规则详情。 修改授权结果信息:单击列表中修改授权结果信息,包括名称、策略等。 绑定站点:单击列表中,在“绑定站点”页面单“增加”,选择需要绑定的站点,单击“确定”完成站点绑定操作。 删除授权结果: 单个删除:选择需要删除的授权结果,单击列表中删除。 批量删除:选择需要删除的授权结果,单击列表右上方“删除”。 授权规则支持的后续操作。 设置规则优先级:单击规则列表中“优先级”,优先级设置不可重复。 搜索:在搜索框输入名称,单击按钮或回车键进行搜索。 停用/启用:选择授权规则,单击列表右上方“停用”,停用授权规则,单击列表右上方“启用”,启用授权规则。 查看详情:单击授权结果列表中查看规则详情。 修改规则信息:单击规则列表中修改规则信息。 删除授权规则: 单个删除:选择需要删除的规则,单击列表中删除。 批量删除:选择需要删除的规则,单击列表右上方“删除”。 MDM条件支持的后续操作。 搜索:在搜索框输入名称或描述,单击按钮或回车键进行搜索。 编辑:单击列表中,支持修改MDM条件。 删除MDM条件: 单个删除:选择需要删除的MDM条件,单击列表中删除。 批量删除:选择需要删除的MDM条件,单击列表右上方“删除”
  • 基础操作 表1 租户基础操作 操作任务 使用场景 操作入口 详细参考链接 委托MSP管理 当您需要委托MSP(服务渠道商)进行日常运维时,需要执行委托操作。当前仅边界防护与响应服务支持MSP委托。 单击右上角个人帐号,选择“委托”。 委托MSP管理 创建工单 当您在使用服务时,一旦发现问题即可创建问题工单。随后,华为工程师根据工单记录进行问题分析和处理。 单击右上角个人帐号,选择“我的工单”。 工单管理 新建用户 华为乾坤支持分权分域管理。您可以根据组织结构划分不同的工作组,并为不同的工作组创建用户。 单击右上角个人帐号,选择“权限管理”。 创建用户 订阅 华为乾坤支持订阅功能。订阅之后,华为乾坤会向订阅接受者发送订阅主题相关的信息。 单击右上角个人帐号,选择“订阅”。 订阅管理 查看日志 日志主要包括操作日志和安全日志。当您需要了解相关信息的时候,可以查看。 单击右上角个人帐号,选择“日志”。 日志查看
  • 委托MSP 如果租户想委托MSP管理云管理网络,需要创建委托申请。等MSP审批同意后,将与MSP成功建立委托关系。 以租户帐号登录华为乾坤工作台。 在租户帐号界面,单击右上角帐号,选择“委托”进入委托界面。 单击“创建”,根据表 委托参数设置参数,然后单击“确定”。 表2 委托参数 参数 说明 受托方标识 若当前租户帐号由MSP创建,界面默认已填充对应的MSP标识。 若当前租户帐号是自注册,请向被委托的MSP获取唯一标识(在MSP界面,单击帐号名获取唯一标识)。 委托列表 选择“公共服务”中“基础管理”和“设备管理”角色卡片。 选择“网络服务”中“云管理网络”角色卡片。 委托角色包括管理员、审计员、开放接口操作员,默认全选。 委托到期时间 选择委托到期时间,到达该时间后,本次委托将自动结束。 说明 委托说明,此处填写的内容将在MSP的审批流程中显示。 在弹出的授权清单界面,确认无误后勾选“我已阅读代操作授权风险告知协议并明确该操作的风险”,单击“确定”。当MSP审批同意后,将与MSP建立委托关系。
  • 特性约束 设备和华为乾坤云平台的时间必须保持同步,如果两者时间差超过10分钟,华为乾坤云平台上将无法展示设备上报的数据。如果不同步,建议通过配置同源的NTP服务器来保证设备和平台时间同步。 对于不支持RTC(Real-Time Clock)功能的交换机设备,如果其NTP服务器发生故障或者和NTP服务器断连,交换机断电重启后会以上次写入Flash的时间为准,设备和平台之间的时间差可能会超过10分钟。请解决NTP服务器故障或者网络故障,恢复NTP时间同步,上报数据方可正常显示。以下交换机不支持RTC: S5720-LI系列交换机。 S5720S-LI系列交换机。 S5720I-6X-PWH-SI-AC、S5720I-10X-PWH-SI-AC、S5720I-12X-SI-AC、S5720I-12X-PWH-SI-DC。 S5735-L、S5735S-L、S5735-SL-M、S5735-S-I。 S8700-6、S8700-10、S6730-H24X6C-V2、S6730-H48X6C-V2、S6730-H48Y6C-V2、S6730-H48Y6C-TV2、S6730-H24X6C-TV2、S6730-H48X6C-TV2不支持上报告警数据信息功能。 S8700和S6730-H系列交换机只支持上报性能数据信息和上报设备日志信息开关。
  • 使用指引 表1 MSP操作指引 使用场景 配置指引 说明 1. 我想了解MSP门户 MSP界面介绍 登录MSP操作界面,需要了解模块布局和内容,方便进行后续的维护操作。 2. 我要接受租户委托 处理租户委托 如果租户发起或变更云管理网络的委托申请,MSP需要跟进处理。只有接受租户委托申请,才能进行租户业务代维。 3. 我为租户代建网络 代建租户网络 MSP通过“网络规划与设计”功能生成网络方案,可以在线分享给租户,帮助其快速创建网络。 4. 我为租户代维业务 代维租户业务 MSP代维的服务不同,相应的代维操作也不同。 代维方式:对于云管理网络,仅支持MSP“按租户”维度代维,不支持“按服务”维度代维。 代维操作:支持查看和处理MSP帐号下所有租户的基本信息和业务信息,可以进入/退出代维。 5. 我想了解MSP基础操作 更多操作 除了上述针对代维云管理网络的特有操作,还有一些公共的基础操作,例如MSP个性化设置、访问控制(分权分域)、工单创建、日志/公告查看、套餐管理等。
  • 操作步骤 使用MSP帐号登录华为乾坤工作台。 单击工作台页面右上角帐号,选择“委托”进入委托界面。 审批委托申请。 在“待我审批”栏查看租户提供的委托说明、时间及委托服务,根据实际情况选择“拒绝”或“同意”。 删除委托关系。 在委托条目上,单击按钮可以发起删除委托关系申请,当租户审批同意后,该委托关系将被删除。 删除委托关系后,无法再代维委托方的数据,请确保委托方已知晓,并且与委托方已达成一致。 查看委托记录。 在委托页面,单击右上角“委托记录”,查看“我发起的”和“我审批的”的委托记录。对于处于待审批中的申请,可以单击按钮撤销委托。
  • MSP界面介绍 使用MSP帐号登录华为乾坤工作台,此处仅作简要介绍。MSP首页详细介绍请参见《MSP操作》中“MSP首页介绍”章节。 表1 MSP首页介绍 模块序号 模块名称 模块说明 1 地图 显示当前代维租户的相关信息,包括: 租户搜索 异常租户数及代维租户总数,单击异常租户数可进入“代维租户”页面。 鼠标悬停在租户图标上,支持修改当前租户位置和进入代维操作。 2 统计 显示各类统计图例,包括: 租户统计 设备统计 运营统计 工单统计 服务统计(Top5) Top5未处置问题租户 单击各个统计卡上按钮,进入各管理页面。 3 待处理事件 待办事件提醒。单击目标信息,可查看租户异常事件。 4 公告 显示华为乾坤最新信息,如产品公告、安全公告、升级公告、其他公告等。 父主题: MSP代建代维
  • 终端节点 终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从下表中查询服务的终端节点。 表1 网络环境监控和用户体验保障的终端节点 华为乾坤部署华为云区域 环境名称 终端节点(Endpoint) 华北-北京四 生产环境 qiankun-saas.huawei.com 乌兰察布-201 测试环境【仅限内部】 test.qiankun-saas.huawei.com 乌兰察布-201 开发联调【仅限内部】 dev.qiankun-saas.huawei.com 父主题: 使用前必读
  • 后续操作 方案管理页面显示了方案名称、状态、创建时间等信息,支持搜索、编辑、删除、分享等操作。 快速搜索方案。输入方案关键词,单击左侧或按回车键搜索。 不同状态下方案支持的操作不同,具体如表 不同状态支持的操作所示。 表4 不同状态支持的操作 状态 说明 支持的操作 草稿 方案未设计完成 编辑:单击方案列表中按钮,跳转到上次方案编辑的页面。 删除:单击方案列表中,删除一条方案记录。 待开局 已生成网规方案且可预览,在等待方案部署 分享:单击方案列表中,选择待分享的租户,单击“确定”。方案分享1次后,方案名称左上角会打上“多次分享”标签。 编辑:单击方案列表中,跳转到上次方案编辑的页面。 删除:单击方案列表中,删除一条方案记录。
  • 响应消息体 响应消息体通常以结构化格式返回,与响应消息头中Content-type对应,传递除响应消息头之外的内容。 对于获取用户Token接口,返回如下消息体。为篇幅起见,这里只展示部分内容。 { "error_code" : null, "error_msg" : null, "data" : { "token_id" : "x-883yc6ar2phgc6fsk7vz866ms6rw04vypi6kc7im1hc9pjimuk2omqdh8bftftnyurinc8rzem7xhdqrbwmp06k7o6uo48c97wthqn6lg7emuqamrtjs89dche0ac8k7", "expired_date" : "2021-12-31T09:57:11.571Z" }} 当接口调用出错时,会返回错误码及错误信息说明,错误响应的Body体格式如下所示。 { "exceptionId" : "user.login.user_or_value_invalid", "exceptionType" : "EX_F RAM E_EXCEPTION", "descArgs" : null, "reasonArgs" : null, "detailArgs" : null, "adviceArgs" : null, "exceptionMessage" : "用户名或密码错误。"} 其中,exceptionType表示错误码,exceptionMessage表示错误描述信息。
  • API概览 当前版本调用Kubernetes接口不支持HTTP长连接。 表1 网络环境监控检索接口 API 说明 查询无线健康度单个维度数据统计 查询无线健康度单个维度数据统计,根据指标类型查询该指标下的各子指标数据统计。 查询无线健康度单个维度趋势图 查询无线健康度单个维度趋势图,根据指标类型查询该指标趋势数据。 查询无线健康度区域达标率排名 查询无线健康度区域达标率排名,根据区域类型查询时间范围内的各区域达标率的排名数据。 查询无线健康度体系整体达标率 查询无线健康度体系整体达标率,根据区域类型查询时间范围内的无线健康度体系整体达标率的趋势图数据,包括当前达标率、接入成功率、接入耗时、漫游达标率、信号与干扰、容量健康度和吞吐达标率。 查询无线健康度指标概览 查询无线健康度指标概览,根据区域类型查询时间范围内的无线健康度各指标概览数据,包括总评分、接入成功率、接入耗时、漫游达标率、信号与干扰、容量健康度和吞吐达标率。 表2 用户体验保障检索接口 API 说明 查询用户统计趋势 查询用户不同接入类型、射频和SSID下的接入趋势图。 查询用户列表 查询用户列表,获取用户MAC、用户名、质差时长、接入类型、总流量等。 查询KPI趋势 查询用户性能趋势数据。 查询用户会话信息 查询用户会话信息,包括用户信息、会话开始时间、接入时长和设备信息等。 查询会话列表 查询用户会话列表信息,包含开始时间、接入设备、接入类型等。 查询用户物理带宽分布 查询Wi-Fi 6和非Wi-Fi 6设备质量看板分布。 父主题: API参考
  • 请求消息体 请求消息体通常以结构化格式发出,与请求消息头中Content-type对应,传递除请求消息头之外的内容。若请求消息体中参数支持中文,则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于获取用户Token接口,您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示,加粗的斜体字段需要根据实际值填写,其中user_name为用户名,password为用户登录密码。 scope参数定义了Token的作用域,下面示例中获取的Token仅能访问project下的资源。您还可以设置Token额作用域为某个帐号下所有资源或帐号的某个project下的资源,详细定义请参见获取用户Token。 POST https://qiankun-saas.huawei.com/v1/iam/tokens Content-Type: application/json { "user_name": "Your Username", "password": "Your Password"} 具备请求需要的以上内容后,您可以使用Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口,返回的响应消息头中“data.token_id”就是需要获取的用户Token。 获取Token 后,您就可以使用Token认证调用其他API。
  • 请求消息头 附加请求头字段,如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”,请求鉴权信息等。 如下公共消息头需要添加到请求中。 Content-Type:消息体的类型(格式),必选,默认取值为“application/json”,有其他取值时会在具体接口中专门说明。 x-auth-token:用户Token,可选,当使用Token方式认证时,必须填充该字段。用户Token也就是调用v1/iam/tokens接口的响应值,该接口是唯一不需要认证的接口,无须提供该参数。 对于获取用户Token接口,由于不需要认证,所以只添加“Content-Type”即可,添加消息头后的请求如下所示。 POST https://qiankun-saas.huawei.com/v1/iam/tokens Content-Type: application/json
  • 请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中,但大多数语言或框架都要求您从请求消息中单独传递它,所以在此单独强调。 URI-scheme:表示用于传输请求的协议,当前所有API均采用HTTPS协议。 Endpoint:指定承载REST服务端点的服务器域名或IP,不同服务不同区域的Endpoint不同,您可以从终端节点中获取。例如 IAM 服务在“华北-北京四”区域的Endpoint为“qiankun-saas.huawei.com”。 resource-path:资源路径,也即API访问路径。从具体API的URI模块获取,例如“获取用户Token”API的resource-path为“/v1/auth/tokens”。 query-string:查询参数,是可选部分,并不是每个API都有查询参数。查询参数前面需要带一个“?”,形式为“参数名=参数取值”,例如“limit=10”,表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京四”区域的Token,则需使用“华北-北京四”区域的Endpoint(qiankun-saas.huawei.com),并在获取用户Token的URI部分找到resource-path(/v1/iam/tokens),拼接起来如下所示。 https://qiankun-saas.huawei.com/v1/iam/tokens 为查看方便,在每个具体API的URI部分,只给出resource-path部分,并将请求方法写在一起。这是因为URI-scheme都是HTTPS,而Endpoint在同一个区域也相同,所以简洁起见将这两部分省略。
  • 请求方法 HTTP请求方法(也称为操作或动词),它告诉服务你正在请求什么类型的操作。 GET:请求服务器返回指定资源。 PUT:请求服务器更新指定资源。 POST:请求服务器新增资源或执行特殊操作,例如部分厂商会将复查参数查询转换为POST方法。 DELETE:请求服务器删除指定资源,如删除对象等。 HEAD:请求服务器资源头部。 PATCH:请求服务器更新资源的部分内容。当资源不存在的时候,PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分,您可以看到其请求方法为“POST”,则其请求为: POST https://qiankun-saas.huawei.com/v1/iam/tokens
  • 响应参数 返回状态码为 200: 获取用户信息成功。 表3 响应Body参数列表 名称 类型 是否必选 描述 resultCode Integer 否 状态码。 缺省值:200 errorDes String 否 错误描述。 缺省值:Successful. errorReson String 否 错误原因。 缺省值:Successful. errorDetail String 否 错误详情。 缺省值:Successful. errorAdvice String 否 错误建议。 缺省值:Successful. data Array of ClientSession 否 用户会话信息。 表4 ClientSession 名称 类型 是否必选 描述 userMac String 否 用户MAC。 userName String 否 用户名。 sessions Array of SessionInfo 否 会话模型。 表5 SessionInfo 名称 类型 是否必选 描述 time Long 否 会话开始时间。 缺省值:0L onlineTime Long 否 会话持续时间,单位秒。 缺省值:0L devMac String 否 接入设备MAC。 devName String 否 接入设备名称。 radioId String 否 射频ID。 ssid String 否 接入SSID。 userIp String 否 IP地址。 表6 返回状态码 返回状态码 状态码说明 响应参数 400 参数错误 无 401 该用户未认证 无 403 URL鉴权失败 无 404 REST接口没找到 无 500 服务器内部错误 无 502 网关错误 无 503 服务不可用 无
  • 响应示例 HTTP/1.1 200 OKData:Tue,26 Jul 2022 17:31:54 GMTServer: example.comContent-Type: application/json {"resultCode":200,"errorDes":"Successful.","errorReson":"Successful.","errorDetail":"Successful.","errorAdvice":"Successful.","data":[{"userMac":"string","userName":"string","sessions":[{"time":"integer","onlineTime":"integer","devMac":"string","devName":"string","radioId":"string","ssid":"string","userIp":"string"}]}]}
  • URL /v1/ci/enaasclient/openapi/client/sessions 表1 请求Query参数列表 名称 类型 是否必选 描述 param String 是 查询条件,param格式: {"param": {"siteId":"", // 站点区域ID,如果不设置该参数,默认查询所有站点。 "userMac":"",//用户MAC,查询该用户的会话信息。如果不设置该参数,默认查询所有用户会话信息。 "userIp":"", //用户IP,查询该用户的会话信息。如果不设置该参数,默认查询所有用户会话信息。 "userName":"",// 用户名,查询该用户的会话信息。如果不设置该参数,默认查询所有用户会话信息。 "startTime":"1607508000000",// 查询会话的开始时间,必填项。 "endTime":"1607511600000"// 查询会话的结束时间,必填项。查询间隔需大于1小时。} } 最大长度:90000 表2 请求Header参数列表 名称 类型 是否必选 描述 X-Auth-Token String 是 认证Token,用于API的Token认证。 最小长度:0 最大长度:90000
  • 请求示例 GET /v1/ci/enaasclient/openapi/client/sessions?param=null HTTP/1.1Host: example.comContent-Type: application/jsonAccept: application/jsonGET /rest/campusclientservice/v1/client/sessions?param={"startTime":"1607508000000","endTime":"1607511600000"} HTTP/1.1Content-Type: application/json;charset=UTF8Accept: application/jsonX-Auth-Token: MIIDwAYJKoZIhvcNAQcCoIIDsTCCA60CAQExDTALBglghkgBZQMEAgEwggIOBgkqhkiG9w0BBwGgggH--jxxA==
  • 请求Body参数 表2 请求Body参数列表 名称 类型 是否必选 描述 param String 否 查询条件,param为JSON格式字符串,包含以下参数: { "tenantId":"default-organization-id", // 租户ID,必填项。 "startTime":"1598544000000", // 结束时间,必填项。 "endTime":"1598599020000", // 开始时间,必填项。 "userType":"journey", // 用户类型。包含journey(无线旅程)和wiredclient(有线旅程),必填项。 "trendType":"1", // 聚合类型。包含1(默认值,聚合时长是1秒钟)、0(根据查询时间范围,查询时间范围小于两小时,聚合时长是1秒钟,大于两小时是1分钟)和2(聚合时长是5分钟),必填项。 "userMac":"30-00-00-00-**-**", // 用户MAC地址,必填项。 "key":"" // 查询时间范围,可选项。 }
  • 请求示例 POST /v1/ci/enaasclient/openapi/journey/kpi/trend HTTP/1.1Host: example.comContent-Type: application/jsonAccept: application/jsonPOST /rest/v1/journey/kpi/trend HTTP/1.1Content-Type: application/json;charset=UTF8Accept: application/jsonX-Auth-Token: MIIDwAYJKoZIhvcNAQcCoIIDsTCCA60CAQExDTALBglghkgBZQMEAgEwggIOBgkqhkiG9w0BBwGgggH--jxxA==body:{"tenantId":"default-organization-id","startTime":"1598544000000","endTime":"1598599020000","userType":"journey","trendType":"1","userMac":"30-00-00-00-**-**","key":""}
  • 响应参数 返回状态码为 200: 获取性能趋势数据成功。 表3 响应Body参数列表 名称 类型 是否必选 描述 resultCode Integer 否 状态码。 缺省值:200 errorDes String 否 错误描述。 缺省值:Successful. errorReson String 否 错误原因。 缺省值:Successful. errorDetail String 否 错误详情。 缺省值:Successful. errorAdvice String 否 错误建议。 缺省值:Successful. data Array of JourneyTrendModel 否 KPI趋势模型。 表4 JourneyTrendModel 名称 类型 是否必选 描述 startTime Long 否 开始时间。 endTime Long 否 结束时间。 duration Long 否 周期时长。 缺省值:0 apName String 否 AP名称。 pointModels Array of JourneyPointModel 否 KPI模型。 表5 JourneyPointModel 名称 类型 是否必选 描述 kpiType String 否 KPI指标类型。 kpiValue Double 否 KPI指标值。 缺省值:0 表6 返回状态码 返回状态码 状态码说明 响应参数 400 参数错误 无 401 参数错误 无 403 URL鉴权失败 无 404 REST接口没找到 无 500 服务器内部错误 无 502 网关错误 无 503 服务不可用 无
  • 响应示例 HTTP/1.1 200 OKData:Tue,26 Jul 2022 17:31:54 GMTServer: example.comContent-Type: application/json { "data":{ "starttime":1598903602921, "endtime":1598903602921, "duration":123 "apname":"hw", "pointmodels":[ { "kpitype":"rssi", "kpivalue":-72.30434782608695 }, { "kpitype":"downLinkSpeed", "kpivalue":147.7391304347826 }, { "kpitype":"latency", "kpivalue":509.82608695652175 }, { "kpitype":"txDiscardRatio", "kpivalue":3.722559807302787 } ], "resultCode":200, "errorDes":"Success", "errorReson":"Successful.", "errorDetail":"Successful.", "errorAdvice":"Successful." }}
  • 响应示例 HTTP/1.1 200 OKData:Tue,26 Jul 2022 17:31:54 GMTServer: example.comContent-Type: application/json { "data": { "UserTrend": [ { "timestamp": 1598903400000, "usernum": 46 }, { "timestamp": 1598904000000, "usernum": 7 }, { "timestamp": 1598904300000, "usernum": 6 }, { "timestamp": 1598904600000, "usernum": 6 }, { "timestamp": 1598904900000, "usernum": 4 }, { "timestamp": 1598905200000, "usernum": 15 } ] }, "resultCode": 0, "errorDes": "Successful.", "errorReson": "Success", "errorDetail": "Successful.", "errorAdvice": "Successful."}
  • 请求示例 GET /v1/ci/enaasclient/openapi/userstatistics/trend?param=null HTTP/1.1Host: example.comContent-Type: application/jsonAccept: application/jsonGET /rest/campusclientservice/v1/clientoverview/userstatistics/trend?param={"regionType":"site","level":"0","showType":"radio","startTime":"1598544000000","id":"/","endTime":"1598601596000","isAutoRefresh":"false"} HTTP/1.1Content-Type: application/json;charset=UTF8Accept: application/jsonX-Auth-Token: MIIDwAYJKoZIhvcNAQcCoIIDsTCCA60CAQExDTALBglghkgBZQMEAgEwggIOBgkqhkiG9w0BBwGgggH--jxxA==
共100000条