Manage Azure Storage Queues with Azure CLI

This guide demonstrates how to manage Azure Storage Queues using the Azure Command-Line Interface (CLI).

Create a Queue

You can create a new queue using the az storage queue create command.

az storage queue create --name myqueue --account-name mystorageaccount --account-key YOUR_STORAGE_ACCOUNT_KEY

Alternatively, if you have configured your Azure CLI with default storage account credentials:

az storage queue create --name myqueue

List Queues

To list all queues within a storage account, use the az storage queue list command.

az storage queue list --account-name mystorageaccount --account-key YOUR_STORAGE_ACCOUNT_KEY

Or using default credentials:

az storage queue list

Send a Message to a Queue

Add a message to a queue with the az storage message put command.

az storage message put --queue-name myqueue --content "Hello, Azure Queues!" --account-name mystorageaccount --account-key YOUR_STORAGE_ACCOUNT_KEY

Using default credentials:

az storage message put --queue-name myqueue --content "Hello, Azure Queues!"

Receive Messages from a Queue

Retrieve messages from a queue. You can specify the number of messages to retrieve.

az storage message get --queue-name myqueue --count 5 --account-name mystorageaccount --account-key YOUR_STORAGE_ACCOUNT_KEY

Using default credentials:

az storage message get --queue-name myqueue --count 5

Messages received this way are invisible for a specified period (visibility timeout) and can be processed. If not deleted within that timeout, they become visible again.

Delete a Message from a Queue

After processing a message, you must delete it using its message ID and pop receipt. First, you need to get the message details (ID and pop receipt).

az storage message get --queue-name myqueue --num-messages 1 --account-name mystorageaccount --account-key YOUR_STORAGE_ACCOUNT_KEY

Then, use the output (messageId and popReceipt) to delete it:

az storage message delete --queue-name myqueue --message-id YOUR_MESSAGE_ID --pop-receipt YOUR_POP_RECEIPT --account-name mystorageaccount --account-key YOUR_STORAGE_ACCOUNT_KEY

Using default credentials:

az storage message delete --queue-name myqueue --message-id YOUR_MESSAGE_ID --pop-receipt YOUR_POP_RECEIPT

Clear a Queue

Remove all messages from a queue using az storage queue clear.

az storage queue clear --name myqueue --account-name mystorageaccount --account-key YOUR_STORAGE_ACCOUNT_KEY

Using default credentials:

az storage queue clear --name myqueue

Delete a Queue

Delete an entire queue with the az storage queue delete command.

az storage queue delete --name myqueue --account-name mystorageaccount --account-key YOUR_STORAGE_ACCOUNT_KEY

Using default credentials:

az storage queue delete --name myqueue