739
阿里云
查询指定订阅信息__订阅管理相关接口_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 的订阅组信息,并打印。
public static void main(String []args) {String regionId = "cn-hangzhou";String accessKey = "XXXXXXXXXXXXXXXXX";String secretKey = "XXXXXXXXXXXXXXXXX";String endPointName ="cn-hangzhou";String productName ="Ons";String domain ="ons.cn-hangzhou.aliyuncs.com";/***根据自己需要访问的区域选择Region,并设置对应的接入点*/try {DefaultProfile.addEndpoint(endPointName,regionId,productName,domain);} catch (ClientException e) {e.printStackTrace();}IClientProfile profile= DefaultProfile.getProfile(regionId,accessKey,secretKey);IAcsClient iAcsClient= new DefaultAcsClient(profile);OnsSubscriptionGetRequest request = new OnsSubscriptionGetRequest();/***ONSRegionId是指你需要API访问MQ哪个区域的资源*该值必须要根据OnsRegionList方法获取的列表来选择和配置,因为OnsRegionId是变动的,不能够写固定值*/request.setOnsRegionId("daily");request.setPreventCache(System.currentTimeMillis());request.setAcceptFormat(FormatType.JSON);request.setTopic("MingduanTest");request.setConsumerId("CID_Mingduan");try {OnsSubscriptionGetResponse response=iAcsClient.getAcsResponse(request);List<OnsSubscriptionGetResponse.SubscribeInfoDo> subscribeInfoDoList=response.getData();for(OnsSubscriptionGetResponse.SubscribeInfoDo subscribeInfoDo:subscribeInfoDoList){System.out.println(subscribeInfoDo.getId()+" "+subscribeInfoDo.getChannelId()+" "+subscribeInfoDo.getChannelName()+" "+subscribeInfoDo.getOnsRegionId()+" "+subscribeInfoDo.getRegionName()+" "+subscribeInfoDo.getOwner()+" "+subscribeInfoDo.getConsumerId()+" "+subscribeInfoDo.getTopic()+" "+subscribeInfoDo.getStatus()+" "+subscribeInfoDo.getStatusName()+" "+subscribeInfoDo.getCreateTime()+" "+subscribeInfoDo.getUpdateTime());}} catch (ServerException e) {e.printStackTrace();} catch (ClientException e) {e.printStackTrace();}}
最后更新:2016-11-23 18:56:19
上一篇:
搜索指定发布信息__发布管理相关接口_Open API_消息队列 MQ-阿里云
下一篇:
获取所有订阅信息__订阅管理相关接口_Open API_消息队列 MQ-阿里云
PostVodPlaylist__关于LiveChannel的操作_API 参考_对象存储 OSS-阿里云
简单路由(支持 HTTP/HTTPS)__服务发现和负载均衡_用户指南_容器服务-阿里云
创建函数__数据库开发_用户指南(RDBMS)_数据管理-阿里云
域名 CNAME 解析设置方法__网站解析_产品使用问题_云解析-阿里云
通用图像分析服务简介__通用图像分析服务_人工智能图像类-阿里云
跨阿里云账号的ECS自建数据库迁移至RDS__最佳实践_数据传输-阿里云
启用加速域名__域名操作接口_API 手册_CDN-阿里云
安全服务__快速入门(开放API)_API 网关-阿里云
推送消息给android__API列表_OpenAPI 1.0_移动推送-阿里云
阿里云新一代关系型数据库 PolarDB
相关内容
常见错误说明__附录_大数据计算服务-阿里云
发送短信接口__API使用手册_短信服务-阿里云
接口文档__Android_安全组件教程_移动安全-阿里云
运营商错误码(联通)__常见问题_短信服务-阿里云
设置短信模板__使用手册_短信服务-阿里云
OSS 权限问题及排查__常见错误及排除_最佳实践_对象存储 OSS-阿里云
消息通知__操作指南_批量计算-阿里云
设备端快速接入(MQTT)__快速开始_阿里云物联网套件-阿里云
查询API调用流量数据__API管理相关接口_API_API 网关-阿里云
使用STS访问__JavaScript-SDK_SDK 参考_对象存储 OSS-阿里云