Azure Storage Blob Rust

1---
2name: azure-storage-blob-rust
3description: |
4  Azure Blob Storage SDK for Rust. Use for uploading, downloading, and managing blobs and containers.
5  Triggers: "blob storage rust", "BlobClient rust", "upload blob rust", "download blob rust", "container rust".
6package: azure_storage_blob
7---
8 
9# Azure Blob Storage SDK for Rust
10 
11Client library for Azure Blob Storage — Microsoft's object storage solution for the cloud.
12 
13## Installation
14 
15```sh
16cargo add azure_storage_blob azure_identity
17```
18 
19## Environment Variables
20 
21```bash
22AZURE_STORAGE_ACCOUNT_NAME=<storage-account-name>
23# Endpoint: https://<account>.blob.core.windows.net/
24```
25 
26## Authentication
27 
28```rust
29use azure_identity::DeveloperToolsCredential;
30use azure_storage_blob::{BlobClient, BlobClientOptions};
31 
32let credential = DeveloperToolsCredential::new(None)?;
33let blob_client = BlobClient::new(
34    "https://<account>.blob.core.windows.net/",
35    "container-name",
36    "blob-name",
37    Some(credential),
38    Some(BlobClientOptions::default()),
39)?;
40```
41 
42## Client Types
43 
44| Client | Purpose |
45|--------|---------|
46| `BlobServiceClient` | Account-level operations, list containers |
47| `BlobContainerClient` | Container operations, list blobs |
48| `BlobClient` | Individual blob operations |
49 
50## Core Operations
51 
52### Upload Blob
53 
54```rust
55use azure_core::http::RequestContent;
56 
57let data = b"hello world";
58blob_client
59    .upload(
60        RequestContent::from(data.to_vec()),
61        false,  // overwrite
62        u64::try_from(data.len())?,
63        None,
64    )
65    .await?;
66```
67 
68### Download Blob
69 
70```rust
71let response = blob_client.download(None).await?;
72let content = response.into_body().collect_bytes().await?;
73println!("Content: {:?}", content);
74```
75 
76### Get Blob Properties
77 
78```rust
79let properties = blob_client.get_properties(None).await?;
80println!("Content-Length: {:?}", properties.content_length);
81```
82 
83### Delete Blob
84 
85```rust
86blob_client.delete(None).await?;
87```
88 
89## Container Operations
90 
91```rust
92use azure_storage_blob::BlobContainerClient;
93 
94let container_client = BlobContainerClient::new(
95    "https://<account>.blob.core.windows.net/",
96    "container-name",
97    Some(credential),
98    None,
99)?;
100 
101// Create container
102container_client.create(None).await?;
103 
104// List blobs
105let mut pager = container_client.list_blobs(None)?;
106while let Some(blob) = pager.try_next().await? {
107    println!("Blob: {}", blob.name);
108}
109```
110 
111## Best Practices
112 
1131. **Use Entra ID auth** — `DeveloperToolsCredential` for dev, `ManagedIdentityCredential` for production
1142. **Specify content length** — required for uploads
1153. **Use `RequestContent::from()`** — to wrap upload data
1164. **Handle async operations** — use `tokio` runtime
1175. **Check RBAC permissions** — ensure "Storage Blob Data Contributor" role
118 
119## RBAC Permissions
120 
121For Entra ID auth, assign one of these roles:
122- `Storage Blob Data Reader` — read-only
123- `Storage Blob Data Contributor` — read/write
124- `Storage Blob Data Owner` — full access including RBAC
125 
126## Reference Links
127 
128| Resource | Link |
129|----------|------|
130| API Reference | https://docs.rs/azure_storage_blob |
131| Source Code | https://github.com/Azure/azure-sdk-for-rust/tree/main/sdk/storage/azure_storage_blob |
132| crates.io | https://crates.io/crates/azure_storage_blob |
133