已记录了 Message Key ，如需根据此 Message Key 查询该消息的投递轨迹信息，即可调用本接口创建查询任务。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | QueryMqSofamqTraceByMsgKey | 系统规定参数。取值：QueryMqSofamqTraceByMsgKey。 |
| BeginTime | Long | 是 | 1570852800 | 查询的时间范围的起始时间点 |
| Cell | String | 是 | RZ01A | 需要查询的单元 |
| EndTime | Long | 是 | 1570968000 | 查询的时间范围的结束时间点 |
| InstanceId | String | 是 | MQ_INST_111111111111_DOxxxxxx | 需查询的消息的 Topic 所对应的实例 ID |
| MsgKey | String | 是 | ORDERID_100 | 需查询的消息的 Message Key |
| Topic | String | 是 | test | 需查询的消息的 Topic |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| QueryId | String | 272967562652883649157096685**** | 该查询任务的 ID。可根据该任务 ID，再调用 GetMqSofamqTraceResult 接口获取详细结果。 |
| RequestId | String | 861E6630-AEC0-4B2D-B214-6CB5E44B7F04 | 请求ID |
| ResultCode | String | OK | 结果码 |
| ResultMessage | String | OK | 结果描述 |
示例
请求示例
http(s)://[Endpoint]/?Action=QueryMqSofamqTraceByMsgKey
&BeginTime=1570852800
&Cell=RZ01A
&EndTime=1570968000
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&MsgKey=ORDERID_100
&Topic=test
&<公共请求参数>正常返回示例
XML 格式
<RequestId>861E6630-AEC0-4B2D-B214-6CB5E44B7F04</RequestId>
<QueryId>272967562652883649157096685****</QueryId>
<ResultMessage>OK</ResultMessage>
<ResultCode>OK</ResultCode>JSON 格式
{"RequestId":"861E6630-AEC0-4B2D-B214-6CB5E44B7F04","QueryId":"272967562652883649157096685****","ResultMessage":"OK","ResultCode":"OK"}错误码
访问错误中心查看更多错误码。