阅读421 返回首页    go 英雄联盟


查询消费端连接__消费管理相关接口_Open API_消息队列 MQ-阿里云

本文介绍 OnsConsumerConnection 接口,用于查询指定订阅组(CID)下当前客户端的连接情况。

1. 使用场景

一般用于判断指定 CID 的消费者是否在线,并获取详细的客户端连接的列表。

2. 请求参数列表

名称 类型 是否必须 描述
OnsRegionId String 当前查询 MQ 所在区域,可以通过 ONSRegionList 方法获取
OnsPlatform String 该请求来源,默认是从 POP 平台
PreventCache Long 用于 CSRF 校验,设置为系统当前时间即可
ConsumerId String 需要查询的消费端 CID

3. 返回参数列表

名称 类型 描述
RequestId String 为公共参数,每个请求独一无二
HelpUrl String 帮助链接
Data List(ConnectionDo) 指定 Consumer 的连接信息

ConnectionDo 数据结构

成员 类型 描述
ClientId String 消费实例的 ID
ClientAddr String 该消费实例的地址和端口
Language String 消费端语言
Version String 消费端版本

4. 相关 API

  • OnsConsumerStatus:消费者状态查询
  • OnsConsumerAccumulate:消费堆积查询

5. 使用示例

调用示例

  1. public static void main(String []args) {
  2. String regionId = "cn-hangzhou";
  3. String accessKey = "XXXXXXXXXXXXXXXXX";
  4. String secretKey = "XXXXXXXXXXXXXXXXX";
  5. String endPointName ="cn-hangzhou";
  6. String productName ="Ons";
  7. String domain ="ons.cn-hangzhou.aliyuncs.com";
  8. /**
  9. *根据自己需要访问的区域选择Region,并设置对应的接入点
  10. */
  11. try {
  12. DefaultProfile.addEndpoint(endPointName,regionId,productName,domain);
  13. } catch (ClientException e) {
  14. e.printStackTrace();
  15. }
  16. IClientProfile profile= DefaultProfile.getProfile(regionId,accessKey,secretKey);
  17. IAcsClient iAcsClient= new DefaultAcsClient(profile);
  18. OnsConsumerGetConnectionRequest request = new OnsConsumerGetConnectionRequest();
  19. /**
  20. *ONSRegionId是指你需要API访问MQ哪个区域的资源.
  21. *该值必须要根据OnsRegionList方法获取的列表来选择和配置,因为OnsRegionId是变动的,不能够写固定值
  22. */
  23. request.setOnsRegionId("daily");
  24. request.setPreventCache(System.currentTimeMillis());
  25. request.setAcceptFormat(FormatType.JSON);
  26. request.setConsumerId("RTDSQ_1013_GROUP");
  27. try {
  28. OnsConsumerGetConnectionResponse response=iAcsClient.getAcsResponse(request);
  29. List<OnsConsumerGetConnectionResponse.Data.ConnectionDo> connectionDoList=response.getData().getConnectionList();
  30. for(OnsConsumerGetConnectionResponse.Data.ConnectionDo connectionDo:connectionDoList){
  31. System.out.println(connectionDo.getClientId()+" "+
  32. connectionDo.getClientAddr()+" "+
  33. connectionDo.getLanguage()+" "+
  34. connectionDo.getVersion());
  35. }
  36. } catch (ServerException e) {
  37. e.printStackTrace();
  38. } catch (ClientException e) {
  39. e.printStackTrace();
  40. }
  41. }

最后更新:2016-11-23 18:55:49

  上一篇:go 查询消费状态__消费管理相关接口_Open API_消息队列 MQ-阿里云
  下一篇:go 重置消费位点__消费管理相关接口_Open API_消息队列 MQ-阿里云