Network.AWS.SQS.SendMessage

Delivers a message to the specified queue. With Amazon SQS, you now have the ability to send large payload messages that are up to 256KB (262,144 bytes) in size. To send large payloads, you must use an AWS SDK that supports SigV4 signing. To verify whether SigV4 is supported for an AWS SDK, check the SDK release notes.

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.

xA | x20 to xE000 to x10000 to #x10FFFF]

Creating a Request

sendMessage

Arguments

:: Text

smQueueURL

-> Text

smMessageBody

-> SendMessage

Creates a value of SendMessage with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• smMessageAttributes
• smDelaySeconds
• smQueueURL
• smMessageBody

data SendMessage

See: sendMessage smart constructor.

Instances

Eq SendMessage

Methods

(==) :: SendMessage -> SendMessage -> Bool

(/=) :: SendMessage -> SendMessage -> Bool

Data SendMessage

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> SendMessage -> c SendMessage

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c SendMessage

toConstr :: SendMessage -> Constr

dataTypeOf :: SendMessage -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c SendMessage)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c SendMessage)

gmapT :: (forall b. Data b => b -> b) -> SendMessage -> SendMessage

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> SendMessage -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> SendMessage -> r

gmapQ :: (forall d. Data d => d -> u) -> SendMessage -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> SendMessage -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> SendMessage -> m SendMessage

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> SendMessage -> m SendMessage

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> SendMessage -> m SendMessage

Read SendMessage

Methods

readsPrec :: Int -> ReadS SendMessage

readList :: ReadS [SendMessage]

readPrec :: ReadPrec SendMessage

readListPrec :: ReadPrec [SendMessage]

Show SendMessage

Methods

showsPrec :: Int -> SendMessage -> ShowS

show :: SendMessage -> String

showList :: [SendMessage] -> ShowS

Generic SendMessage

Associated Types

type Rep SendMessage :: * -> *

Methods

from :: SendMessage -> Rep SendMessage x

to :: Rep SendMessage x -> SendMessage

Hashable SendMessage

Methods

hashWithSalt :: Int -> SendMessage -> Int

hash :: SendMessage -> Int

NFData SendMessage

Methods

rnf :: SendMessage -> ()

AWSRequest SendMessage

Associated Types

type Rs SendMessage :: *

Methods

request :: SendMessage -> Request SendMessage

response :: MonadResource m => Logger -> Service -> Proxy * SendMessage -> ClientResponse -> m (Response SendMessage)

ToQuery SendMessage

Methods

toQuery :: SendMessage -> QueryString

ToPath SendMessage

Methods

toPath :: SendMessage -> ByteString

ToHeaders SendMessage

Methods

toHeaders :: SendMessage -> [Header]

type Rep SendMessage

type Rep SendMessage = D1 (MetaData "SendMessage" "Network.AWS.SQS.SendMessage" "amazonka-sqs-1.4.3-EAMo5disTZNCNkt77bXGB0" False) (C1 (MetaCons "SendMessage'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_smMessageAttributes") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe (Map Text MessageAttributeValue)))) (S1 (MetaSel (Just Symbol "_smDelaySeconds") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int)))) ((:*:) (S1 (MetaSel (Just Symbol "_smQueueURL") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) (S1 (MetaSel (Just Symbol "_smMessageBody") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))))

type Rs SendMessage

type Rs SendMessage = SendMessageResponse

Request Lenses

smMessageAttributes :: Lens' SendMessage (HashMap Text MessageAttributeValue)

Each message attribute consists of a Name, Type, and Value. For more information, see Message Attribute Items.

smDelaySeconds :: Lens' SendMessage (Maybe Int)

The number of seconds (0 to 900 - 15 minutes) to delay a specific message. Messages with a positive DelaySeconds value become available for processing after the delay time is finished. If you don't specify a value, the default value for the queue applies.

smQueueURL :: Lens' SendMessage Text

The URL of the Amazon SQS queue to take action on.

smMessageBody :: Lens' SendMessage Text

The message to send. String maximum 256 KB in size. For a list of allowed characters, see the preceding important note.

Destructuring the Response

sendMessageResponse

Arguments

:: Int

smrsResponseStatus

-> SendMessageResponse

Creates a value of SendMessageResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• smrsMessageId
• smrsMD5OfMessageBody
• smrsMD5OfMessageAttributes
• smrsResponseStatus

data SendMessageResponse

The MD5OfMessageBody and MessageId elements.

See: sendMessageResponse smart constructor.

Instances

Eq SendMessageResponse

Methods

(==) :: SendMessageResponse -> SendMessageResponse -> Bool

(/=) :: SendMessageResponse -> SendMessageResponse -> Bool

Data SendMessageResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> SendMessageResponse -> c SendMessageResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c SendMessageResponse

toConstr :: SendMessageResponse -> Constr

dataTypeOf :: SendMessageResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c SendMessageResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c SendMessageResponse)

gmapT :: (forall b. Data b => b -> b) -> SendMessageResponse -> SendMessageResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> SendMessageResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> SendMessageResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> SendMessageResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> SendMessageResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> SendMessageResponse -> m SendMessageResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> SendMessageResponse -> m SendMessageResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> SendMessageResponse -> m SendMessageResponse

Read SendMessageResponse

Methods

readsPrec :: Int -> ReadS SendMessageResponse

readList :: ReadS [SendMessageResponse]

readPrec :: ReadPrec SendMessageResponse

readListPrec :: ReadPrec [SendMessageResponse]

Show SendMessageResponse

Methods

showsPrec :: Int -> SendMessageResponse -> ShowS

show :: SendMessageResponse -> String

showList :: [SendMessageResponse] -> ShowS

Generic SendMessageResponse

Associated Types

type Rep SendMessageResponse :: * -> *

Methods

from :: SendMessageResponse -> Rep SendMessageResponse x

to :: Rep SendMessageResponse x -> SendMessageResponse

NFData SendMessageResponse

Methods

rnf :: SendMessageResponse -> ()

type Rep SendMessageResponse

type Rep SendMessageResponse = D1 (MetaData "SendMessageResponse" "Network.AWS.SQS.SendMessage" "amazonka-sqs-1.4.3-EAMo5disTZNCNkt77bXGB0" False) (C1 (MetaCons "SendMessageResponse'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_smrsMessageId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_smrsMD5OfMessageBody") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) ((:*:) (S1 (MetaSel (Just Symbol "_smrsMD5OfMessageAttributes") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_smrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))))

Response Lenses

smrsMessageId :: Lens' SendMessageResponse (Maybe Text)

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.

smrsMD5OfMessageBody :: Lens' SendMessageResponse (Maybe Text)

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

smrsMD5OfMessageAttributes :: Lens' SendMessageResponse (Maybe Text)

An MD5 digest of the non-URL-encoded message attribute string. This can be used to verify that Amazon SQS received the message correctly. Amazon SQS first URL decodes the message before creating the MD5 digest. For information about MD5, go to http://www.faqs.org/rfcs/rfc1321.html.

smrsResponseStatus :: Lens' SendMessageResponse Int

The response status code.