根據 Message ID,查詢死信消息。該查詢方式屬于精確查詢。查詢條件需要的 Message ID 從消息發送成功的 SendResult 中獲取,或者從批量查詢的接口中獲取。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetMqSofamqDLQMessageById | 系統規定參數。取值:GetMqSofamqDLQMessageById。 |
Cell | String | 是 | RZ01A | 需要查詢的單元 |
GroupId | String | 是 | GID_test_group_id | 需查詢的消費端 Group ID |
InstanceId | String | 是 | MQ_INST_111111111111_DOxxxxxx | 需查詢消息所對應的實例 ID。針對有獨立命名空間的實例,該參數為必填。 |
MsgId | String | 是 | 0BC16699165C03B925DB8A404E2D**** | 需查詢的消息的 ID,即 Message ID |
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct | 查詢結果 |
|
Body | String | SGVsbG8gTVEg5raT7oWf5p6D5ai05ayt55iv | 消息體 |
BodyCrc | Long | 914112295 | 消息體 CRC 校驗值 |
BornHost | String | 42.120.**.**:64646 | 生成該消息的客戶端實例 |
BornTimestamp | Long | 1570761026630 | 生成時間戳 |
InstanceId | String | MQ_INST_111111111111_DOxxxxxx | 實例 ID |
MsgId | String | 1E0578FE110F18B4AAC235C0C8460BA2 | 消息 ID,即 Message ID |
PropertyList | Array | 消息屬性列表 |
|
Name | String | TAGS | Key 名 |
Value | String | TagA | 值 |
ReconsumeTimes | Long | 1 | 消息重試消費的次數 |
StoreHost | String | 11.220.***.***:10911 | 存儲該消息的服務器實例 |
StoreSize | Long | 407 | 消息大小 |
StoreTimestamp | Long | 1570761026708 | 被服務端存儲的時間戳 |
Topic | String | test-mq_topic | 消息的 Topic |
RequestId | String | 861E6630-AEC0-4B2D-B214-6CB5E44B7F04 | 請求ID |
ResultCode | String | OK | 結果碼 |
ResultMessage | String | OK | 結果描述 |
示例
請求示例
http(s)://[Endpoint]/?Action=GetMqSofamqDLQMessageById
&Cell=RZ01A
&GroupId=GID_test_group_id
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&MsgId=0BC16699165C03B925DB8A404E2D****
&<公共請求參數>
正常返回示例
XML
格式
<RequestId>861E6630-AEC0-4B2D-B214-6CB5E44B7F04</RequestId>
<Data>
<BornTimestamp>1570761026630</BornTimestamp>
<PropertyList>
<Value>TagA</Value>
<Name>TAGS</Name>
</PropertyList>
<InstanceId>MQ_INST_111111111111_DOxxxxxx</InstanceId>
<StoreSize>407</StoreSize>
<BornHost>42.120.**.**:64646</BornHost>
<BodyCrc>914112295</BodyCrc>
<Topic>test-mq_topic</Topic>
<Body>SGVsbG8gTVEg5raT7oWf5p6D5ai05ayt55iv</Body>
<ReconsumeTimes>1</ReconsumeTimes>
<MsgId>1E0578FE110F18B4AAC235C0C8460BA2</MsgId>
<StoreHost>11.220.***.***:10911</StoreHost>
<StoreTimestamp>1570761026708</StoreTimestamp>
</Data>
<ResultMessage>OK</ResultMessage>
<ResultCode>OK</ResultCode>
JSON
格式
{"RequestId":"861E6630-AEC0-4B2D-B214-6CB5E44B7F04","Data":{"BornTimestamp":"1570761026630","PropertyList":[{"Value":"TagA","Name":"TAGS"}],"InstanceId":"MQ_INST_111111111111_DOxxxxxx","StoreSize":"407","BornHost":"42.120.**.**:64646","BodyCrc":"914112295","Topic":"test-mq_topic","Body":"SGVsbG8gTVEg5raT7oWf5p6D5ai05ayt55iv","ReconsumeTimes":"1","MsgId":"1E0578FE110F18B4AAC235C0C8460BA2","StoreHost":"11.220.***.***:10911","StoreTimestamp":"1570761026708"},"ResultMessage":"OK","ResultCode":"OK"}
錯誤碼
訪問錯誤中心查看更多錯誤碼。