本接口用于删除已经被消费过的消息,消费者需将上次消费后得到的ReceiptHandle作为参数来定位要删除的消息。本操作只有在NextVisibleTime前执行才能成功;如果过了NextVisibleTime时刻,消息重新变回Active状态,ReceiptHandle就会失效导致删除失败,需重新消费获取新的ReceiptHandle。
Request
Request的构造主要由以下几个部分组成:
- 请求行
DELETE/$queueName/messages?receiptHandle=<receiptHandle> HTTP/1.1
- 特有URI参数
参数名称 说明 选项 ReceiptHandle 上次消费后返回的消息ReceiptHandle,请参见ReceiveMessage。 Required - 特有Request Header
无,请参见公共参数。
- Request Body
无。
Response
返回消息由返回状态行,HTTP头和消息体三部分组成:
- HTTP Status Code
HTTP/1.1 204 NoContent
- 特有Response Header
无,请参见公共参数。
- Response Body
无。
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 |
- 请求示例
DELETE /$queueName/messages?receiptHandle=MbZj6wDWli+QEauMZc8ZRv37sIW2iJKq3M9Mx/KSbkJ0HTTP/1.1 Host: $AccountId.mqs-cn-hangzhou.aliyuncs.com Date: Wed, 28 May 2012 22:32:00 GMT x-mqs-version: 2014-07-08 Authorization: MQS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE
- 返回示例
HTTP/1.1 204 NoContent x-mqs-request-id:512B2A634403E52B1956133E x-mqs-version: 2015-06-06