View a markdown version of this page

Amazon SQS queue target - Amazon EventBridge
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Amazon SQS queue target

To deliver to an Amazon SQS queue, set TargetArn to the queue ARN, for example arn:aws:sqs:us-east-1:111122223333:large-orders, and add SqsParameters. For a FIFO queue, set MessageGroupId; the usual value is the event's group, {% $events.SystemMetadata.EventGroupId %}.

Parameters

ParameterWhat it sets
MessageGroupIdThe queue message group. Required for a FIFO queue
MessageDeduplicationIdThe queue deduplication identifier for a FIFO queue without content-based deduplication. Derive it from the event; a constant makes the queue discard every message after the first
DelaySecondsDelivery delay for the message
MessageAttributesMessage attributes to attach
MessageSystemAttributesSystem attributes, such as the Amazon X-Ray trace header

Delivery role

The role needs sqs:SendMessage on the queue. If the queue is encrypted with a customer managed key, the role also needs kms:GenerateDataKey and kms:Decrypt on that key.

Batching and payload

EventBridge calls SendMessageBatch, so one target call carries up to 10 events, and one queue message carries one event. Transformer decides the body of each message. See Batching deliveries to a target.