Send a Message to an Azure Storage Queue

This tutorial demonstrates how to send a message to an Azure Storage Queue using the Azure SDKs. Azure Storage Queues provide a reliable way to decouple application components and manage asynchronous operations.

Step 1: Set up Your Azure Storage Queue

If you don't have a storage account and a queue, you can create them using the Azure portal or Azure CLI.

Using Azure CLI

1. Log in to your Azure account:

   Copy

   az login

2. Create a resource group (if you don't have one):

   Copy

   az group create --name myResourceGroup --location eastus

3. Create a storage account:

   Copy

   az storage account create --name mystorageaccount --resource-group myResourceGroup --location eastus --sku Standard_LRS

   Replace mystorageaccount with a unique name.

4. Create a queue:

   Copy

   az storage queue create --name myqueue --account-name mystorageaccount --account-key <your_storage_account_key>

   You can get your storage account key using az storage account keys list --account-name mystorageaccount --resource-group myResourceGroup --query "[0].value" -o tsv.

Step 2: Install the Azure Storage Queue SDK

We'll use the @azure/storage-queue package for this tutorial. Open your terminal in your project directory and run:

npm install @azure/storage-queue

Step 3: Write the Code to Send a Message

Create a JavaScript file (e.g., sendMessage.js) and add the following code. You'll need your storage account name and account key (or a connection string).

// sendMessage.js
import { QueueClient } from "@azure/storage-queue";

async function sendMessageToQueue() {
    const accountName = "";
    const accountKey = "";
    const queueName = "myqueue"; // Make sure this matches your queue name

    // Construct the connection string
    const connectionString = `DefaultEndpointsProtocol=https;AccountName=${accountName};AccountKey=${accountKey};EndpointSuffix=core.windows.net`;

    // Create a QueueClient
    const queueClient = new QueueClient(connectionString, queueName);

    const messageText = "Hello from Azure Storage Queue Tutorial!";

    try {
        // Send the message
        const result = await queueClient.sendMessage(messageText);
        console.log(`Message sent successfully. Message ID: ${result.messageId}`);

        // Optionally, you can also send a message with TTL and visibility timeout
        const messageWithParams = "This message has custom parameters.";
        const ttl = 60 * 60; // 1 hour in seconds
        const visibilityTimeout = 30; // seconds

        const resultWithParams = await queueClient.sendMessage(messageWithParams, {
            timeToLive: ttl,
            visibilityTimeout: visibilityTimeout,
        });
        console.log(`Message with parameters sent successfully. Message ID: ${resultWithParams.messageId}`);

    } catch (error) {
        console.error("Error sending message to queue:", error);
    }
}

sendMessageToQueue();

Step 4: Run the Code

Execute your JavaScript file using Node.js:

node sendMessage.js

If successful, you will see output similar to:

Message sent successfully. Message ID: <some-guid>
Message with parameters sent successfully. Message ID: <another-guid>

Next Steps

• Learn how to receive and process messages.
• Explore peeking at messages without removing them.
• Understand Azure Storage Queue concepts for more advanced scenarios.