Manage AWS SQS Queues using aws-cli

You can perform operations on SQS like list, create, delete Queues and send messages, receive messages from your terminal using aws-cli. In this article, we will see the commands to perform these kinds of operations. Before we proceed, it is assumed that you are familiar with AWS SQS Queue.

To know in detail about options available for aws-cli, visit the official documentation here.


  1. AWS Account  (Create if you don’t have one).
  2. Basic understanding of SQS Queues (Click here to learn to create an SQS Queue using Terraform).
  3. AWS IAM user with AmazonSQSFullAccess policy attached to it and its access and secret keys (Click here to learn to create an IAM User).
  4. AWS CLI installed on your local machine.

What will we do?

  1. Check aws cli and export the AWS access & secret key on your local machine.
  2. Manage SNS Topics using aws cli.

Check aws cli and export aws access & secret key on your local machine.

If you don't have the aws-cli then refer to the official documentation here to install it on your local machine and then check the version of it using the following command.

aws --version

If you execute the following command, you will get an error as you have not configured access to your AWS account in the terminal.

aws sts get-caller-identity

Export AWS IAM user access and secret keys on your terminal using the following commands.

export AWS_ACCESS_KEY_ID=<aws-user-access-key>
export AWS_SECRET_ACCESS_KEY=<aws-user-secret-key>

This time, you can check your identity by executing the following command

aws sts get-caller-identity

Manage SQS Queues using aws-cli

List all Queues available in your current region

aws sqs list-queues

You can also list Queues with matching prefix

aws sqs list-queues --queue-name-prefix "rahul"

List Queue

To create an SQS Queue, execute the following command.

aws sqs create-queue --queue-name my-sqs-using-cli

You can also attach tags while creating a Queue.

aws sqs create-queue --queue-name my-sqs-using-cli-with-tag --tags "env"="test"

Create Queues

One can also specify attributes while creating a Queue, to create a Queue with an attribute DelaySeconds execute the following command.

aws sqs create-queue --queue-name my-sqs-using-cli-with-attribute --tags "env"="test" --attributes DelaySeconds=10

Check all the attributes a Queue has.  

aws sqs get-queue-attributes --queue-url<aws-account-number>/my-sqs-using-cli-with-attribute --attribute-names All

Check a specific attribute a Queue has, in this case, the value of the DelaySeconds will be returned by the command.

aws sqs get-queue-attributes --queue-url<aws-account-number>/my-sqs-using-cli-with-attribute --attribute-names DelaySeconds

Get Queue Attributes

Let' send and receive a message to/from the Queue.

aws sqs send-message --queue-url<aws-account-number>/my-sqs-using-cli --message-body "Test message to my-sqs-using-cli sqs"
aws sqs receive-message --queue-url<aws-account-number>/my-sqs-using-cli

Send and receive a message

You can check the message count in the SQS Dashboard.

Check message count in the console

If you want to delete messages from the Queue, you can purge the Queue

sqs purge-queue --queue-url<aws-account-number>/my-sqs-using-cli
sqs receive-message --queue-url<aws-account-number>/my-sqs-using-cli

Purge the message

To delete a Queue, you will need its URL.

aws sqs list-queues --queue-name-prefix "rahul"
aws sqs delete-queue --queue-url<aws-account-number>/rahul-test
aws sqs list-queues --queue-name-prefix "rahul"

Delete the Queue


In this article, we saw the command to List, Create an SQS Queue, send and receive messages to/from it and check its attributes. This can be a guide to get started and now you can explore other operations on SQS queues on your own.

Share this page:

0 Comment(s)