查询指定消息的发送轨迹。当消息的收发不符合预期时,您可以通过该接口查看消息的发布时间、发布客户端等详细信息,帮助您快速定位异常原因。
接口说明
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
MqttRegionId | string | 是 | 云消息队列 MQTT 版实例地域(Region)的 ID。请参见服务接入点。 | cn-hangzhou |
InstanceId | string | 是 | 云消息队列 MQTT 版实例的 ID,一定要和客户端实际使用的实例 ID 匹配。您可以在控制台实例详情页面的基础信息区域查看。 | mqtt-cn-i7m26mf**** |
MsgId | string | 是 | 消息 ID,即 Message ID。 | AC1EC0030EAB78308DB16A3EC773**** |
BeginTime | long | 是 | 查询范围的起始时间戳。单位:毫秒。 | 1618646400000 |
EndTime | long | 是 | 查询范围的终止时间戳。单位:毫秒。 | 1621591200000 |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "69AD5550-BF22-438A-9202-A6E89185****",
"MessageTraceLists": [
{
"Time": "2021-05-21 15:08:19.210",
"Action": "pub_mqtt",
"ActionCode": "mqtt.trace.action.msg.pub.mqtt",
"ActionInfo": "Pub From Mqtt Client",
"MsgId": "AC1EC0030EAB78308DB16A3EC773BD95",
"ClientId": "GID_test@@@producer"
}
]
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | ApiNotSupport | The specified API is not supported. | 当前接口不支持,请检查。 |
500 | SystemOverFlow | An error occurred while processing your request. Please try again. | 系统限流,请重试。 |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|
暂无变更历史
控制台操作
除了调用 QueryMqttTraceMessagePublish 接口,您还可以通过微消息队列 MQTT 版控制台查看消息的发送轨迹。具体操作,请参见消息轨迹查询。