云社区 博客 博客详情
云社区 博客 博客详情

园区增值业务类API概述及向导

芙泡小超人 发表于 2020-02-21 18:07:20 02-21 18:07
芙泡小超人 发表于 2020-02-21 18:07:20 2020/02/21
0
0

【摘要】 主要针对终端用户信息统计类场景,包括客户端信息、流量信息等接口。 支持Portal在线用户、用户上下线日志、基于站点和设备维度的用户流量信息查询。 支持站点和设备维度连接终端数历史数据查询。 支持站点维度TopN终端流量数据查询、设备网络速率历史数据查询。 支持站点维度TopN设备或者全部设备的上行流量、下行流量查询。

快速开始

接口概述

主要针对终端用户信息统计类场景,包括客户端信息、流量信息等接口。

  • 支持Portal在线用户、用户上下线日志、基于站点和设备维度的用户流量信息查询。

  • 支持站点和设备维度连接终端数历史数据查询。

  • 支持站点维度TopN终端流量数据查询、设备网络速率历史数据查询。

  • 支持站点维度TopN设备或者全部设备的上行流量、下行流量查询。

登录认证

客户端向服务器下发登录认证请求,服务器返回一个Token和过期时间。

此处为模拟调测环境,已经为各位开发者创建好北向用户帐号。在调用真实环境的北向接口之前,应在iMaster NCE-Campus上创建具有Open Api Operator角色的帐号,用于获取Token。操作详情请参见创建北向用户

请求URL

获取Token值使用如下URL:

https://devzone.huawei.com/cloudcampus/controller/v2/tokens

Headers

此API使用如下Headers参数进行登录认证:

Headers参数值Content-Typeapplication/jsonAcceptapplication/jsonAccept-Languageen-US

请求示例

请求参数userName 和password为您的华为云帐号和密码。

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Accept-Language: en-US' -d '{"userName":"huaweiUser","password":"huaweiPassword"}' 'https://devzone.huawei.com/cloudcampus/controller/v2/tokens'

登录认证成功响应

{
    "errcode": "0",
    "errmsg": "get token successfully.",
    "data": {
        "expiredDate": "2020-01-08T17:10:11,887+08:00",
        "token_id": "aHVhd2VpcGFvZnU6SHVhd2VpMTIjJA=="
    }}

下发RESTful请求

客户端携带上面的Token再下发RESTful请求给服务器。

请求URL

调用查询用户组API使用如下URL:

https://devzone.huawei.com/controller/campus/v1/accountservice/usergroups

Headers

此API使用如下Headers参数下发RESTful请求:

Headers参数值Content-Typeapplication/jsonAcceptapplication/jsonAccept-Languageen-USX-ACCESS-TOKEN{token_id}

请求示例

X-ACCESS-TOKEN取值为已获取的Token值token_id。

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Accept-Language: en-US' --header 'X-ACCESS-TOKEN: aHVhd2VpcGFvZnU6SHVhd2VpMTIjJA==' -d '{"parentId":" a91e1696-02a2-4a68-bad4-aa639359c8cf","name":"friendName","address":"Xihu North Community","postalCode":"125744","adminEmail":"admin%40huawei.com","description":"common user group"}' 'https://devzone.huawei.com/cloudcampus/controller/campus/v1/accountservice/usergroups'

响应

{
     "data": {
          "address": "Xihu North Community",
          "adminEmail": "admin%40huawei.com",
          "bsid": "",
          "description": "common user group",
          "fullPathName": "",
          "id": "3e7d7186-dff6-48cf-8254-61cceae00090",
          "name": "friendName",
          "orderId": 0,
          "parentId": "a91e1696-02a2-4a68-bad4-aa639359c8cf",
          "postalCode": "125744"
     },
     "errcode": "0",
     "errmsg": ""}

向导

