本接口用于删除已经被消费过的消息，消费者需将上次消费后得到的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