更新时间:2026-04-03 GMT+08:00

重发死信消息

功能介绍

重发死信消息。

URI

POST /v2/{engine}/{project_id}/instances/{instance_id}/messages/deadletter-resend

表1 路径参数

参数

是否必选

参数类型

描述

engine

String

参数解释

消息引擎。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

project_id

String

参数解释

项目ID,获取方式请参见获取项目ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

reliability。

instance_id

String

参数解释

实例ID。获取方法如下:调用“查询所有实例列表”接口,从响应体中获取实例ID。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

topic

String

参数解释

Topic名称。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

msg_id_list

Array of strings

参数解释

消息列表。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

resend_results

Array of resend_results objects

参数解释

重发死信消息结果。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

表4 resend_results

参数

参数类型

描述

msg_id

String

参数解释

消息ID。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

error_code

String

参数解释

错误码。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

error_message

String

参数解释

错误信息。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求示例

重发死信消息。

POST https://{endpoint}/v2/{engine}/{project_id}/instances/{instance_id}/messages/deadletter-resend

{
  "topic" : "%DLQ%group1",
  "msg_id_list" : [ "id1" ]
}

响应示例

状态码:200

重发死信消息成功。

{
  "resend_results" : [ {
    "msg_id" : "C0A8149E0000277600000000000B6835",
    "error_code" : "DMS.00000000",
    "error_message" : "Success."
  } ]
}

状态码

状态码

描述

200

重发死信消息成功。

错误码

请参见错误码