880      阿裏雲

批量發送消息__隊列接口規範_API使用手冊_消息服務-阿裏雲

描述

該接口用於批量發送消息到指定的隊列，一次 BatchSendMessage 最多發送16條消息。普通消息發送到隊列隨即可被消費者消費，如果生產者發送一個消息不想馬上被消費者消費（典型的使用場景為定期任務），生產者在發送消息時設置 DelaySeconds 參數就可以達到此目標。發送帶 DelaySeconds 參數值大於0的消息初始狀態為Delayed，此時消息不能被消費者消費，隻有等 DelaySeconds 時間後消息變成 Active 狀態後才可消費。發送消息時指定 DelaySeconds 參數的優先級高於延時消息隊列的 DelaySeconds 屬性，即兩個 DelaySeconds 屬性設置的值不同時以發送消息時指定的值為準。

Request

Request的構造主要由以下幾個部分組成：

• 請求行

  POST /queues/$queueName/messages HTTP/1.1

• 特有Request Header

  無，請參考 調用方式/公共參數

• Request Body

  Request Body為XML格式，其中包含多條創建Message的屬性。

Response

返回消息由返回狀態行，HTTP頭和消息體三部分組成。

• HTTP Status Code

  HTTP/1.1 201 Created

• 特有Response Header

  無，請參考 調用方式/公共參數

• Response Body

  返回的結果為XML格式，返回多條Message的MessageId和MessageBodyMD5子元素。

Special Error：

請求示例：

    POST /queues/$queueName/messages HTTP/1.1
    Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
    Date: Wed, 18 Mar 2012 12:00:00 GMT
    Content-Length:500
    Content-Type:text/xml;charset=utf-8
    x-mns-version: 2015-06-06
    Authorization: MNS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE
    <?xml version="1.0" encoding="UTF-8"?>
    <Messages xmlns="https://mns.aliyuncs.com/doc/v1/">
        <Message>
            <MessageBody>Message1 Base64 Encoded Result</MessageBody>
            <DelaySeconds>60</DelaySeconds>
            <Priority>1</Priority>
        </Message>
        <Message>
            <MessageBody>Message2 Base64 Encoded Result</MessageBody>
            <DelaySeconds>60</DelaySeconds>
            <Priority>1</Priority>
        </Message>
    </Messages>