创建北向用户

  1. 使用华为云帐号登录沙箱预约系统

  2. 请参考预约实验室使用指导,完成实验室预约。

  3. 进入“我的环境 > 物理实验室”,当实验室为 active 状态时,单击已预约实验室操作列表的“体验”,进入体验界面。

  4. 单击iMaster NCE-Campus图标,在“属性”页签获取iMaster NCE-Campus 的IP、用户名和密码(使用此用户名和密码登录iMaster NCE-Campus,用于创建北向用户)。
    resource.png

  5. 鼠标悬浮至iMaster NCE-Campus图标,单击connector.png

,可使用上面获取的用户名和密码登录到iMaster NCE-Campus。
networking.png

  1. 选择“系统 > 系统管理 > 管理员”,在“用户”页签中单击“创建”,创建Open Api Operator帐号。请将“首次登录修改密码”选择“否”。
    open-api-operator.png

  1. 两次单击“下一步”。

  2. 单击“确定”。

REST API

约束与注意

  • 接口的输入参数、请求消息体、结果消息体统一采用UTF-8编码。

  • 通过PUT进行修改操作时,如果非必填字段在报文中未携带,或填为null,则此字段维持原值,不作修改。若想清空一个string字段,可以填入空字符串""。

  • HTTP Header中,可以通过Accept-Language设置en-US来指定返回信息为英文,若不指定Accept-Language,则默认返回英文信息。

  • 通过API创建的数据,不能在iMaster NCE-Campus界面上删除。

  • 所有API的请求报文中Host端口号由18008改为18002。

  • 所有API的接口使用的是北向IP。

  • API接口调用会话超时时间默认设置为10分钟,若10分钟内无会话交互,则系统会自动清理会话session。

接口规范

iMaster NCE-Campus的所有REST接口的URL地址均遵从下述规范:

<OP> / <service-path> / <resource> ? <query>
  • OP:对应方法,方法包括POST、PUT、DELETE、GET。

  • service-path:REST API微服务路径。

  • resource:操作的资源路径。

  • query:参数集。使用“name=value”对标识。

HTTP Headers

iMaster NCE-Campus对REST接口的Headers进行了一定的限制,主要包括如下几个参数:

  • Content-Type:包含了文档的“mime-type”。浏览器将会依据该参数决定如何对文档进行解析。

  • Accept:表示浏览器可接受的MIME类型。浏览器将会依据该参数决定接受何种参数格式。

  • Accept-Language:服务器端可接受的语言类型默认为en-US。

  • X-ACCESS-TOKEN:发送Token信息给服务器。

方法说明

方法URI格式功能说明幂等性GET/1、获取数据并且返回状态。2、指向要检索的数据节点。是PUT/1、更新数据并且返回状态。2、指向要存储的数据节点。是POST/1、创建一个节点并返回状态。2、指向要被存储的数据节点。否DELETE/1、删除一条数据且返回状态。2、指向要被删除的数据。否

状态码定义

RESTful采用HTTP状态码来报告操作结果。

状态码描述2xx操作成功400操作失败,错误的详细描述在errmsg中体现401未授权,常见错误为token填错、或已超时403不允许访问,常见错误为该管理员无对应权限或访问的资源不存在404请求的资源不存在,常见错误为,尝试GET不存在的资源415不支持请求中的报文体格式,常见错误为,未填Content-Type,或Content-Type的值不为application/json500服务器内部错误,常见错误为请求header中缺少必填字段503服务不可用,常见错误为ddos攻击

Java SDK向导

准备工作

如果您还没有下载Java SDK,请先点击这里CloudCampus Java SDK JAR下载我们的SDK JAR文件,SDK源码请参考CloudCampus Java SDK Sources

注:推荐使用JDK1.8及以上版本。

导入SDK包

将您下载的SDK JAR包导入您的Java工程,如果您使用maven构建您的工程,使用此命令将SDK安装到您的maven本地仓:

mvn org.apache.maven.plugins:maven-install-plugin:3.0.0-M1:install-file -Dfile=cloudcampus-1.0.0.jar

随后在您的maven工程的pom.xml文件中引入SDK依赖:

<dependency> 
   <groupId>com.huawei.cloudcampus.api</groupId> 
   <artifactId>cloudcampus</artifactId> 
   <version>1.0.0</version> 
 </dependency>

