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