全部产品
云市场

OnsDLQMessageResendById

更新时间:2019-09-13 23:06:02

使用 OnsDLQMessageResendById 通过传入 Message ID 重发指定的死信消息,使该消息能够被 Consumer 再次消费。

描述

本接口让死信消息复活,让消息能够被 Consumer 再消费一次。

死信消息已达最大重试次数,若重发后再次消费失败,则死信队列中将增加一条 Message ID 相同的消息,可通过控制台死信队列的查询页面或者管控 API 查看该结果。您可通过同一 Message ID 的消息出现次数判断重发后依然消费失败的次数。

注意:

  • 由于死信消息是经过重试逻辑依然消费失败的消息,通常意味着消费逻辑可能存在问题,故请先查明多次消费失败的原因,再调用本接口重新发送。

  • 当前消息队列 MQ 不管理死信重发的状态,重发后消费成功的消息不会从死信队列中移除。需自行管理、判断消息是否需要重发。避免多次无意义地重发,从而造成重复消费。

请求参数列表

名称 类型 是否必需 描述
PreventCache Long 用于 CSRF 校验,设置为系统当前时间即可,单位毫秒(ms)
InstanceId String 需查询消息所对应的实例 ID
MsgId String 需查询的消息的 ID,即 Message ID
GroupId String 需查询的消费端 Group ID

返回参数列表

名称 类型 描述
RequestId String 为公共参数,每个请求的 ID 都是唯一的
HelpUrl String 帮助链接
Data List 发送失败的消息的 ID,即 Message ID

使用示例

示例代码请参见管控 API 示例代码和接入点列表