amazonka-sqs-1.4.0: Amazon Simple Queue Service SDK.

Copyright(c) 2013-2016 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.SQS.Types

Contents

Description

 

Synopsis

Service Configuration

sqs :: Service Source

API version '2012-11-05' of the Amazon Simple Queue Service SDK configuration.

Errors

_InvalidBatchEntryId :: AsError a => Getting (First ServiceError) a ServiceError Source

The Id of a batch entry in a batch request does not abide by the specification.

_TooManyEntriesInBatchRequest :: AsError a => Getting (First ServiceError) a ServiceError Source

Batch request contains more number of entries than permissible.

_QueueDeletedRecently :: AsError a => Getting (First ServiceError) a ServiceError Source

You must wait 60 seconds after deleting a queue before you can create another with the same name.

_QueueDoesNotExist :: AsError a => Getting (First ServiceError) a ServiceError Source

The queue referred to does not exist.

_InvalidAttributeName :: AsError a => Getting (First ServiceError) a ServiceError Source

The attribute referred to does not exist.

_UnsupportedOperation :: AsError a => Getting (First ServiceError) a ServiceError Source

Error code 400. Unsupported operation.

_InvalidMessageContents :: AsError a => Getting (First ServiceError) a ServiceError Source

The message contains characters outside the allowed set.

_BatchRequestTooLong :: AsError a => Getting (First ServiceError) a ServiceError Source

The length of all the messages put together is more than the limit.

_OverLimit :: AsError a => Getting (First ServiceError) a ServiceError Source

The action that you requested would violate a limit. For example, ReceiveMessage returns this error if the maximum number of messages inflight has already been reached. AddPermission returns this error if the maximum number of permissions for the queue has already been reached.

_QueueNameExists :: AsError a => Getting (First ServiceError) a ServiceError Source

A queue already exists with this name. Amazon SQS returns this error only if the request includes attributes whose values differ from those of the existing queue.

_PurgeQueueInProgress :: AsError a => Getting (First ServiceError) a ServiceError Source

Indicates that the specified queue previously received a PurgeQueue request within the last 60 seconds, the time it can take to delete the messages in the queue.

_InvalidIdFormat :: AsError a => Getting (First ServiceError) a ServiceError Source

The receipt handle is not valid for the current version.

_ReceiptHandleIsInvalid :: AsError a => Getting (First ServiceError) a ServiceError Source

The receipt handle provided is not valid.

_EmptyBatchRequest :: AsError a => Getting (First ServiceError) a ServiceError Source

Batch request does not contain an entry.

_BatchEntryIdsNotDistinct :: AsError a => Getting (First ServiceError) a ServiceError Source

Two or more batch entries have the same Id in the request.

_MessageNotInflight :: AsError a => Getting (First ServiceError) a ServiceError Source

The message referred to is not in flight.

MessageAttribute

data MessageAttribute Source

Constructors

All 
ApproximateFirstReceiveTimestamp 
ApproximateReceiveCount 
SenderId 
SentTimestamp 

Instances

QueueAttributeName

data QueueAttributeName Source

Constructors

ApproximateNumberOfMessages 
ApproximateNumberOfMessagesDelayed 
ApproximateNumberOfMessagesNotVisible 
CreatedTimestamp 
DelaySeconds 
LastModifiedTimestamp 
MaximumMessageSize 
MessageRetentionPeriod 
Policy 
QueueARN 
ReceiveMessageWaitTimeSeconds 
RedrivePolicy 
VisibilityTimeout 

Instances

BatchResultErrorEntry

data BatchResultErrorEntry Source

This is used in the responses of batch API to give a detailed description of the result of an action on each entry in the request.

See: batchResultErrorEntry smart constructor.

Instances

batchResultErrorEntry Source

Arguments

:: Text

breeId

-> Bool

breeSenderFault

-> Text

breeCode

-> BatchResultErrorEntry 

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

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

breeMessage :: Lens' BatchResultErrorEntry (Maybe Text) Source

A message explaining why the action failed on this entry.

