最近更新时间:2024.03.06 16:49:23
首次发布时间:2023.07.12 16:22:34
调用 QueryDLQMessageByGroupId 接口根据时间范围查询指定 Group 的死信消息。
请求频率:该接口请求频率限制为 100 次/秒;单用户请求频率限制为 20 次/秒。
此接口用于指定时间范围的死信消息查询,即根据 Group ID 和死信消息产生的时间范围,查询该 Group ID 在某段时间内产生的所有死信消息。按时间范围查询时,会筛选出符合条件的消息列表,查询到的死信消息可能较多。
参数 | 参数类型 | 是否必选 | 示例值 | 说明 |
---|---|---|---|---|
InstanceId | String | 是 | rocketmq-cnai1f0c29ca**** | 实例 ID。 |
GroupId | String | 是 | GID_test | 死信队列对应的的 Group ID。
|
QueryStartTimestamp | String | 是 | 1661320625 | 消息存储时间中的起始时间戳,单位为秒。 |
QueryEndTimestamp | String | 是 | 1661320682 | 消息存储时间中的结束时间戳,单位为秒。 |
PageNumber | Integer | 是 | 1 | 列表的页码,最小值为 1。其中列表中每一页的条目数量固定为 16。 |
参数 | 参数类型 | 示例值 | 说明 |
---|---|---|---|
DLQMessageList | Array of BasicDLQMessageInfoObject | / | 符合查询条件的消息列表。详细信息请参考BasicDLQMessageInfoObject。 |
HasMoreMessage | Bool | true | 是否还有更多页的消息。此值为 true 时,您可以再次调用此接口,翻页查询更多消息。
|
POST /?Action=QueryDLQMessageByGroupId&Version=2023-01-01 HTTP/1.1 Content-Type: application/json Host: rocketmq.volcengineapi.com X-Date: 20210328T100802Z Authorization: HMAC-SHA256 Credential=AK********/20210328/cn-shanghai/rocketmq/request, SignedHeaders=x-date, Signature=******** { "InstanceId": "rocketmq-cnai81fd122a****", "GroupId": "test", "PageNumber": 1, "QueryStartTimestamp": "1683784892", "QueryEndTimestamp": "1683784894" }
{ "ResponseMetadata": { "RequestId": "202305111610394335E858B3A3508D5F6E", "Action": "QueryDLQMessageByGroupId", "Version": "2023-01-01", "Service": "RocketMQ", "Region": "cn-shanghai" }, "Result": { "DLQMessageList": [ { "CreateTimestamp": 1683784885, "IsExist": true, "MessageId": "FDBD0FF1CE00003A0000000000000EFE425C18B4AAC23681F242****", "MessageKey": "", "MessageSize": 143516, "ProducerHost": "100.xx.xx.xx:xxxxx", "ReconsumeTimes": 1, "StoreTimestamp": 1683784893, "Tag": "" }, { "CreateTimestamp": 1683784884, "IsExist": true, "MessageId": "FDBD0FF1CE00003A0000000000000EFE425C18B4AAC23681EE4F****", "MessageKey": "", "MessageSize": 47276, "ProducerHost": "100.xx.xx.xx:xxxxx", "ReconsumeTimes": 1, "StoreTimestamp": 1683784893, "Tag": "" } ], "HasMoreMessage": false } }