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>

返回示例：