Creating an Amazon SQS FIFO queue and sending a message - Amazon Simple Queue Service
Create a queueSend a message
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).

Creating an Amazon SQS FIFO queue and sending a message

This is how to create a FIFO queue for Amazon SQS.

Create a queue

You can use the Amazon SQS console to create FIFO queues. The console provides default values for all settings except for the queue name.

Important

On August 17, 2022, default server-side encryption (SSE) was applied to all Amazon SQS queues.

Do not add personally identifiable information (PII) or other confidential or sensitive information in queue names. Queue names are accessible to many Amazon Web Services, including billing and CloudWatch logs. Queue names are not intended to be used for private or sensitive data.

To create an Amazon SQS FIFO queue

  1. Open the Amazon SQS console at https://console.amazonaws.cn/sqs/.

  2. Choose Create queue.

  3. For Type, the Standard queue type is set by default. To create a FIFO queue, choose FIFO.

    Note

    You can't change the queue type after you create the queue.

  4. Enter a Name for your queue.

    The name of a FIFO queue must end with the .fifo suffix. The suffix counts towards the 80-character queue name quota. To determine whether a queue is FIFO, you can check whether the queue name ends with the suffix.

  5. (Optional) The console sets default values for the queue configuration parameters. Under Configuration, you can set new values for the following parameters:

    1. For Visibility timeout , enter the duration and units. The range is from 0 seconds to 12 hours. The default value is 30 seconds.

    2. For Message retention period, enter the duration and units. The range is from 1 minute to 14 days. The default value is 4 days.

    3. For Delivery delay, enter the duration and units. The range is from 0 seconds to 15 minutes. The default value is 0 seconds.

    4. For Maximum message size, enter a value. The range is from 1 KB to 256 KB. The default value is 256 KB.

    5. For Receive message wait time, enter a value. The range is from 0 to 20 seconds. The default value is 0 seconds, which sets short polling. Any non-zero value sets long polling.

    6. For a FIFO queue, choose Content-based deduplication to enable content-based deduplication. The default setting is disabled.

    7. (Optional) For a FIFO queue to enable higher throughput for sending and receiving messages in the queue, choose Enable high throughput FIFO.

      Choosing this option changes the related options (Deduplication scope and FIFO throughput limit) to the required settings for enabling high throughput for FIFO queues. If you change any of the settings required for using high throughput FIFO, normal throughput is in effect for the queue, and deduplication occurs as specified. For more information, see High throughput for FIFO queues and Quotas related to messages.

  6. (Optional) Define an Access policy. The access policy defines the accounts, users, and roles that can access the queue. The access policy also defines the actions (such as SendMessage, ReceiveMessage, or DeleteMessage) that the users can access. The default policy allows only the queue owner to send and receive messages.

    To define the access policy, do one of the following:

    • Choose Basic to configure who can send messages to the queue and who can receive messages from the queue. The console creates the policy based on your choices and displays the resulting access policy in the read-only JSON panel.

    • Choose Advanced to modify the JSON access policy directly. This allows you to specify a custom set of actions that each principal (account, user, or role) can perform.

  7. For Redrive allow policy, choose Enabled. Select one of the following: Allow all, By queue, or Deny all. When choosing By queue, specify a list of up to 10 source queues by the Amazon Resource Name (ARN).

  8. Amazon SQS provides managed server-side encryption by default. To choose an encryption key type, or to disable Amazon SQS managed server-side encryption, expand Encryption. For more on encryption key types, see Configuring server-side encryption (SSE) for a queue using SQS-managed encryption keys (console) and Configuring server-side encryption (SSE) for a queue (console).

    Note

    With SSE enabled, anonymous SendMessage and ReceiveMessage requests to the encrypted queue will be rejected. Amazon SQS security best practises recommend against using anonymous requests. If you wish to send anonymous requests to an Amazon SQS queue, make sure to disable SSE.

  9. (Optional) To configure a dead-letter queue to receive undeliverable messages, expand Dead-letter queue.

  10. (Optional) To add tags to the queue, expand Tags.

  11. Choose Create queue. Amazon SQS creates the queue and displays the queue's Details page.

Amazon SQS propagates information about the new queue across the system. Because Amazon SQS is a distributed system, you might experience a slight delay before the console displays the queue on the Queues page.

After creating a queue, you can send messages to it, and receive and delete messages. You can also edit any of the queue configuration settings except the queue type.

Send a message

After you create your queue, you can send a message to it.

  1. From the left navigation pane, choose Queues. From the queue list, select the queue that you created.

  2. From Actions, choose Send and receive messages.

    The console displays the Send and receive messages page.

  3. In the Message body, enter the message text.

  4. For a First-In-First-Out (FIFO) queue, enter a Message group ID. For more information, see FIFO delivery logic.

  5. (Optional) For a FIFO queue, you can enter a Message deduplication ID. If you enabled content-based deduplication for the queue, the message deduplication ID isn't required. For more information, see FIFO delivery logic.

  6. FIFO queues does not support timers on individual messages. For more information, see Amazon SQS message timers.

  7. Choose Send message.

    When your message is sent, the console displays a success message. Choose View details to display information about the sent message.