通過傳入Topic名稱和Message Key創建軌跡查詢任務，得到該查詢任務的ID。您需要再調用OnsTraceGetResult接口，傳入返回的查詢任務ID，獲取消息軌跡的詳細結果。
接口說明
注意 阿里云提供的 OpenAPI 屬于管控類 API，用于管理和查詢阿里云服務的相關資源。僅推薦在管控鏈路集成，消息收發的核心數據鏈路中嚴禁依賴 OpenAPI 實現，否則可能會導致鏈路產生風險。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Topic | string | 是 | 需查詢的消息的 Topic。 | test |
| MsgKey | string | 是 | 需查詢的消息的 Message Key。 | ORDERID_100 |
| BeginTime | long | 是 | 查詢的時間范圍的起始時間戳，單位：毫秒。 | 1570852800000 |
| EndTime | long | 是 | 查詢的時間范圍的結束時間戳，單位：毫秒。 | 1570968000000 |
| InstanceId | string | 是 | 需查詢的消息的 Topic 所對應的實例 ID。 | MQ_INST_111111111111_DOxxxxxx |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "F8654231-122A-4DBD-801F-38E35538****",
"QueryId": "272967562652883649157096685****"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史
控制臺操作
除了調用 OnsTraceQueryByMsgKey 接口，您還可以通過云消息隊列 RocketMQ 版控制臺創建消息軌跡查詢任務。具體操作，請參見消息查詢。