阅读739 返回首页    go 阿里云


查询指定订阅信息__订阅管理相关接口_Open API_消息队列 MQ-阿里云

本文介绍 OnsSubscribeGet 接口,调用该接口可以查询目标 CID 的详细信息。

1.使用场景

MQ 使用过程中如果需要对订阅关系进行管理,获取账号下 CID 的详细信息,可以调用该接口获取信息。

2.请求参数列表

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

3.返回参数列表

名称 类型 描述
RequestId String 为公共参数,每个请求独一无二
HelpUrl String 帮助链接
Data List(SubscribeInfoDo) 查询到的订阅关系集合

SubscribeInfoDo 数据结构

名称 类型 描述
Id Long 订阅信息在数据库中的索引编号
channelId Integer 该 Topic 所在区域 ID,0-ALIYUN,1-CLOUD,2,3,4
channelName String 该 Topic 所在区域名称,ALIYUN 代表阿里云,CLOUD 代表聚石塔,…
onsRegionId Long 该 Topic 所在区域 ID,就是 ONSRegionList 方法获取的内容
regionName String 该 Topic 所在区域名称
Owner String 该发布信息的拥有者
ConsumerId String 消费集群 ID
Topic String Topic 名称
Status Long 当前状态
StatusName String 状态名称,服务中,已下线等
CreateTime Long 创建时间
UpdateTime Long 最后更新时间

4.相关 API

  • OnsSubcribeCreate:创建订阅关系
  • OnsSubcribeDelete:删除订阅关系
  • OnsSubscribeList:获取订阅关系列表

5.使用示例

调用示例

本示例在 daily 区域下查询名为 CID_Mingduan 的订阅组信息,并打印。

  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. OnsSubscriptionGetRequest request = new OnsSubscriptionGetRequest();
  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.setTopic("MingduanTest");
  27. request.setConsumerId("CID_Mingduan");
  28. try {
  29. OnsSubscriptionGetResponse response=iAcsClient.getAcsResponse(request);
  30. List<OnsSubscriptionGetResponse.SubscribeInfoDo> subscribeInfoDoList=response.getData();
  31. for(OnsSubscriptionGetResponse.SubscribeInfoDo subscribeInfoDo:subscribeInfoDoList){
  32. System.out.println(subscribeInfoDo.getId()+" "+
  33. subscribeInfoDo.getChannelId()+" "+
  34. subscribeInfoDo.getChannelName()+" "+
  35. subscribeInfoDo.getOnsRegionId()+" "+
  36. subscribeInfoDo.getRegionName()+" "+
  37. subscribeInfoDo.getOwner()+" "+
  38. subscribeInfoDo.getConsumerId()+" "+
  39. subscribeInfoDo.getTopic()+" "+
  40. subscribeInfoDo.getStatus()+" "+
  41. subscribeInfoDo.getStatusName()+" "+
  42. subscribeInfoDo.getCreateTime()+" "+
  43. subscribeInfoDo.getUpdateTime());
  44. }
  45. } catch (ServerException e) {
  46. e.printStackTrace();
  47. } catch (ClientException e) {
  48. e.printStackTrace();
  49. }
  50. }

最后更新:2016-11-23 18:56:19

  上一篇:go 搜索指定发布信息__发布管理相关接口_Open API_消息队列 MQ-阿里云
  下一篇:go 获取所有订阅信息__订阅管理相关接口_Open API_消息队列 MQ-阿里云