864      群英

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

描述

該接口用於消費者查看消息，PeekMessage 與 ReceiveMessage 不同，PeekMessage 並不會改變消息的狀態，即被 PeekMessage 獲取消息後消息仍然處於 Active 狀態，仍然可被查看或消費；而後者操作成功後消息進入 Inactive ，在 VisibilityTimeout 的時間內不可被查看和消費。

Request

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

• 請求行

  GET /queues/$queueName/messages?peekonly=true HTTP/1.1

• URI參數

  peekonely=true表示這次請求隻是去查看隊列頂部的消息並不會引起消息的狀態改變

• 特有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?peekonly=true 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
    Connection:close
    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"?>
    <Message xmlns="https://mns.aliyuncs.com/doc/v1/">
        <MessageId>D6D5F7C9C12D14A4-1-14D953EFC72-200000004</MessageId>
        <MessageBodyMD5>F9360F391579E71CA77BC5D50242FCF4</MessageBodyMD5>
        <MessageBody>This is a test message</MessageBody>
        <EnqueueTime>1250700979248</EnqueueTime>
        <FirstDequeueTime>1250700979348</FirstDequeueTime >
        <DequeueCount>5</DequeueCount>
        <Priority>8<Priority>
    </Message>