Performing Simple Queue Storage REST API operations using CURL

This post has been republished via RSS; it originally appeared at: Microsoft Tech Community - Latest Blogs - .

The blog points to performing simple Queue REST API operations such as List, Create, Get, Put and Delete using CURL utility.

 

Let’s look at some of the CURL command syntax to perform REST API operations and will be making use of SAS as the auth scheme for most of the operations. We need to take care of the pointers below while performing the operations via CURL:

 

  • Ensure the URL is formed correctly as per the operation you are trying to perform.
  • The header needs to be passed and can be done using “-H” parameter.
  • Ensure you are appending/removing extra ‘?’ to the SAS token in the URLs accordingly.
  • Http verb can be GET, PUT, PATCH or DELETE as provided by the CURL specifications.

 

List Queues

List Queues (REST API) - Azure Storage | Microsoft Learn

 

Syntax:

 

curl -i -X <HTTP Verb> -H "x-ms-version: 2019-12-12" https://<StorageAccountName>.queue.core.windows.net?comp=list&SASToken

 

 

In the below snippet, the operation is being performed on the account and it lists the queues present inside it as below:

Amrinder_Singh_0-1693392695435.png

 

Create Queue

Create Queue (REST API) - Azure Storage | Microsoft Learn

 

Syntax:

 

curl -i -X <HTTP Verb> -H "x-ms-version: 2019-12-12" -H “Content-Length: 0” https://<StorageAccountName>.queue.core.windows.net/<QueueName>?SASToken

 

Amrinder_Singh_1-1693392725959.png

 

In the above sample, we also need to pass Content-Length as 0 to test the same via CURL and create a queue name testqueue7.  You can verify from the portal further as well.

Amrinder_Singh_2-1693392734549.png

 

Delete Queue

Delete Queue (REST API) - Azure Storage | Microsoft Learn

 

Syntax:

 

curl -i -X <HTTP Verb> -H "x-ms-version: 2019-12-12" https://<StorageAccountName>.queue.core.windows.net/<QueueName>?SASToken

 

In the below sample, we delete a queue name testqueue6 successfully.  You can verify from the portal further as well.

Amrinder_Singh_3-1693392790988.png

 

Put Message

Put Message (REST API) - Azure Storage | Microsoft Learn

 

Syntax:

 

curl -i -X <HTTP Verb> -H "x-ms-version: 2019-12-12" -H "Content-Length: <Length of Message>" -H "Content-Type: text/plain" "https://<StorageAccountName>.queue.core.windows.net/<QueueName>/messages?visibilitytimeout=XX&messagettl=XX&SASToken --data "<QueueMessage><MessageText>Message Text</MessageText></QueueMessage> "

 

 

Amrinder_Singh_4-1693392850126.png

 

Get Message

Get Messages (REST API) - Azure Storage | Microsoft Learn

 

Syntax:

 

curl -i -X <HTTP Verb> -H "x-ms-version: 2019-12-12" https://<StorageAccountName>.queue.core.windows.net/<QueueName>/messages?SASToken

 

Amrinder_Singh_5-1693392908037.png

 

 

Delete Message

Delete Message (REST API) - Azure Storage | Microsoft Learn

 

Syntax:

 

curl -i -X <HTTP Verb> -H "x-ms-version: 2019-12-12" https://<StorageAccountName>.queue.core.windows.net/<QueueName>/messages/<messageID>? popreceipt=string-value&SASToken

 

Amrinder_Singh_6-1693392965069.png

 

Clear Queue

Clear Messages (REST API) - Azure Storage | Microsoft Learn

Syntax:

 

curl -i -X <HTTP Verb> -H "x-ms-version: 2019-12-12" https://<StorageAccountName>.queue.core.windows.net/<QueueName>?SASToken

 

In the below sample, we initially added 2 messages to the queue testqueue7 and then performed clear queue operation which deleted all the messages from the queue successfully.  

Amrinder_Singh_7-1693392996638.png

 

Amrinder_Singh_8-1693393001436.png

 

Hope this helps!

Leave a Reply

Your email address will not be published. Required fields are marked *

*

This site uses Akismet to reduce spam. Learn how your comment data is processed.