已根据 Message ID 或者 Message Key 创建了轨迹查询任务,并得到了查询任务的 ID。此时,可调用本接口通过传入该查询任务 ID,获取对应的轨迹查询的结果明细。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetMqSofamqTraceResult | 系统规定参数。取值:GetMqSofamqTraceResult。 |
InstanceId | String | 是 | MQ_INST_111111111111_DOxxxxxx | 实例 ID |
QueryId | String | 是 | 272967562652883649157096685**** | 消息轨迹查询的任务 ID |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct | 该查询任务的结果明细 | |
CreateTime | Long | 1570966857000 | 该查询任务的创建时间 |
InstanceId | String | MQ_INST_111111111111_DOxxxxxx | 实例 ID |
MsgId | String | 1E05791C117818B4AAC23B1BB0CE**** | 该查询任务对应的 Message ID |
MsgKey | String | keyA | 该查询任务对应的 Message Key |
QueryId | String | 272967562652883649157096685**** | 查询任务 ID |
Status | String | finish | 该查询任务的结果。取值说明如下:finish:查询完成;working:查询中;removed:任务已删除。 |
Topic | String | topic_a | 该查询任务的 Topic |
TraceList | Array | 该查询任务的匹配轨迹列表 | |
BornHost | String | 30.5.**.** | 消息发送方的客户端地址 |
Cell | String | RZ00A | 生产端的 cell name |
CostTime | Long | 24 | 发送耗时,单位毫秒 |
MsgId | String | 0BC1F01800002A9F000000531246**** | 消息的 ID,即 Message ID |
MsgKey | String | ORDERID_100 | 消息的 Key ,即 Message Key |
PubGroupName | String | GID_test | 发送方客户端配置的 Group ID |
PubTime | Long | 1570850870478 | 消息发送时间 |
Status | String | SEND_SUCCESS | 发送状态。取值说明如下:
|
SubList | Array | 消息的消费轨迹列表 | |
Cell | String | RZ00A | cell name |
ClientList | Array | 该 Group ID 客户端消费记录的明细列表 | |
ClientHost | String | 30.5.**.** | 消费客户端的客户端地址 |
CostTime | Long | 43 | 本次消费耗时,单位毫秒 |
ReconsumeTimes | Long | 1 | 本次消费的投递轮次 |
Status | String | CONSUME_SUCCESS | 消费状态。取值说明如下:
|
SubGroupName | String | GID_test | 该客户端所属的 Group ID |
SubTime | Long | 1570851590511 | 消费开始时间戳 |
FailCount | Long | 0 | 该 Group ID 消费失败次数统计 |
SubGroupName | String | GID_test | 消费方 Group ID |
SuccessCount | Long | 1 | 该 Group ID 消费成功次数统计 |
Tag | String | TagA | 消息的 Tag,即 Message Tag |
Topic | String | test | 消息的 Topic |
UpdateTime | Long | 1570966857000 | 该查询任务的最后更新时间 |
UserId | String | 27296756265288**** | 查询用户 ID |
RequestId | String | 861E6630-AEC0-4B2D-B214-6CB5E44B7F04 | 请求ID |
ResultCode | String | OK | 结果码 |
ResultMessage | String | OK | 结果描述 |
示例
请求示例
http(s)://[Endpoint]/?Action=GetMqSofamqTraceResult
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&QueryId=272967562652883649157096685****
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>861E6630-AEC0-4B2D-B214-6CB5E44B7F04</RequestId>
<Data>
<Status>finish</Status>
<InstanceId>MQ_INST_111111111111_DOxxxxxx</InstanceId>
<UserId>27296756265288****</UserId>
<CreateTime>1570966857000</CreateTime>
<MsgKey>keyA</MsgKey>
<QueryId>272967562652883649157096685****</QueryId>
<UpdateTime>1570966857000</UpdateTime>
<TraceList>
<CostTime>24</CostTime>
<Status>SEND_SUCCESS</Status>
<MsgKey>ORDERID_100</MsgKey>
<BornHost>30.5.**.**</BornHost>
<Tag>TagA</Tag>
<PubGroupName>GID_test</PubGroupName>
<PubTime>1570850870478</PubTime>
<Topic>test</Topic>
<Cell>RZ00A</Cell>
<MsgId>0BC1F01800002A9F000000531246**** </MsgId>
</TraceList>
<TraceList>
<SubList>
<FailCount>0</FailCount>
<SubGroupName>GID_test</SubGroupName>
<SuccessCount>1</SuccessCount>
<Cell>RZ00A</Cell>
</SubList>
<SubList>
<ClientList>
<CostTime>43</CostTime>
<Status>CONSUME_SUCCESS</Status>
<ClientHost>30.5.**.**</ClientHost>
<SubTime>1570851590511</SubTime>
<SubGroupName>GID_test</SubGroupName>
<ReconsumeTimes>1</ReconsumeTimes>
</ClientList>
</SubList>
</TraceList>
<Topic>topic_a</Topic>
<MsgId>1E05791C117818B4AAC23B1BB0CE****</MsgId>
</Data>
<ResultMessage>OK</ResultMessage>
<ResultCode>OK</ResultCode>
JSON
格式
{"RequestId":"861E6630-AEC0-4B2D-B214-6CB5E44B7F04","Data":{"Status":"finish","InstanceId":"MQ_INST_111111111111_DOxxxxxx","UserId":"27296756265288****","CreateTime":"1570966857000","MsgKey":"keyA","QueryId":"272967562652883649157096685****","UpdateTime":"1570966857000","TraceList":[{"CostTime":"24","Status":"SEND_SUCCESS","MsgKey":"ORDERID_100","BornHost":"30.5.**.**","Tag":"TagA","PubGroupName":"GID_test","PubTime":"1570850870478","Topic":"test","Cell":"RZ00A","MsgId":"0BC1F01800002A9F000000531246****\t"},{"SubList":[{"FailCount":"0","SubGroupName":"GID_test","SuccessCount":"1","Cell":"RZ00A"},{"ClientList":[{"CostTime":"43","Status":"CONSUME_SUCCESS","ClientHost":"30.5.**.**","SubTime":"1570851590511","SubGroupName":"GID_test","ReconsumeTimes":"1"}]}]}],"Topic":"topic_a","MsgId":"1E05791C117818B4AAC23B1BB0CE****"},"ResultMessage":"OK","ResultCode":"OK"}
错误码
访问错误中心查看更多错误码。