接口描述
本接口(DeleteMessage)用于删除已经被消费过的消息,消费者需将上次消费后得到的 ReceiptHandle 作为参数来定位要删除的消息。
本操作只有在 NextVisibleTime 之前执行才能成功;如果过了 NextVisibleTime,消息重新变回 Active 状态,ReceiptHandle 就会失效,删除失败,需重新消费获取新的 ReceiptHandle。并发消费时,如果消息被其中一个消费者删除了,其他的消费者再也无法获取得到被删除的消息。
公网地址:
https://cmq-gz.publicXXX.tencenttdmq.com
内网地址:
http://gz.mqadapter.cmq.tencentyun.com
注意:
不同地域的 API 调用地址 URL 会有所变化。
任何时候(包括内测期间),如果使用外网域名产生公网下行流量,都会收取流量费用。 所以强烈建议服务在腾讯云上的用户使用内网域名,内网不会产生流量费用。
输入参数
参数名称 | 是否必选 | 类型 | 描述 |
queueName | 是 | String | 队列名字,在单个地域同一账号下唯一。 队列名称是一个不超过64个字符的字符串,必须以字母为首字符,剩余部分可以包含字母、数字和横划线(-)。 |
receiptHandle | 是 | String | 上次消费返回唯一的消息句柄,用于删除消息。 |
输出参数
参数名称 | 类型 | 描述 |
code | Int | |
message | String | 错误提示信息。 |
requestId | String | 服务器生成的请求 ID。出现服务器内部错误时,用户可提交此 ID 给后台定位问题。 |
错误码
示例
输入:
https://domain/v2/index.php?Action=DeleteMessage &queueName=test-queue-123 &receiptHandle=3423452345 &<公共请求参数>
输出:
{"code" : 0,"message" : "","requestId":"14534664555"}