根據(jù)指定的 Message Key,查詢消息,該查詢方式屬于模糊查詢。由于業(yè)務(wù)方的 Key 可能不唯一,所以查詢結(jié)果可能為多條。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | QueryMqSofamqMessageByKey | 系統(tǒng)規(guī)定參數(shù)。取值:QueryMqSofamqMessageByKey。 |
Cell | String | 是 | RZ01A | 需查詢的消息所在的單元 |
InstanceId | String | 是 | MQ_INST_111111111111_DOxxxxxx | 需查詢的消息所對(duì)應(yīng)的實(shí)例 ID。針對(duì)有獨(dú)立命名空間的實(shí)例,該參數(shù)為必填。 |
Key | String | 是 | messageKey1 | 需查詢的消息的 Message Key |
Topic | String | 是 | test-mq_topic | 需查詢的消息的 Topic |
返回?cái)?shù)據(jù)
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
Data | Array | 查詢結(jié)果 |
|
Body | String | SGVsbG8gTVEg5raT7oWf5p6D5ai05ayt55iv | 消息體 |
BodyCrc | Long | 914112295 | 消息體 CRC 校驗(yàn)值 |
BornHost | String | 42.120.**.**:64646 | 生成該消息的客戶端實(shí)例 |
BornTimestamp | Long | 1570761026630 | 生成時(shí)間戳 |
InstanceId | String | MQ_INST_111111111111_DOxxxxxx | 實(shí)例 ID |
MsgId | String | 1E0578FE110F18B4AAC235C0C8460BA2 | 消息 ID,即 Message ID |
PropertyList | Array | 消息屬性列表 |
|
Name | String | TAGS | Key 名 |
Value | String | TagA | 值 |
ReconsumeTimes | Long | 1 | 消息重試消費(fèi)的次數(shù) |
StoreHost | String | 11.220.***.***:10911 | 存儲(chǔ)該消息的服務(wù)器實(shí)例 |
StoreSize | Long | 407 | 消息大小 |
StoreTimestamp | Long | 1570761026708 | 被服務(wù)端存儲(chǔ)的時(shí)間戳 |
Topic | String | test-mq_topic | 消息的 Topic |
RequestId | String | 861E6630-AEC0-4B2D-B214-6CB5E44B7F04 | 請(qǐng)求ID |
ResultCode | String | OK | 結(jié)果碼 |
ResultMessage | String | OK | 結(jié)果描述 |
示例
請(qǐng)求示例
http(s)://[Endpoint]/?Action=QueryMqSofamqMessageByKey
&Cell=RZ01A
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&Key=messageKey1
&Topic=test-mq_topic
&<公共請(qǐng)求參數(shù)>
正常返回示例
XML
格式
<RequestId>861E6630-AEC0-4B2D-B214-6CB5E44B7F04</RequestId>
<Data>
<BornTimestamp>1570761026630</BornTimestamp>
<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>
<Data>
<PropertyList>
<Value>TagA</Value>
<Name>TAGS</Name>
</PropertyList>
</Data>
<ResultMessage>OK</ResultMessage>
<ResultCode>OK</ResultCode>
JSON
格式
{"RequestId":"861E6630-AEC0-4B2D-B214-6CB5E44B7F04","Data":[{"BornTimestamp":"1570761026630","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"},{"PropertyList":[{"Value":"TagA","Name":"TAGS"}]}],"ResultMessage":"OK","ResultCode":"OK"}
錯(cuò)誤碼
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。