367      魔兽

消息轨迹查询__消息管理相关接口_Open API_消息队列 MQ-阿里云

本文档介绍 OnsMessageTrack 接口，该接口用于判断目标 MsgId 对应的消息是否已经消费过。

1. 使用场景

MessageTrack 接口一般用于判断指定的消息是否曾经被消费过，查询条件为单条消息的 MsgId。需要注意的是 MessagTrack 的实现基于 MQ 的内部位点机制，在大部分场景下判断结果可信，但如果应用方进行过重置位点已经清除消息等操作，则判断结果可能有误。

2. 请求参数列表

3. 返回参数列表

MessageTrack 数据结构

4. 相关 API

• OnsMessageGetByMsgId：根据 MsgId 精确查询消息

5. 使用示例

调用示例

   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);
           OnsMessageTraceRequest request = new OnsMessageTraceRequest();
            /**
            *ONSRegionId是指你需要API访问MQ哪个区域的资源.
            *该值必须要根据OnsRegionList方法获取的列表来选择和配置，因为OnsRegionId是变动的，不能够写固定值
            */
           request.setOnsRegionId("daily");
           request.setPreventCache(System.currentTimeMillis());
           request.setAcceptFormat(FormatType.JSON);
           request.setTopic("MingduanTest");
           request.setMsgId("0A91883700001F90000001BF4723CB3E");
           try {
               OnsMessageTraceResponse response=iAcsClient.getAcsResponse(request);
               List<OnsMessageTraceResponse.MessageTrack> trackList =response.getData();
               for (OnsMessageTraceResponse.MessageTrack track:trackList){
                   System.out.println(track.getConsumerGroup()+"  "+track.getTrackType()+"  "+track.getExceptionDesc());
               }
           } catch (ServerException e) {
               e.printStackTrace();
           } catch (ClientException e) {
               e.printStackTrace();
           }
       }