832      阿里云

批量删除消息__队列接口规范_API使用手册_消息服务-阿里云

描述

该接口用于批量删除队列多条消息，最多可以删除16条消息，每条消息需要传入相应的ReceiptHandle。建议此接口与 BatchReceiveMessage 搭配使用，效率会更高。批量操作的结果可能同时包含成功和失败的子请求。只有全部子请求都成功时，HTTP状态码才是204。当部分失败发生时，用户需检查响应中每个消息的错误信息。

Request

Request的构造主要由以下几个部分组成：

• 请求行

  DELETE /queues/$queueName/messages HTTP/1.1

• 特有Request Header

  无，请参考 调用方式/公共参数

• Request Body

  Request Body为 XML 格式，其中包含多条消息的 ReceiptHandle。

Response

返回消息由返回状态行，HTTP头和消息体三部分组成。

• HTTP Status Code

  HTTP/1.1 204 NoContent

• 特有Response Header

  无，请参考 调用方式/公共参数

• Response Body

  无

Special Error

请求示例：

    DELETE  /queues/$queueName/messages 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
    <?xml version="1.0" encoding="UTF-8"?>
    <ReceiptHandles xmlns="https://mns.aliyuncs.com/doc/v1/">
        <ReceiptHandle>1-ODU4OTkzNDU5My0xNDM1MTk3NjAwLTItNg==</ReceiptHandle>
        <ReceiptHandle>1-ODU4OTkzNDU5NC0xNDM1MTk3NjAwLTItNg==</ReceiptHandle>
        <ReceiptHandle>1-ODU4OTkzNDU5NS0xNDM1MTk3NjAwLTItNg==</ReceiptHandle>
    </ReceiptHandles>

返回示例：