880      iPhone_iPad_Mac_apple

批量发送消息__队列接口规范_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>