Skip to content

Migration guide: azure_core (from azure_core ≤0.21.0 / azure_sdk_core) #4230

@ronniegeraghty

Description

@ronniegeraghty

Part of #4228

Migration guide: azure_core

Official Crate

  • Name: azure_core
  • Current version: 0.34.0
  • Service: Core HTTP/retry/pipeline framework for all Azure SDK crates

Unofficial Predecessor(s)

Predecessor Version(s) Relationship crates.io
azure_core v0.1.1–0.21.0 Era 2 (Jan 2022 – Oct 2024) Same-crate older version — major API rewrite at v0.22.0 (Feb 2025) crates.io
azure_sdk_core v0.43.7 Era 1 (MindFlavor, 2017–2019) Different crate — community-era core from MindFlavor/AzureSDKForRust, 90K downloads crates.io

Migration Guide Should Cover

  • New pipeline model replacing the era 2 HTTP pipeline
  • Redesigned Pager and Poller abstractions
  • Pluggable async runtime support (no more hard Tokio dependency)
  • Cloud configuration (CloudConfig) for sovereign clouds
  • SecretBytes for credential handling
  • HTTP logging with sanitization
  • Sync response handling changes
  • OpenTelemetry tracing macro integration
  • Dependency version bumps and feature flag changes
  • Migration path for azure_sdk_core users (start from scratch)

Acceptance Criteria

  • Migration guide published in repo docs (e.g., docs/migration/azure_core.md)
  • Code samples for key scenarios: creating a custom pipeline policy, using Pager/Poller, configuring cloud endpoints
  • FAQ section covering common migration pitfalls
  • Linked from the azure_core crate README
  • Reviewed by SDK team

Metadata

Metadata

Assignees

No one assigned

    Labels

    Azure.CoreThe azure_core crateDocsrustPull requests that update Rust code

    Type

    No type

    Projects

    Status

    Untriaged

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions