全部产品
云市场

加速状态查询

更新时间:2018-09-18 14:43:58

加速状态查询接口(BandStatusQuery)

查询当前宽带加速状态。返回值中分别展示了加速后,上行加速后的带宽,下行加速后的带宽。如果返回中上行/下行 返回值为空,则上行/下行 没有在加速状态或者加速失败。

参数列表

入参列表
参数名称 参数类型 是否必填 样例取值 参数说明
BandId Long 10001L 加速宽带ID
出参列表
参数名称 参数类型 样例取值 参数说明
RequestId String 89078768788ada 请求ID
Code String OK 状态码-返回OK代表请求成功,其他错误码详见错误码列表
Message String 请求成功 状态码的描述
ResultModle Object 查询结果,详见ResultModle 样例

ResultModle 格式

参数名称 参数类型 样例取值 参数说明
DownloadTarget Integer 200M 下行已经加速到的带宽,单位Mbps
UploadTarget Integer 10M 上行已经加速到的带宽,单位Mbps

技术对接步骤

1. 下载SDK开发工具

SDK工具包中一共包含了2个类库,一个aliyun-java-sdk-core包,另外一个是snsu-open-api包,将这两个包执行mvn package命令或者mvn deploy命令打包出相应的jar包,添加到工程类库中依赖使用。点击进入工具包下载

2. 编写样例程序
  1. /**
  2. * 产品名称:云通信加速API产品,开发者无需替换
  3. */
  4. static final String product = "Snsuapi";
  5. /**
  6. * 产品域名,开发者无需替换
  7. */
  8. static final String domain = "snsuapi.aliyuncs.com";
  9. // TODO 此处需要替换成开发者自己的AK(在阿里云访问控制台寻找)
  10. static final String accessKeyId = "yourAccessKeyId";
  11. static final String accessKeySecret = "yourAccessKey";
  12. public static BandStatusQueryResponse bandStatusQuery () {
  13. BandStatusQueryResponse response = new BandStatusQueryResponse();
  14. /**
  15. * 可自助调整超时时间
  16. */
  17. System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
  18. System.setProperty("sun.net.client.defaultReadTimeout", "10000");
  19. try {
  20. /**
  21. * 初始化acsClient,暂不支持region化
  22. */
  23. IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret);
  24. DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);
  25. IAcsClient acsClient = new DefaultAcsClient(profile);
  26. /**
  27. * 组装请求对象-具体描述见控制台-文档部分内容
  28. */
  29. BandStatusQueryRequest request = new BandStatusQueryRequest();
  30. Long bandId = 10001L;
  31. request.setBandId(bandId);
  32. /**
  33. * 具体的错误码可以参考具体的文档
  34. * 禁止Client的自动重试,如果加速失败,最好选择手动重试
  35. */
  36. response = acsClient.getAcsResponse(request, false, 0);
  37. if(response.getResultCode() != null && response.getResultCode().equals("OK")) {
  38. // todo 查询成功
  39. } else {
  40. // todo 查询失败
  41. }
  42. return response;
  43. } catch (ClientException e) {
  44. /**
  45. * 需要捕获Client异常
  46. */
  47. e.printStackTrace();
  48. /**
  49. * todo 进行一些特定业务处理,重试或者抛出异常
  50. */
  51. }
  52. return response;
  53. }