初始化客户端

使用com.huawei.cloudcampus.api.ApiClient类来初始化您的SDK,您需要配置北向API使用的端口号(18002),iMaster NCE-Campus控制器的IP以及北向帐号和密码(请参考创建北向用户),如下所示:

ApiClient apiClient = new ApiClient(); apiClient.setTenantName("tenant@north.com"); apiClient.setTenantPwd("Admin@1234"); apiClient.setHost("139.9.213.72"); apiClient.setPort("18002");

SDK使用示例

根据租户ID查询最后一次计费时间在指定时间范围之内的用户流量信息:

TimeFlowStInfosApi api = new TimeFlowStInfosApi(apiClient);Gson gson = new Gson();String siteId = "a91e1696-02a2-4a68-bad4-aa639359c8cf";Integer pageIndex = 1;Integer pageSize = 20;String sort = "userName";String userName = "zhangsan";String usedTime = "20";String usedFlow = "10";String beginTime = "2017-11-24 17:26:55";String endTime = "2017-11-25 17:26:55";TimeFlowStInfosOutputDto response = api.getTimeFlowStInfoList(siteId, pageIndex,           pageSize, sort, userName, usedTime, usedFlow, beginTime, endTime);String result = gson.toJson(response);System.out.println(result);

Python SDK向导

准备工作

如果您还没有下载Python SDK,请先点击这里CloudCampus Python SDK Sources下载我们的Python SDK源码文件。

安装SDK

下载完成后,解压文件。打开cmd命令行,运行如下命令进入CloudCampus Python SDK源码文件夹,例如运行如下命令:

cd FilesPath

FilesPath为CloudCampus Python SDK源码文件夹

运行如下命令安装Python SDK:

pip install -r requirements.txt

python-pip.png

python setup.py install

python-setup.png

安装完成后,运行如下命令查看SDK是否安装成功:

pip list

python-success.png

导入SDK包

以查询用户流量信息接口为例:

导入ApiClient、Configuration,和本次调用的api(TimeFlowStInfosApi)

from swagger_client.api_client import ApiClientfrom swagger_client.apis.time_flow_st_infos_api import TimeFlowStInfosApifrom swagger_client.configuration import Configuration

初始化客户端

使用ApiClient类来初始化您的SDK,您需要配置北向API使用的端口号(18002),iMaster NCE-Campus控制器的IP以及北向帐号和密码(请参考创建北向用户),如下所示:

tenantName = 'tenant@north.com'tenantPwd = 'Admin@1234'host = '139.9.213.72'port = '18002'config = Configuration(host, port, tenantName, tenantPwd)api_client = ApiClient(config)

SDK使用示例

根据租户ID查询最后一次计费时间在指定时间范围之内的用户流量信息:

api = TimeFlowStInfosApi(api_client)siteId = 'a91e1696-02a2-4a68-bad4-aa639359c8cf'pageIndex = 1pageSize = 20sort = 'userName'userName = 'zhangsan'usedTime = '20'usedFlow = '10'beginTime = '2017-11-24 17:26:55'endTime = '2017-11-25 17:26:55'model = api.get_time_flow_st_info_list(site_id=siteId, page_index=pageIndex, page_size=pageSize, sort=sort, user_name=userName, used_time=usedTime, used_flow=usedFlow, begin_time=beginTime, end_time=endTime)






登录后可下载附件,请登录或者注册

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区),文章链接,文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件至:huaweicloud.bbs@huawei.com进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容。
评论文章 //点赞 收藏 0
点赞
分享文章到微博
分享文章到朋友圈

评论 (0)


0/1000
评论

登录后可评论,请 登录注册

评论

您还没有写博客的权限!

温馨提示

您确认删除评论吗?

确定
取消
温馨提示

您确认删除评论吗?

删除操作无法恢复,请谨慎操作。

确定
取消
温馨提示

您确认删除博客吗?

确定
取消

确认删除

您确认删除博客吗?

确认删除

您确认删除评论吗?

温馨提示

登录超时或用户已下线,请重新登录!!!

确定
取消