使用DeleteMessage接口来删除已经被消费过的消息。
Name | Value |
---|---|
API | DeleteMessage |
RAM授权操作 | mns:DeleteMessage |
资源 | acs:mns:$region:$accountid:/queues/$queueName/messages |
描述
该接口用于删除已经被消费过的消息,消费者需将上次消费后得到的ReceiptHandle作为参数来定位要删除的消息。本操作只有在NextVisibleTime
之前执行才能成功。如果过了NextVisibleTime
,消息重新变回Active状态,ReceiptHandle就会失效;删除失败,需重新消费获取新的ReceiptHandle。
Request
Request由以下几个部分组成:
- 请求行
DELETE /queues/$queueName/messages?ReceiptHandle=<receiptHandle> HTTP/1.1
-
特有URI参数
参数名称 说明 是否必选 ReceiptHandle 上次消费后返回的消息ReceiptHandle,详情请参见ReceiveMessage。 是 - 特有Request Header
无,请参见公共参数。
- Request Body
无。
Response
返回消息由返回状态行,HTTP头和消息体三部分组成:
- HTTP Status Code
HTTP/1.1 204 No Content
- 特有Response Header
无,请参见公共参数。
- Response Body
无。
示例
请求示例:
DELETE /queues/$queueName/messages?ReceiptHandle=MbZj6wDWli+QEauMZc8ZRv37sIW2iJKq3M9Mx/KSbkJ0 HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Wed, 28 May 2012 22:32:00 GMT
x-mns-version: 2015-06-06
Authorization: MNS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE
返回示例:
HTTP/1.1 204 No Content
x-mns-request-id:512B2A634403E52B1956133E
x-mns-version: 2015-06-06
Special Error
错误码 | 错误信息 | 状态码 |
---|---|---|
QueueNotExist | The queue name you provided is not exist. | 404 |
InvalidArgument | The value of Element should between Low and High seconds/bytes. | 400 |
ReceiptHandleError | The receipt handle you provide is not valid. | 400 |
在文档使用中是否遇到以下问题
更多建议
匿名提交