breeId :: Lens' BatchResultErrorEntry Text Source

The id of an entry in a batch request.

breeSenderFault :: Lens' BatchResultErrorEntry Bool Source

Whether the error happened due to the sender's fault.

breeCode :: Lens' BatchResultErrorEntry Text Source

An error code representing why the action failed on this entry.

ChangeMessageVisibilityBatchRequestEntry

data ChangeMessageVisibilityBatchRequestEntry Source

Encloses a receipt handle and an entry id for each message in ChangeMessageVisibilityBatch.

All of the following parameters are list parameters that must be prefixed with n, where n is an integer value starting with 1. For example, a parameter list for this action might look like this:

'&ChangeMessageVisibilityBatchRequestEntry.1.Id=change_visibility_msg_2'

'&ChangeMessageVisibilityBatchRequestEntry.1.ReceiptHandle=Your_Receipt_Handle'

'&ChangeMessageVisibilityBatchRequestEntry.1.VisibilityTimeout=45'

See: changeMessageVisibilityBatchRequestEntry smart constructor.

Instances

changeMessageVisibilityBatchRequestEntry Source

Arguments

:: Text

cId

-> Text

cReceiptHandle

-> ChangeMessageVisibilityBatchRequestEntry 

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

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

cVisibilityTimeout :: Lens' ChangeMessageVisibilityBatchRequestEntry (Maybe Int) Source

The new value (in seconds) for the message's visibility timeout.

cId :: Lens' ChangeMessageVisibilityBatchRequestEntry Text Source

An identifier for this particular receipt handle. This is used to communicate the result. Note that the Ids of a batch request need to be unique within the request.

cReceiptHandle :: Lens' ChangeMessageVisibilityBatchRequestEntry Text Source

A receipt handle.

ChangeMessageVisibilityBatchResultEntry

data ChangeMessageVisibilityBatchResultEntry Source

Encloses the id of an entry in ChangeMessageVisibilityBatch.

See: changeMessageVisibilityBatchResultEntry smart constructor.

Instances

changeMessageVisibilityBatchResultEntry Source

Arguments

:: Text

cmvbreId

-> ChangeMessageVisibilityBatchResultEntry 

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

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

cmvbreId :: Lens' ChangeMessageVisibilityBatchResultEntry Text Source

Represents a message whose visibility timeout has been changed successfully.

DeleteMessageBatchRequestEntry

data DeleteMessageBatchRequestEntry Source

Encloses a receipt handle and an identifier for it.

See: deleteMessageBatchRequestEntry smart constructor.

Instances

deleteMessageBatchRequestEntry Source

Arguments

:: Text

dmbreId

-> Text

dmbreReceiptHandle

-> DeleteMessageBatchRequestEntry 

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

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

dmbreId :: Lens' DeleteMessageBatchRequestEntry Text Source

An identifier for this particular receipt handle. This is used to communicate the result. Note that the Ids of a batch request need to be unique within the request.

dmbreReceiptHandle :: Lens' DeleteMessageBatchRequestEntry Text Source

A receipt handle.

DeleteMessageBatchResultEntry

data DeleteMessageBatchResultEntry Source

Encloses the id an entry in DeleteMessageBatch.

See: deleteMessageBatchResultEntry smart constructor.

Instances

deleteMessageBatchResultEntry Source

Arguments

:: Text

dId

-> DeleteMessageBatchResultEntry 

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

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

dId :: Lens' DeleteMessageBatchResultEntry Text Source

Represents a successfully deleted message.

Message

data Message Source

An Amazon SQS message.

See: message smart constructor.

Instances

message :: Message Source

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

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

mMessageAttributes :: Lens' Message (HashMap Text MessageAttributeValue) Source

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

mMD5OfBody :: Lens' Message (Maybe Text) Source

An MD5 digest of the non-URL-encoded message body string.

mBody :: Lens' Message (Maybe Text) Source

The message's contents (not URL-encoded).

mAttributes :: Lens' Message (HashMap MessageAttribute Text) Source

