--- title: Amazon AWS SQS slug: connectors/amazon-aws-sqs docTags: createdAt: 2026-06-09T16:30:24.645Z --- Amazon AWS SQS is a fully managed message queuing service that facilitates communication between distributed application components. Amazon Simple Queue Service (SQS) is a fully managed message queuing service that enables you to decouple and scale microservices, distributed systems, and serverless applications. The Amazon AWS SQS connector allows Swimlane Turbine users to automate the management of SQS queues and messages within their security workflows. By integrating with Amazon AWS SQS, users can efficiently create and configure queues, send messages, and manage queue attributes, enhancing the automation and scalability of their security operations. ## Prerequisites Before you can use the Amazon AWS SQS connector for Turbine, you'll need access to the AWS API. This requires the following: - AWS authentication using the following parameters: - Access Key ID: Your unique identifier for accessing AWS services. - Secret Key: The secret key associated with your AWS account for secure access. - Region Name: The specific AWS region where your SQS resources are located. ## Getting Started Before you begin, ensure you meet the following prerequisites: - You must have valid AWS access credentials (Access Key ID and Secret Access Key) associated with your AWS account. - You must have a valid Role ARN (Amazon Resource Name) which your user can assume. - You need to know the AWS region where your SQS queue is located. ## Capabilities This connector has the following capabilities: - Create Queue - Send Message - Set Queue Attributes ## Key Features The Amazon SQS Connector offers a robust capability aimed at improving the efficiency of your messaging operations: 1. **Send Message to Queue:** Allows you to send a message to a specific SQS queue. This requires the URL of the SQS queue and the message body as inputs. You may optionally specify additional attributes such as delay seconds, message attributes, or message system attributes. Please note that your ability to use this feature effectively may depend on the permissions and access rights tied to your AWS account. Always ensure that your account has sufficient privileges for the operations you wish to carry out. In particular, to be able to send a message to an SQS queue, the IAM user or role should have the following permissions: - `sqs:SendMessage`: Allows a user to send a message to a specific SQS queue. It's essential to correctly set these permissions in the AWS IAM management console. If you're using a role, remember that you need to have the `sts:AssumeRole` permission and the role's trust policy should allow the user to assume the role. ## Additional Notes - For **Set Queue Attributes** action, under the **Attributes** parameter, please pass the required input fields are per this API Docs shown [here](https://boto3.amazonaws.com/v1/documentation/api/1.26.93/reference/services/sqs/client/set_queue_attributes.html). ## Additional Documentation - [Amazon AWS SQS Connector Documentation](https://docs.swimlane.com/connectors/amazon-aws-sqs) - [Amazon AWS SQS API Documentation](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/Welcome.html) - [Amazon AWS SQS Authentication Guide](https://docs.swimlane.com/authentication-guides/amazon-aws-sqs) # Configurations ## AWS SQS Authenticates using AWS credentials ### Configuration Parameters | **Parameter** | **Description** | **Type** | **Required** | | ------------------------ | ------------------------------------------------------- | -------- | ------------ | | aws\_access\_key\_id | A specific AWS access key ID | string | Required | | aws\_secret\_access\_key | A specific AWS secret access key | string | Required | | region\_name | The AWS Region where you want to create new connections | string | Required | | role\_arn | ARN Role | string | Optional | # Actions ## Create Queue Create a new standard or FIFO queue in Amazon AWS SQS with customizable attributes. Requires the QueueName as input. ### Endpoint - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ------------------------------------------ | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `QueueName` | string | Required | The name of the new queue. | | `Attributes` | object | Optional | Parameter for Create Queue | | `Attributes.DelaySeconds` | number | Optional | The length of time, in seconds, for which the delivery of all messages in the queue is delayed. Valid values are integer from 0 to 900 seconds (15 minutes). | | `Attributes.MaximumMessageSize` | number | Optional | The limit of how many bytes a message can contain before Amazon SQS rejects it. Valid values are integer from 1,024 bytes (1 KiB) to 262,144 bytes (256 KiB). | | `Attributes.MessageRetentionPeriod` | number | Optional | The length of time, in seconds, for which Amazon SQS retains a message. Valid values are integer from 60 seconds (1 minute) to 1,209,600 seconds (14 days). Default is 345,600 (4 days). | | `Attributes.Policy` | string | Optional | The queue’s policy. A valid Amazon Web Services policy. | | `Attributes.ReceiveMessageWaitTimeSeconds` | number | Optional | The length of time, in seconds, for which a ReceiveMessage action waits for a message to arrive. Valid values are integer from 0 to 20 (seconds). Default is 0. | | `Attributes.RedrivePolicy` | string | Optional | The string that includes the parameters for the dead-letter queue functionality of the source queue as a JSON object. | | `Attributes.VisibilityTimeout` | string | Optional | The visibility timeout for the queue, in seconds. Valid values are integer from 0 to 43,200 (12 hours). Default is 30. | | `Attributes.FifoQueue` | boolean | Optional | Designates a queue as FIFO. Valid values are true and false. If you don’t specify the FifoQueue attribute, Amazon SQS creates a standard queue. | | `Attributes.ContentBasedDeduplication` | boolean | Optional | Enables content-based deduplication. Valid values are true and false. | | `Attributes.KmsMasterKeyId` | string | Optional | The ID of an Amazon Web Services managed customer master key (CMK) for Amazon SQS or a custom CMK. | | `Attributes.KmsDataKeyReusePeriodSeconds` | number | Optional | The length of time, in seconds, for which Amazon SQS can reuse a data key to encrypt or decrypt messages before calling KMS again. An integer representing seconds, between 60 seconds (1 minute) and 86,400 seconds (24 hours). Default is 300 (5 minutes). | | `Attributes.DeduplicationScope` | string | Optional | Specifies whether message deduplication occurs at the message group or queue level. Valid values are messageGroup and queue. | | `Attributes.FifoThroughputLimit` | string | Optional | Specifies whether the FIFO queue throughput quota applies to the entire queue or per message group. | | `Attributes.SqsManagedSseEnabled` | boolean | Optional | Enables server-side queue encryption using SQS owned encryption keys. | | `tags` | object | Optional | Parameter for Create Queue | | `tags.Team` | string | Optional | Parameter for Create Queue | ### Input Example `{"QueueName":"MyQueue.fifo","Attributes":{"DelaySeconds":10,"MaximumMessageSize":262144,"MessageRetentionPeriod":1209600,"Policy":"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"ExamplePolicy\",\"Effect\":\"Allow\",\"Principal\":\"*\",\"Action\":\"SQS:SendMessage\",\"Resource\":\"arn:aws:sqs:us-east-1:123456789012:MyQueue.fifo\"}]}","ReceiveMessageWaitTimeSeconds":20,"RedrivePolicy":"{\"deadLetterTargetArn\":\"arn:aws:sqs:us-east-1:123456789012:MyDeadLetterQueue\",\"maxReceiveCount\":\"5\"}","VisibilityTimeout":"30","FifoQueue":true,"ContentBasedDeduplication":true,"KmsMasterKeyId":"alias/aws/sqs","KmsDataKeyReusePeriodSeconds":300,"DeduplicationScope":"messageGroup","FifoThroughputLimit":"perMessageGroupId","SqsManagedSseEnabled":true},"tags":{"Team":"DevOps"}}` ### Output | **Parameter** | **Type** | **Description** | | ----------------- | -------- | ---------------------------- | | `result` | object | Result of the operation | | `result.QueueUrl` | string | URL endpoint for the request | ### Output Example `{"result":{"QueueUrl":"string"}}` ## Send Message Deliver a message to the specified Amazon AWS SQS queue using QueueUrl and MessageBody. ### Endpoint - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ------------------------- | -------- | ------------ | ---------------------------- | | `QueueUrl` | string | Required | URL endpoint for the request | | `MessageBody` | string | Required | Request body data | | `DelaySeconds` | number | Optional | Parameter for Send Message | | `MessageAttributes` | object | Optional | Response message | | `MessageSystemAttributes` | object | Optional | Response message | | `MessageDeduplicationId` | string | Optional | Unique identifier | | `MessageGroupId` | string | Optional | Unique identifier | ### Input Example `{"QueueUrl":"string","MessageBody":"string","DelaySeconds":123,"MessageAttributes":{},"MessageSystemAttributes":{},"MessageDeduplicationId":"string","MessageGroupId":"string"}` ### Output | **Parameter** | **Type** | **Description** | | ----------------------------------------------- | -------- | ----------------- | | `MD5OfMessageBody` | string | Request body data | | `MD5OfMessageAttributes` | string | Response message | | `MessageId` | string | Unique identifier | | `ResponseMetadata` | object | Response data | | `ResponseMetadata.RequestId` | string | Response data | | `ResponseMetadata.HTTPStatusCode` | number | Response data | | `ResponseMetadata.HTTPHeaders` | object | Response data | | `ResponseMetadata.HTTPHeaders.x-amzn-requestid` | string | Response data | | `ResponseMetadata.HTTPHeaders.date` | string | Response data | | `ResponseMetadata.HTTPHeaders.content-type` | string | Response data | | `ResponseMetadata.HTTPHeaders.content-length` | string | Response data | | `ResponseMetadata.RetryAttempts` | number | Response data | ### Output Example `{"MD5OfMessageBody":"fafb00f5732ab283681e124bf8747ed1","MD5OfMessageAttributes":"640e62a86cc98826fe79f68e51611abe","MessageId":"da30c03c-cfaf-4645-8c58-715c9ee8f4f4","ResponseMetadata":{"RequestId":"eef200f3-1d69-5b2c-9688-5c02dde25c21","HTTPStatusCode":200,"HTTPHeaders":{"x-amzn-requestid":"eef200f3-1d69-5b2c-9688-5c02dde25c21","date":"Wed, 31 May 2023 21:38:19 GMT","content-type":"text/xml","content-length":"459"},"RetryAttempts":0}}` ## Set Queue Attributes Set multiple attributes for a specified Amazon AWS SQS queue, such as permissions and policies. Requires QueueUrl and Attributes. ### Endpoint - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ------------------------------------------ | -------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `QueueUrl` | string | Required | URL endpoint for the request | | `Attributes` | object | Required | Parameter for Set Queue Attributes | | `Attributes.DelaySeconds` | number | Optional | The length of time, in seconds, for which the delivery of all messages in the queue is delayed. | | `Attributes.MaximumMessageSize` | number | Optional | The limit of how many bytes a message can contain before Amazon SQS rejects it. | | `Attributes.MessageRetentionPeriod` | number | Optional | The length of time, in seconds, for which Amazon SQS retains a message. | | `Attributes.Policy` | string | Optional | The queue's policy. A valid Amazon Web Services policy. | | `Attributes.ReceiveMessageWaitTimeSeconds` | number | Optional | The length of time, in seconds, for which a ReceiveMessage action waits for a message to arrive. Valid values are integer from 0 to 20 (seconds). | | `Attributes.RedrivePolicy` | string | Optional | The string that includes the parameters for the dead-letter queue functionality of the source queue as a JSON object. | | `Attributes.VisibilityTimeout` | number | Optional | The visibility timeout for the queue, in seconds. Valid values are integer from 0 to 43,200 (12 hours). | | `Attributes.FifoQueue` | boolean | Optional | Indicates whether the queue is FIFO (first-in-first-out). | | `Attributes.ContentBasedDeduplication` | boolean | Optional | Enables content-based deduplication for FIFO queues. | | `Attributes.KmsMasterKeyId` | string | Optional | The ID of an Amazon Web Services managed customer master key (CMK) for Amazon SQS or a custom CMK. | | `Attributes.KmsDataKeyReusePeriodSeconds` | number | Optional | The length of time, in seconds, for which Amazon SQS can reuse a data key to encrypt or decrypt messages before calling KMS again. | | `Attributes.DeduplicationScope` | string | Optional | Specifies whether message deduplication occurs at the message group or queue level. Valid values are messageGroup and queue. | | `Attributes.FifoThroughputLimit` | string | Optional | Specifies whether the FIFO queue throughput quota applies to the entire queue or per message group. Valid values are perQueue and perMessageGroupId. | | `Attributes.SqsManagedSseEnabled` | boolean | Optional | Enables server-side queue encryption using SQS owned encryption keys. Only one server-side encryption option is supported per queue (e.g. SSE-KMS or SSE-SQS). | ### Input Example `{"QueueUrl":"https://sqs.us-east-1.amazonaws.com/123456789012/MyQueue","Attributes":{"DelaySeconds":10,"MaximumMessageSize":262144,"MessageRetentionPeriod":1209600,"Policy":"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Sid1234567890\",\"Effect\":\"Allow\",\"Principal\":\"*\",\"Action\":\"SQS:SendMessage\",\"Resource\":\"arn:aws:sqs:us-east-1:123456789012:MyQueue\"}]}","ReceiveMessageWaitTimeSeconds":10,"RedrivePolicy":"{\"deadLetterTargetArn\":\"arn:aws:sqs:us-east-1:123456789012:MyDeadLetterQueue\",\"maxReceiveCount\":\"5\"}","VisibilityTimeout":30,"FifoQueue":true,"ContentBasedDeduplication":true,"KmsMasterKeyId":"alias/aws/sqs","KmsDataKeyReusePeriodSeconds":300,"DeduplicationScope":"messageGroup","FifoThroughputLimit":"perMessageGroupId","SqsManagedSseEnabled":true}}` ### Output | **Parameter** | **Type** | **Description** | | ------------- | -------- | ----------------------- | | `result` | string | Result of the operation | ### Output Example `{"result":"Queue attributes set successfully."}` # Response Headers | **Header** | **Description** | **Example** | | ------------ | ----------------------------------------------------- | ----------------------------- | | Content-Type | The media type of the resource | application/json | | Date | The date and time at which the message was originated | Thu, 01 Jan 2024 00:00:00 GMT |