4a5f1234bb
* chore: upgrade maintenance scripts to robust PyYAML parsing - Replaces fragile regex frontmatter parsing with PyYAML/yaml library - Ensures multi-line descriptions and complex characters are handled safely - Normalizes quoting and field ordering across all maintenance scripts - Updates validator to strictly enforce description quality * fix: restore and refine truncated skill descriptions - Recovered 223+ truncated descriptions from git history (6.5.0 regression) - Refined long descriptions into concise, complete sentences (<200 chars) - Added missing descriptions for brainstorming and orchestration skills - Manually fixed imagen skill description - Resolved dangling links in competitor-alternatives skill * chore: sync generated registry files and document fixes - Regenerated skills index with normalized forward-slash paths - Updated README and CATALOG to reflect restored descriptions - Documented restoration and script improvements in CHANGELOG.md * fix: restore missing skill and align metadata for full 955 count - Renamed SKILL.MD to SKILL.md in andruia-skill-smith to ensure indexing - Fixed risk level and missing section in andruia-skill-smith - Synchronized all registry files for final 955 skill count * chore(scripts): add cross-platform runners and hermetic test orchestration * fix(scripts): harden utf-8 output and clone target writeability * fix(skills): add missing date metadata for strict validation * chore(index): sync generated metadata dates * fix(catalog): normalize skill paths to prevent CI drift * chore: sync generated registry files * fix: enforce LF line endings for generated registry files
136 lines
3.2 KiB
Markdown
136 lines
3.2 KiB
Markdown
---
|
|
name: azure-storage-blob-rust
|
|
description: Azure Blob Storage SDK for Rust. Use for uploading, downloading, and managing blobs and containers.
|
|
risk: unknown
|
|
source: community
|
|
date_added: '2026-02-27'
|
|
---
|
|
|
|
# Azure Blob Storage SDK for Rust
|
|
|
|
Client library for Azure Blob Storage — Microsoft's object storage solution for the cloud.
|
|
|
|
## Installation
|
|
|
|
```sh
|
|
cargo add azure_storage_blob azure_identity
|
|
```
|
|
|
|
## Environment Variables
|
|
|
|
```bash
|
|
AZURE_STORAGE_ACCOUNT_NAME=<storage-account-name>
|
|
# Endpoint: https://<account>.blob.core.windows.net/
|
|
```
|
|
|
|
## Authentication
|
|
|
|
```rust
|
|
use azure_identity::DeveloperToolsCredential;
|
|
use azure_storage_blob::{BlobClient, BlobClientOptions};
|
|
|
|
let credential = DeveloperToolsCredential::new(None)?;
|
|
let blob_client = BlobClient::new(
|
|
"https://<account>.blob.core.windows.net/",
|
|
"container-name",
|
|
"blob-name",
|
|
Some(credential),
|
|
Some(BlobClientOptions::default()),
|
|
)?;
|
|
```
|
|
|
|
## Client Types
|
|
|
|
| Client | Purpose |
|
|
|--------|---------|
|
|
| `BlobServiceClient` | Account-level operations, list containers |
|
|
| `BlobContainerClient` | Container operations, list blobs |
|
|
| `BlobClient` | Individual blob operations |
|
|
|
|
## Core Operations
|
|
|
|
### Upload Blob
|
|
|
|
```rust
|
|
use azure_core::http::RequestContent;
|
|
|
|
let data = b"hello world";
|
|
blob_client
|
|
.upload(
|
|
RequestContent::from(data.to_vec()),
|
|
false, // overwrite
|
|
u64::try_from(data.len())?,
|
|
None,
|
|
)
|
|
.await?;
|
|
```
|
|
|
|
### Download Blob
|
|
|
|
```rust
|
|
let response = blob_client.download(None).await?;
|
|
let content = response.into_body().collect_bytes().await?;
|
|
println!("Content: {:?}", content);
|
|
```
|
|
|
|
### Get Blob Properties
|
|
|
|
```rust
|
|
let properties = blob_client.get_properties(None).await?;
|
|
println!("Content-Length: {:?}", properties.content_length);
|
|
```
|
|
|
|
### Delete Blob
|
|
|
|
```rust
|
|
blob_client.delete(None).await?;
|
|
```
|
|
|
|
## Container Operations
|
|
|
|
```rust
|
|
use azure_storage_blob::BlobContainerClient;
|
|
|
|
let container_client = BlobContainerClient::new(
|
|
"https://<account>.blob.core.windows.net/",
|
|
"container-name",
|
|
Some(credential),
|
|
None,
|
|
)?;
|
|
|
|
// Create container
|
|
container_client.create(None).await?;
|
|
|
|
// List blobs
|
|
let mut pager = container_client.list_blobs(None)?;
|
|
while let Some(blob) = pager.try_next().await? {
|
|
println!("Blob: {}", blob.name);
|
|
}
|
|
```
|
|
|
|
## Best Practices
|
|
|
|
1. **Use Entra ID auth** — `DeveloperToolsCredential` for dev, `ManagedIdentityCredential` for production
|
|
2. **Specify content length** — required for uploads
|
|
3. **Use `RequestContent::from()`** — to wrap upload data
|
|
4. **Handle async operations** — use `tokio` runtime
|
|
5. **Check RBAC permissions** — ensure "Storage Blob Data Contributor" role
|
|
|
|
## RBAC Permissions
|
|
|
|
For Entra ID auth, assign one of these roles:
|
|
- `Storage Blob Data Reader` — read-only
|
|
- `Storage Blob Data Contributor` — read/write
|
|
- `Storage Blob Data Owner` — full access including RBAC
|
|
|
|
## Reference Links
|
|
|
|
| Resource | Link |
|
|
|----------|------|
|
|
| API Reference | https://docs.rs/azure_storage_blob |
|
|
| Source Code | https://github.com/Azure/azure-sdk-for-rust/tree/main/sdk/storage/azure_storage_blob |
|
|
| crates.io | https://crates.io/crates/azure_storage_blob |
|
|
|
|
## When to Use
|
|
This skill is applicable to execute the workflow or actions described in the overview.
|