627
魔兽
查询消费进度__消费管理相关接口_Open API_消息队列 MQ-阿里云
本文介绍 OnsConsumerTimeSpan 接口,该接口提供查询当前订阅组订阅的 Topic 的最新消息时间戳以及消费的最新时间戳。
1. 使用场景
使用本接口可以解决查询某个 Topic 当前服务器上存在的消息的最新时间以及最早时间,以及查询消费端最近消费的时间的需求。一般用于展示消费进度的概况,和 ConsumeAccumulate 接口配合使用。
2. 请求参数列表
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
OnsRegionId | String | 是 | 当前查询 MQ 所在区域,可以通过 ONSRegionList 方法获取 |
OnsPlatform | String | 否 | 该请求来源,默认是从 POP 平台 |
PreventCache | Long | 是 | 用于 CSRF 校验,设置为系统当前时间即可 |
ConsumerId | String | 是 | 需要查询的消费端 CID |
Topic | String | 是 | 需要查询的消费的 Topic |
3. 返回参数列表
名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 为公共参数,每个请求独一无二 |
HelpUrl | String | 帮助链接 |
Data | Data | 查询结果 |
Data 数据结构
成员 | 类型 | 描述 |
---|---|---|
Topic | String | 查询的 Topic 名称 |
MinTimeStamp | Long | 整个 Topic 目前存储的最新的消息的时间 |
MaxTimeStamp | Long | 整个 Topic 目前存储的最老的消息的时间 |
ConsumeTimeStamp | Long | 当前 group 消费该 Topic 的最新的时间 |
4. 相关 API
- OnsConsumerAccumulate:查询消费堆积
- OnsConsumerStatus:查询消费端详情
- OnsConsumerResetOffset:重置位点和清除消息
5. 使用示例
调用示例
public static void main(String []args) {
String regionId = "cn-hangzhou";
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);
OnsConsumerTimeSpanRequest request = new OnsConsumerTimeSpanRequest();
/**
*ONSRegionId是指你需要API访问MQ哪个区域的资源.
*该值必须要根据OnsRegionList方法获取的列表来选择和配置,因为OnsRegionId是变动的,不能够写固定值
*/
request.setOnsRegionId("daily");
request.setPreventCache(System.currentTimeMillis());
request.setAcceptFormat(FormatType.JSON);
request.setConsumerId("CID_Mingduan");
request.setTopic("MingduanTest12");
try {
OnsConsumerTimeSpanResponse response=iAcsClient.getAcsResponse(request);
OnsConsumerTimeSpanResponse.Data data =response.getData();
System.out.println(data.getTopic()+"n"+
data.getConsumeTimeStamp()+"n"+
data.getMaxTimeStamp()+"n"+
data.getMinTimeStamp());
} catch (ServerException e) {
e.printStackTrace();
} catch (ClientException e) {
e.printStackTrace();
}
}
最后更新:2016-11-23 18:56:00
上一篇:
重置消费位点__消费管理相关接口_Open API_消息队列 MQ-阿里云
下一篇:
消息轨迹查询__消息管理相关接口_Open API_消息队列 MQ-阿里云
定位及解决 HSF 问题__HSF 常见问题_开发常见问题_产品常见问题_企业级分布式应用服务 EDAS-阿里云
数据管理服务协议__产品常见问题_数据管理-阿里云
云服务器 ECS Linux实例挂载数据盘报错
淘宝账号验证不通过__管理后台_服务商_云市场-阿里云
修改SNAT规则__NAT网关相关接口_API参考_专有网络 VPC-阿里云
签名__调用方式_RAM API文档_访问控制-阿里云
监控服务__系统架构_产品简介_云数据库 RDS 版-阿里云
参数化__脚本编写_使用手册_性能测试-阿里云
索引查询-消息服务(MNS)日志__最佳实践_日志服务-阿里云
更换域名__常见问题_云解析-阿里云
相关内容
常见错误说明__附录_大数据计算服务-阿里云
发送短信接口__API使用手册_短信服务-阿里云
接口文档__Android_安全组件教程_移动安全-阿里云
运营商错误码(联通)__常见问题_短信服务-阿里云
设置短信模板__使用手册_短信服务-阿里云
OSS 权限问题及排查__常见错误及排除_最佳实践_对象存储 OSS-阿里云
消息通知__操作指南_批量计算-阿里云
设备端快速接入(MQTT)__快速开始_阿里云物联网套件-阿里云
查询API调用流量数据__API管理相关接口_API_API 网关-阿里云
使用STS访问__JavaScript-SDK_SDK 参考_对象存储 OSS-阿里云