通過(guò)傳入軌跡查詢(xún)?nèi)蝿?wù)的ID獲取之前的軌跡查詢(xún)結(jié)果。
接口說(shuō)明
注意 阿里云提供的 OpenAPI 屬于管控類(lèi) API，用于管理和查詢(xún)阿里云服務(wù)的相關(guān)資源。僅推薦在管控鏈路集成，消息收發(fā)的核心數(shù)據(jù)鏈路中嚴(yán)禁依賴(lài) OpenAPI 實(shí)現(xiàn)，否則可能會(huì)導(dǎo)致鏈路產(chǎn)生風(fēng)險(xiǎn)。
- 若您已根據(jù) Message ID 或者 Message Key 創(chuàng)建了軌跡查詢(xún)?nèi)蝿?wù)，并得到了查詢(xún)?nèi)蝿?wù)的 ID。您可調(diào)用本接口根據(jù)查詢(xún)?nèi)蝿?wù) ID 獲取對(duì)應(yīng)的軌跡結(jié)果的明細(xì)。軌跡查詢(xún)?nèi)蝿?wù)通過(guò) OnsTraceQueryByMsgId 或 OnsTraceQueryByMsgKey 接口創(chuàng)建，返回?cái)?shù)據(jù)中的 QueryId 即為本接口中需要傳入的查詢(xún)?nèi)蝿?wù) ID。
- 因?yàn)橄④壽E查詢(xún)?nèi)蝿?wù)耗時(shí)較多，創(chuàng)建任務(wù)后立即根據(jù)該接口獲取結(jié)果可能為空，若遇到此情況，建議等待一段時(shí)間再重試。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語(yǔ)句的Action元素中使用，用來(lái)給RAM用戶(hù)或RAM角色授予調(diào)用此API的權(quán)限。具體說(shuō)明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪(fǎng)問(wèn)級(jí)別：是指每個(gè)操作的訪(fǎng)問(wèn)級(jí)別，取值為寫(xiě)入（Write）、讀取（Read）或列出（List）。
- 資源類(lèi)型：是指操作中支持授權(quán)的資源類(lèi)型。具體說(shuō)明如下：
- 對(duì)于必選的資源類(lèi)型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪(fǎng)問(wèn)級(jí)別 | 資源類(lèi)型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| mq:GetTraceResult | get | *Topic acs:mq:{#regionId}:{#accountId}:{#InstanceId}%{#TopicName}*Topic acs:mq:{#regionId}:{#accountId}:{#TopicName} |
|
|
請(qǐng)求參數(shù)
| 名稱(chēng) | 類(lèi)型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| QueryId | string | 是 | 需要提取軌跡查詢(xún)結(jié)果的任務(wù) ID。 | 272967562652883649157096685**** |
| InstanceId | string | 否 | 需查詢(xún)的消息所對(duì)應(yīng)的實(shí)例 ID。 | MQ_INST_111111111111_DOxxxxxx |
| Topic | string | 否 | 需查詢(xún)的消息的 Topic。 | test |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "84EE24D2-851F-40D6-B99E-4D6AB909****",
"TraceData": {
"Status": "finish",
"MsgKey": "ORDERID_100",
"UpdateTime": 1570966877000,
"CreateTime": 1570966857000,
"Topic": "test",
"UserId": "27296756265288****",
"InstanceId": "MQ_INST_111111111111_DOxxxxxx",
"MsgId": "1E05791C117818B4AAC23B1BB0CE****",
"TraceList": {
"TraceMapDo": [
{
"Status": "SEND_SUCCESS",
"MsgKey": "ORDERID_100",
"PubTime": 1570850870478,
"SubList": {
"SubMapDo": [
{
"ClientList": {
"SubClientInfoDo": [
{
"Status": "CONSUME_SUCCESS",
"SubTime": 1570851590511,
"ReconsumeTimes": 1,
"SubGroupName": "GID_test",
"ClientHost": "30.5.**.**",
"CostTime": 43
}
]
},
"FailCount": 0,
"SubGroupName": "GID_test",
"SuccessCount": 1
}
]
},
"Topic": "test",
"CostTime": 24,
"Tag": "TagA",
"MsgId": "0BC1F01800002A9F000000531246****",
"PubGroupName": "GID_test",
"BornHost": "30.5.**.**"
}
]
},
"QueryId": "272967562652883649157096685****"
}
}錯(cuò)誤碼
訪(fǎng)問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-03-19 | OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
控制臺(tái)操作
除了調(diào)用 OnsTraceGetResult 接口，您還可以通過(guò)云消息隊(duì)列 RocketMQ 版控制臺(tái)查看消息軌跡的查詢(xún)結(jié)果。具體操作，請(qǐng)參見(jiàn)查詢(xún)消息軌跡。