A GET on the Message endpoint returns a preview of the specified message. The message is returned regardless of the visibility timeout state on the queue. The visibility state is not modified when this action is called, therefore this action does not affect which messages are returned by a subsequent GET on MessageQueue request. See SetVisibilityTimeout for more information.
GET requests on a message are validated on the following:
The message specified must exist. The URL to the message must have been returned by a PUT or GET request on a MessageQueue.
Returns Success, the message body, and the message ID of the message specified if successful. It returns an error response if unsuccessful.
| Name | Description | Type | Value |
|---|---|---|---|
MessageId | Required. The message ID of the message to return. | String. | 17VXQHSGX0SG4ZEPPK7R%7C0QE42ST4KW7RK9HSY074%7C0Z4AN912X0H2EP8BV6XJ |
The following example of a GET action on a Message returns the message specified by the message ID.
GET /QueueURL/MessageId HTTP/1.1 Host: queue.amazonaws.com Authorization: [AWS authentication string] AWS-Version: 2006-04-01 Content-Type: text/plain Date: Wed, 05 Apr 2006 21:12:00 GMT
See PeekMessage (Query) for sample response information.