863      阿裏雲

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

描述

該接口用於消費者批量隊列的消息，一次 BatchReceiveMessage 操作最多可以獲取16條消息。該操作會將取得的消息狀態變成 Inactive，Inactive 的時間長度由 Queue 屬性 VisibilityTimeout 指定（詳見 CreateQueue 接口）。消費者在 VisibilityTimeout 時間內消費成功後需要調用 DeleteMessage 接口刪除取得的消息，否則取得的消息將會被重新置為 Active，又可被消費者重新消費。

Request

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

• 請求行

  GET /queues/$queueName/messages?numOfMessages=16&waitseconds=10 HTTP/1.1

• 特有URI參數

說明:

① 如果BatchReceiveMessage請求附帶waitseconds參數,在 Queue 無消息時,此次 BatchReceiveMessage 請求進入到 Polling，等待時長為 waitseconds；如果未設置 waitseconds，則默認使用所屬 Queue 的 PollingWaitSeconds 屬性(參見 CreateQueue 接口)。

• 特有Request Header

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

• Request Body

  無

Response

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

• HTTP Status Code

  HTTP/1.1 200 OK

• 特有Response Header

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

• Response Body

  返回的結果為XML格式，返回多條Message消息正文及消息屬性。

Special Error

請求示例：

    GET  /queues/$queueName/messages?numOfMessages=16 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

返回示例：

    HTTP/1.1 200 OK
    Content-Type=text/xml;charset=utf-8
    Content-Length:500
    x-mns-request-id:512B2A634403E52B1956133E
    x-mns-version: 2015-06-06
    <?xml version="1.0" encoding="UTF-8"?>
    <Messages xmlns="https://mns.aliyuncs.com/doc/v1/">
    <Message>
        <MessageId>5F290C926D472878-2-14D9529A8FA-200000001</MessageId>
        <ReceiptHandle>1-ODU4OTkzNDU5My0xNDMyNzI3ODI3LTItOA==</ReceiptHandle>
        <MessageBodyMD5>C5DD56A39F5F7BB8B3337C6D11B6D8C7</MessageBodyMD5>
        <MessageBody>This is a test message</MessageBody>
        <EnqueueTime>1250700979248</EnqueueTime>
        <NextVisibleTime>1250700799348</NextVisibleTime>
        <FirstDequeueTime>1250700779318</FirstDequeueTime >
        <DequeueCount>1</DequeueCount>
        <Priority>8</Priority>
    </Message>
    <Message>
        <ReceiptHandle>1-ODU4OTkzNDU5My0xNDMyNzI3MjQwLTEtOA==</ReceiptHandle>
        <MessageBodyMD5>C5DD56A39F5F7BB8B3337C6D11B6D8C7</MessageBodyMD5>
        <MessageBody>This is a test message</MessageBody>
        <EnqueueTime>1250700979252</EnqueueTime>
        <NextVisibleTime>1250700799350</NextVisibleTime>
        <FirstDequeueTime>1250700779330</FirstDequeueTime >
        <DequeueCount>1</DequeueCount>
        <Priority>8</Priority>
    </Message>
    </Messages>