SendMessage

Description

The SendMessage action delivers a message to the specified queue. The maximum allowed message size is 8 KB.

	Important
The following list shows the characters (in Unicode) allowed in your message, according to the W3C XML specification (for more information, go to http://www.w3.org/TR/REC-xml/#charsets). If you send any characters not included in the list, your request will be rejected. #x9 \| #xA \| #xD \| [#x20 to #xD7FF] \| [#xE000 to #xFFFD] \| [#x10000 to #x10FFFF]

Important

The following list shows the characters (in Unicode) allowed in your message, according to the W3C XML specification (for more information, go to http://www.w3.org/TR/REC-xml/#charsets). If you send any characters not included in the list, your request will be rejected.

#x9 | #xA | #xD | [#x20 to #xD7FF] | [#xE000 to #xFFFD] | [#x10000 to #x10FFFF]

Request Parameters

The following table lists the special request parameters the SendMessage action uses in addition to the common request parameters all actions use (for more information, see Request Parameters Common to All Actions).

Name Description Required

Name	Description	Required
`MessageBody`	The message to send. Type: String maximum 8 KB in size. For a list of allowed characters, see the preceding important note.	Yes

MessageBody

The message to send.

Type: String maximum 8 KB in size. For a list of allowed characters, see the preceding important note.

Yes

Response Elements

The following table lists the response elements the SendMessage action returns in addition to the common response elements all actions return (for more information, see Responses section in the Amazon SQS Developer Guide.

Name Description

Name	Description
`MD5OfMessageBody`	An MD5 digest of the non-URL-encoded message body string. You can use this to verify that SQS received the message correctly. SQS first URL decodes the message before creating the MD5 digest. For information about MD5, go to http://faqs.org/rfcs/rfc1321.html. Type: String Ancestor: `SendMessageResult`
`MessageId`	An element containing the message ID of the message sent to the queue. For more information, see Queue and Message Identifiers in the Amazon SQS Developer Guide. Type: String Ancestor: `SendMessageResult`

MD5OfMessageBody

An MD5 digest of the non-URL-encoded message body string. You can use this to verify that SQS received the message correctly. SQS first URL decodes the message before creating the MD5 digest. For information about MD5, go to http://faqs.org/rfcs/rfc1321.html.

Type: String

Ancestor: SendMessageResult

MessageId

An element containing the message ID of the message sent to the queue. For more information, see Queue and Message Identifiers in the Amazon SQS Developer Guide.

Type: String

Ancestor: SendMessageResult

Special Errors

The following table lists the special errors the SendMessage action returns in addition to the common errors all actions return (for more information, see Errors Common to all Actions).

Error	Description	HTTP Status Code
`InvalidMessageContents`	The message contains characters outside the allowed set.	400
`MessageTooLong`	The message size cannot exceed 8 KB.	400

Examples

Sample Request

The following example SendMessage request sends a message containing "Your Message Text" to the queue. You must URL encode the entire URL; however, we've URL encoded only the message body to make the example easier for you to read.

http://queue.amazonaws.com/123456789012/testQueue/
?Action=SendMessage
&MessageBody=This+is+a+test+message
&Version=2009-02-01
&SignatureMethod=HmacSHA256
&Expires=2009-04-18T22%3A52%3A43PST
&AWSAccessKeyId=0GS7553JW74RRM612K02EXAMPLE
&SignatureVersion=2
&Signature=Dqlp3Sd6ljTUA9Uf6SGtEExwUQEXAMPLE

Sample Response

The following example response includes the MD5 digest for Your Message Text.

<SendMessageResponse>
    <SendMessageResult>
        <MD5OfMessageBody>
            fafb00f5732ab283681e124bf8747ed1
        </MD5OfMessageBody>
        <MessageId>
            5fea7756-0ea4-451a-a703-a558b933e274
        </MessageId>
    </SendMessageResult>
    <ResponseMetadata>
        <RequestId>
            27daac76-34dd-47df-bd01-1f6e873584a0
        </RequestId>
    </ResponseMetadata>
</SendMessageResponse>