Azure / Azure/azure-sdk-for-rust

Migration guide: `azure_storage_queue` (from azure_storage_queues)

Open
#4,235 0 comments 0 reactions 0 assignees View on GitHub
Docs rust Storage
Dominant language
Rust
Stars
884
Forks
365
Avg merge
2d 19h
Merged PRs (30d)
109

Description

Part of #4228

## Migration guide: `azure_storage_queue`

### Official Crate

- **Name:** [`azure_storage_queue`](https://crates.io/crates/azure_storage_queue)
- **Current version:** 0.5.0
- **Service:** Azure Queue Storage

### Unofficial Predecessor(s)

| Predecessor | Version(s) | Relationship | crates.io |
|---|---|---|---|
| `azure_storage_queues` v0.21.0 | Era 2 (2022–2024, 362K downloads) | **Different crate** — plural → singular rename (`queues` → `queue`) | [crates.io](https://crates.io/crates/azure_storage_queues) |
| `azure_sdk_storage_queue` v0.1.0 | Era 1 (MindFlavor, 2017–2019, 2K downloads) | **Different crate** — community-era queue client | [crates.io](https://crates.io/crates/azure_sdk_storage_queue) |

> **Note:** `azure_storage_queue` is not part of the April 2026 GA wave.

### Migration Guide Should Cover

- Crate rename: `azure_storage_queues` → `azure_storage_queue` (drop the plural)
- New client builder pattern
- Message encoding/decoding changes
- Queue CRUD operations
- Base crate change: `azure_storage` → `azure_storage_common`
- Migration path for `azure_sdk_storage_queue` users (start from scratch)
- Cargo.toml dependency changes

### Acceptance Criteria

- [ ] Migration guide published in repo docs (e.g., `docs/migration/azure_storage_queue.md`)
- [ ] Code samples for key scenarios: creating a queue client, send/receive/delete messages, queue management
- [ ] FAQ section covering common migration pitfalls (especially the plural → singular rename)
- [ ] Linked from the `azure_storage_queue` crate README
- [ ] Reviewed by SDK team

Contributor guide

Open the contributing guide

Research direction

Start by reading the azure_storage_queue crate README and the migration requirements in this issue, then inspect the documented predecessor crates azure_storage_queues and azure_sdk_storage_queue. Create docs/migration/azure_storage_queue.md with the requested migration details, samples, and FAQ, link it from the crate README, and ensure the acceptance checklist is covered for SDK team review.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
cloud, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.