The SendMessage action delivers a message to the specified queue. The content of the message is specified in the MessageBody parameter and can be any alphanumeric string.
SendMessage requests are validated on the following:
MessageBody must exist and be a string of length 1 byte to 256K.
The queue specified must exist. The URL to the queue must be a URL returned by a CreateQueue or ListQueues request.
Returns Success and a string representing the ID of the message sent, which you use as the value of the MessageId parameter when performing actions on that message. This action returns an error response if unsuccessful.
| Name | Description | Type | Value |
|---|---|---|---|
MessageBody
| Required. A string representing the body of the message to send. The total string length of the message body cannot exceed 256K. | An alphanumeric string | The content of the message. The message can contain any valid string character, but must be URL-encoded so that the string does not contain any characters that would not be valid in an HTTP URL. |
The following example SendMessage request sends a message containing "Your message text" as the body of the message to the specified queue.
<soap:Body wsu:Id="body"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<m:SendMessage xmlns:m="http://queue.amazonaws.com/doc/2006-01-01/">
<m:MessageBodies>
<m:MessageBody>
Your message text
</m:MessageBody>
</m:MessageBodies>
</m:SendMessage>
</soap:Body>