SenderId, SentTimestamp, ApproximateReceiveCount, and/or ApproximateFirstReceiveTimestamp. SentTimestamp and ApproximateFirstReceiveTimestamp are each returned as an integer representing the epoch time in milliseconds.

mReceiptHandle :: Lens' Message (Maybe Text) Source

An identifier associated with the act of receiving the message. A new receipt handle is returned every time you receive a message. When deleting a message, you provide the last received receipt handle to delete the message.

mMessageId :: Lens' Message (Maybe Text) Source

A unique identifier for the message. Message IDs are considered unique across all AWS accounts for an extended period of time.

mMD5OfMessageAttributes :: Lens' Message (Maybe Text) Source

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.

MessageAttributeValue

data MessageAttributeValue Source

The user-specified message attribute value. For string data types, the value attribute has the same restrictions on the content as the message body. For more information, see SendMessage.

Name, type, and value must not be empty or null. In addition, the message body should not be empty or null. All parts of the message attribute, including name, type, and value, are included in the message size restriction, which is currently 256 KB (262,144 bytes).

See: messageAttributeValue smart constructor.

Instances

messageAttributeValue Source

Arguments

:: Text

mavDataType

-> MessageAttributeValue 

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

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

mavBinaryValue :: Lens' MessageAttributeValue (Maybe ByteString) Source

Binary type attributes can store any binary data, for example, compressed data, encrypted data, or images.

Note: This Lens automatically encodes and decodes Base64 data, despite what the AWS documentation might say. The underlying isomorphism will encode to Base64 representation during serialisation, and decode from Base64 representation during deserialisation. This Lens accepts and returns only raw unencoded data.

mavStringListValues :: Lens' MessageAttributeValue [Text] Source

Not implemented. Reserved for future use.

mavStringValue :: Lens' MessageAttributeValue (Maybe Text) Source

Strings are Unicode with UTF8 binary encoding. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.

mavBinaryListValues :: Lens' MessageAttributeValue [ByteString] Source

Not implemented. Reserved for future use.

mavDataType :: Lens' MessageAttributeValue Text Source

Amazon SQS supports the following logical data types: String, Number, and Binary. In addition, you can append your own custom labels. For more information, see Message Attribute Data Types.

SendMessageBatchRequestEntry

data SendMessageBatchRequestEntry Source

Contains the details of a single Amazon SQS message along with a Id.

See: sendMessageBatchRequestEntry smart constructor.

Instances

sendMessageBatchRequestEntry Source

Arguments

:: Text

sId

-> Text

sMessageBody

-> SendMessageBatchRequestEntry 

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

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

sMessageAttributes :: Lens' SendMessageBatchRequestEntry (HashMap Text MessageAttributeValue) Source

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

sDelaySeconds :: Lens' SendMessageBatchRequestEntry (Maybe Int) Source

The number of seconds for which the message has to be delayed.

sId :: Lens' SendMessageBatchRequestEntry Text Source

An identifier for the message in this batch. This is used to communicate the result. Note that the Ids of a batch request need to be unique within the request.

sMessageBody :: Lens' SendMessageBatchRequestEntry Text Source

Body of the message.

SendMessageBatchResultEntry

data SendMessageBatchResultEntry Source

Encloses a message ID for successfully enqueued message of a SendMessageBatch.

See: sendMessageBatchResultEntry smart constructor.

Instances

sendMessageBatchResultEntry Source

Arguments

:: Text

smbreId

-> Text

smbreMessageId

-> Text

smbreMD5OfMessageBody

-> SendMessageBatchResultEntry 

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

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

smbreMD5OfMessageAttributes :: Lens' SendMessageBatchResultEntry (Maybe Text) Source

An MD5 digest of the non-URL-encoded message attribute string. This can be used to verify that Amazon SQS received the message batch 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.

smbreId :: Lens' SendMessageBatchResultEntry Text Source

An identifier for the message in this batch.

smbreMessageId :: Lens' SendMessageBatchResultEntry Text Source

An identifier for the message.

smbreMD5OfMessageBody :: Lens' SendMessageBatchResultEntry Text Source

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.