閱讀627 返回首頁    go 英雄聯盟


查詢消費進度__消費管理相關接口_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. 使用示例

調用示例

  1. public static void main(String []args) {
  2. String regionId = "cn-hangzhou";
  3. String regionId = "cn-hangzhou";
  4. String accessKey = "XXXXXXXXXXXXXXXXX";
  5. String secretKey = "XXXXXXXXXXXXXXXXX";
  6. String endPointName ="cn-hangzhou";
  7. String productName ="Ons";
  8. String domain ="ons.cn-hangzhou.aliyuncs.com";
  9. /**
  10. *根據自己需要訪問的區域選擇Region,並設置對應的接入點
  11. */
  12. try {
  13. DefaultProfile.addEndpoint(endPointName,regionId,productName,domain);
  14. } catch (ClientException e) {
  15. e.printStackTrace();
  16. }
  17. IClientProfile profile= DefaultProfile.getProfile(regionId,accessKey,secretKey);
  18. IAcsClient iAcsClient= new DefaultAcsClient(profile);
  19. OnsConsumerTimeSpanRequest request = new OnsConsumerTimeSpanRequest();
  20. /**
  21. *ONSRegionId是指你需要API訪問MQ哪個區域的資源.
  22. *該值必須要根據OnsRegionList方法獲取的列表來選擇和配置,因為OnsRegionId是變動的,不能夠寫固定值
  23. */
  24. request.setOnsRegionId("daily");
  25. request.setPreventCache(System.currentTimeMillis());
  26. request.setAcceptFormat(FormatType.JSON);
  27. request.setConsumerId("CID_Mingduan");
  28. request.setTopic("MingduanTest12");
  29. try {
  30. OnsConsumerTimeSpanResponse response=iAcsClient.getAcsResponse(request);
  31. OnsConsumerTimeSpanResponse.Data data =response.getData();
  32. System.out.println(data.getTopic()+"n"+
  33. data.getConsumeTimeStamp()+"n"+
  34. data.getMaxTimeStamp()+"n"+
  35. data.getMinTimeStamp());
  36. } catch (ServerException e) {
  37. e.printStackTrace();
  38. } catch (ClientException e) {
  39. e.printStackTrace();
  40. }
  41. }

最後更新:2016-11-23 18:56:00

  上一篇:go 重置消費位點__消費管理相關接口_Open API_消息隊列 MQ-阿裏雲
  下一篇:go 消息軌跡查詢__消息管理相關接口_Open API_消息隊列 MQ-阿裏雲