Skip to content

Contact sales

By filling out this form and clicking submit, you acknowledge our privacy policy.
  • Labs icon Lab
  • A Cloud Guru
Azure icon
Labs

Interacting with Azure Queues Using REST

Azure Queues are a great way to provide reliable, cloud-based messaging between applications. There are multiple ways in which you can interact with Queues, including through the use of RESTful API calls. In this lab, you will have the opportunity to read from and write to an Azure Queue using the Azure Queue service REST API.

Azure icon
Labs

Path Info

Level
Clock icon Intermediate
Duration
Clock icon 45m
Published
Clock icon Feb 14, 2020

Contact sales

By filling out this form and clicking submit, you acknowledge our privacy policy.

Table of Contents

  1. Challenge

    Save a list of the current messages to a file.

    1. Set up some environment variables to aid in generating a signature. For the storage_account and access_key, provide the actual storage account name and access key. One way to obtain these is to log in to the Azure portal. The access key can be found by clicking the storage account, then clicking Access Keys:
    storage_account=${your storage account name}
    
    access_key=${your storage account access key}
    
    queue_name=incoming-items
    
    request_date=$(TZ=GMT date "+%a, %d %h %Y %H:%M:%S %Z")
    
    resource="/${storage_account}/${queue_name}/messages"
    
    request_method="GET"
    
    headers="x-ms-date:$request_date"
    
    1. Generate a signature and Authorization header:
    string_to_sign="${request_method}\n\n\n\n${headers}\n${resource}"
    
    hex_key="$(echo -n $access_key | base64 -d -w0 | xxd -p -c256)"
    
    signature=$(printf "$string_to_sign" | openssl dgst -sha256 -mac HMAC -macopt "hexkey:$hex_key" -binary |  base64 -w0)
    
    authorization_header="SharedKey $storage_account:$signature"
    
    1. Make a request to peek the current messages in the queue, redirecting the output to a file:
    curl -s -X $request_method 
      -H "x-ms-date:$request_date" 
      -H "Authorization:$authorization_header" 
      "https://${storage_account}.queue.core.windows.net/${queue_name}/messages?peekonly=true&numofmessages=32" 
      > /home/cloud_user/messages.txt
    
    1. Check the contents of the file to see the messages:
    cat /home/cloud_user/messages.txt
    

    You should see some XML representing one existing message.

  2. Challenge

    Manually add the lost data to the queue.

    1. Set up some environment variables to aid in generating a signature.
    request_date=$(TZ=GMT date "+%a, %d %h %Y %H:%M:%S %Z")
    
    resource="/${storage_account}/${queue_name}/messages"
    
    request_method="POST"
    
    content_type="application/x-www-form-urlencoded; charset=utf-8"
    
    storage_service_version="2018-11-09"
    
    headers="x-ms-date:$request_date\nx-ms-version:$storage_service_version"
    
    message="Item 4489: Coin Collection"
    
    message_base64=$(echo $message | base64)
    
    message_xml="<QueueMessage><MessageText>$message_base64</MessageText></QueueMessage>"
    
    message_length=${#message_xml}
    
    1. Generate a signature and Authorization header.
    string_to_sign="${request_method}\n\n\n$message_length\n\n$content_type\n\n\n\n\n\n\n${headers}\n${resource}\nmessagettl:-1"
    
    hex_key="$(echo -n $access_key | base64 -d -w0 | xxd -p -c256)"
    
    signature=$(printf "$string_to_sign" | openssl dgst -sha256 -mac HMAC -macopt "hexkey:$hex_key" -binary |  base64 -w0)
    
    authorization_header="SharedKey $storage_account:$signature"
    
    1. Make a request to peek the current messages in the queue, redirecting the output to a file.
    curl -X $request_method 
      -H "x-ms-date:$request_date" 
      -H "x-ms-version:$storage_service_version" 
      -H "Content-Type:$content_type" 
      -H "Authorization:$authorization_header" 
      --data "$message_xml" 
      "https://${storage_account}.queue.core.windows.net/${queue_name}/messages?messagettl=-1"
    
    1. If you wish, you can check the Queue in Azure Portal to verify that your new message appears.

The Cloud Content team comprises subject matter experts hyper focused on services offered by the leading cloud vendors (AWS, GCP, and Azure), as well as cloud-related technologies such as Linux and DevOps. The team is thrilled to share their knowledge to help you build modern tech solutions from the ground up, secure and optimize your environments, and so much more!

What's a lab?

Hands-on Labs are real environments created by industry experts to help you learn. These environments help you gain knowledge and experience, practice without compromising your system, test without risk, destroy without fear, and let you learn from your mistakes. Hands-on Labs: practice your skills before delivering in the real world.

Provided environment for hands-on practice

We will provide the credentials and environment necessary for you to practice right within your browser.

Guided walkthrough

Follow along with the author’s guided walkthrough and build something new in your provided environment!

Did you know?

On average, you retain 75% more of your learning if you get time for practice.

Start learning by doing today

View Plans