azure_storage_queue 0.1.0

Microsoft Azure Queue client library for Rust
Documentation

Azure Queue client library for Rust

Azure Queue Storage is a service for storing large numbers of messages.

Source code | [Package (crates.io)] | [API reference documentation] | REST API documentation | Product documentation

Getting started

⚠️ Note: The azure_storage_queue crate is currently under active development and not all features may be implemented or work as intended. This crate is in beta and not suitable for Production environments. For any general feedback or usage issues, please open a GitHub issue at https://github.com/Azure/azure-sdk-for-rust/issues.

Install the package

Install the Azure Storage Queue client library for Rust with cargo:

cargo add azure_storage_queue

Prerequisites

Create a storage account

If you wish to create a new storage account, you can use the Azure Portal, Azure PowerShell, or Azure CLI:

# Create a new resource group to hold the storage account -
# if using an existing resource group, skip this step
az group create --name my-resource-group --location westus2

# Create the storage account
az storage account create -n my-storage-account-name -g my-resource-group

Authenticate the client

In order to interact with the Azure Queue service, you'll need to create an instance of a client, QueueClient. The Azure Identity library makes it easy to add Microsoft Entra ID support for authenticating Azure SDK clients with their corresponding Azure services:

use azure_storage_queue::{QueueClient, QueueClientOptions};
use azure_identity::DeveloperToolsCredential;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Create a QueueClient that will authenticate through Microsoft Entra ID
    let credential = DeveloperToolsCredential::new(None)?;
    let queue_client = QueueClient::new(
        "https://<storage_account_name>.blob.core.windows.net/", // endpoint
        "queue-name",                                            // queue name
        credential,                                              // credential
        Some(QueueClientOptions::default()),                     // QueueClient options
    )?;
    Ok(())
}

Permissions

You may need to specify RBAC roles to access Queues via Microsoft Entra ID. Please see Assign an Azure role for access to queue data for more details.

Examples

You can find executable examples for all major SDK functions in:

Next steps

Provide feedback

If you encounter bugs or have suggestions, open an issue.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You'll only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.