615
英雄联盟
查询 Topic 当前位点__Topic 相关接口_Open API_消息队列 MQ-阿里云
本文介绍 OnsTopicStatus 接口,调用该接口可以查询指定 Topic 当前的消息状态。
1. 使用场景
查询当前 Topic 下的消息总量以及最后更新时间,一般用于判断 Topic 资源的使用率。TopicStatus 接口返回当前服务器上该 Topic 下所有的消息数,以及最后消息写入时间。
2. 请求参数列表
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
OnsRegionId | String | 是 | 当前查询 MQ 所在区域,可以通过 ONSRegionList 方法获取,参见公共术语 |
OnsPlatform | String | 否 | 该请求来源,默认是从 POP 平台 |
PreventCache | Long | 是 | 用于 CSRF 校验,设置为系统当前时间即可 |
Topic | String | 是 | 查询的 Topic 名称 |
3. 返回参数列表
名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 为公共参数,每个请求独一无二 |
HelpUrl | String | 帮助链接 |
Data | OnsTopicStatusResponse.Data | 查询到的 Topic 的信息存储数据结构 |
OnsTopicStatusResponse.Data 数据结构
成员 | 类型 | 描述 |
---|---|---|
totalCount | Long | 当前 Topic 的所有分区存在的消息数总和 |
lastTimeStamp | Long | 当前 Topic 的最后更新时间 |
4. 相关 API
- OnsTopicCreate:创建 Topic
- OnsConsumerStatus:查询订阅组的消费者状态
5. 使用示例
调用示例:
本示例仅仅提供一个参考,从华东1接入点接入,查询当前用户下名为”JODIE_TEST_27dd”的 Topic 的消息数量。
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);
OnsTopicStatusRequest request = new OnsTopicStatusRequest();
request.setAcceptFormat(FormatType.JSON);
/**
*ONSRegionId是指你需要API访问MQ哪个区域的资源.
*该值必须要根据OnsRegionList方法获取的列表来选择和配置,因为OnsRegionId是变动的,不能够写固定值
*/
request.setOnsRegionId("daily");
request.setPreventCache(System.currentTimeMillis());
request.setTopic("JODIE_TEST_27dd");
try {
OnsTopicStatusResponse response = iAcsClient.getAcsResponse(request);
OnsTopicStatusResponse.Data data=response.getData();
Long totalCount =data.getTotalCount();
Long lastTimeStamp =data.getLastTimeStamp();
System.out.println(response.getRequestId());
} catch (ClientException e) {
e.printStackTrace();
}
catch (Exception e) {
e.printStackTrace();
}
}
最后更新:2016-12-19 10:07:18
上一篇:
搜索指定 Topic 详细信息__Topic 相关接口_Open API_消息队列 MQ-阿里云
下一篇:
查询消费堆积__消费管理相关接口_Open API_消息队列 MQ-阿里云
更新应用配置__应用API列表_API参考_容器服务-阿里云
制作报表-工作表__制作报表_Quick BI-阿里云
云解析OpenAPI使用规范__云解析OPEN API_产品使用问题_云解析-阿里云
设置网络类型__网络管理_用户指南_云数据库 RDS 版-阿里云
表操作篇__最佳实践_表格存储-阿里云
GetLogstore__日志库相关接口_API-Reference_日志服务-阿里云
Spark + ODPS__Spark_开发人员指南_E-MapReduce-阿里云
下载域名日志__日志信息接口_API 手册_CDN-阿里云
DRDSReader__Reader插件_使用手册_数据集成-阿里云
短信三网都可以发送吗?能发送海外/港澳台吗?__常见问题_短信服务-阿里云
相关内容
常见错误说明__附录_大数据计算服务-阿里云
发送短信接口__API使用手册_短信服务-阿里云
接口文档__Android_安全组件教程_移动安全-阿里云
运营商错误码(联通)__常见问题_短信服务-阿里云
设置短信模板__使用手册_短信服务-阿里云
OSS 权限问题及排查__常见错误及排除_最佳实践_对象存储 OSS-阿里云
消息通知__操作指南_批量计算-阿里云
设备端快速接入(MQTT)__快速开始_阿里云物联网套件-阿里云
查询API调用流量数据__API管理相关接口_API_API 网关-阿里云
使用STS访问__JavaScript-SDK_SDK 参考_对象存储 OSS-阿里云