OnsDLQMessageResendById - 重髮指定的死信訊息
重髮指定Message ID的死信訊息,使該訊息能夠被Consumer再次消費。
介面說明
死信訊息已達最大重試次數,若重發後再次消費失敗,則無效信件佇列中將增加一條 Message ID 相同的訊息,可通過控制台無效信件佇列的查詢頁面或者管控 API 查看該結果。您可通過同一 Message ID 的訊息出現次數判斷重發後依然消費失敗的次數。
由於死信訊息是經過重試邏輯依然消費失敗的訊息,通常意味著消費邏輯可能存在問題,故請先查明多次消費失敗的原因,再調用本介面重新發送。
當前訊息佇列 RocketMQ 版不管理死信重發的狀態,重發後消費成功的訊息不會從無效信件佇列中移除。需自行管理、判斷訊息是否需要重發。避免多次無意義地重發,從而造成重複消費。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
mq:ResendDLQMessage |
get |
Group
Group
|
無 |
|
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| MsgId |
string |
是 |
需查詢的訊息的 ID,即 Message ID。 |
0BC16699343051CD9F1D798E7734**** |
| GroupId |
string |
是 |
需查詢的消費端 Group ID。 |
GID_test_group_id |
| InstanceId |
string |
否 |
需查詢訊息所對應的執行個體 ID。 |
MQ_INST_188077086902****_BXSuW61e |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
公用參數,每個請求的 ID 都是唯一的,可用於排查和定位問題。 |
D94CC769-4DC3-4690-A868-9D0631B1**** |
| Data |
object |
||
| MsgId |
array |
返回的訊息列表。 |
|
|
string |
訊息 ID,即 Message ID。 |
0BC16699343051CD9F1D798E7734**** |
如果重新投遞失敗,會返回投遞失敗的 Message ID。
樣本
正常返回樣本
JSON格式
{
"RequestId": "D94CC769-4DC3-4690-A868-9D0631B1****",
"Data": {
"MsgId": [
"0BC16699343051CD9F1D798E7734****"
]
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。