Install & Compatibility
Where this runs
tested against v1.6.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 59.8MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 4.8s · import 0.000s · 60MB
60MB installed
● package 60MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
BlobServiceClient
✓ from azure.multiapi.storage.v2022_11_02.blob import BlobServiceClient
✗ from azure.multiapi.storage.v2022_11_02.blob import BlobServiceClient
This quickstart demonstrates how to initialize a `BlobServiceClient` using a specific API version (`v2022_11_02`) and list blob containers. Ensure you have the `AZURE_STORAGE_CONNECTION_STRING` environment variable set with your Azure Storage account connection string.
import os
from azure.multiapi.storage.v2022_11_02.blob import BlobServiceClient
connection_string = os.environ.get('AZURE_STORAGE_CONNECTION_STRING', 'DefaultEndpointsProtocol=https;AccountName=test;AccountKey=test;EndpointSuffix=core.windows.net')
if connection_string == 'DefaultEndpointsProtocol=https;AccountName=test;AccountKey=test;EndpointSuffix=core.windows.net':
print("WARNING: AZURE_STORAGE_CONNECTION_STRING not set. Using dummy connection string. This will likely fail.")
try:
# Create a BlobServiceClient with the specified API version
blob_service_client = BlobServiceClient.from_connection_string(connection_string)
# List containers (example operation)
print("Listing blob containers:")
for container in blob_service_client.list_containers(name_starts_with="my"): # Add name_starts_with for faster results if many containers
print(f"- {container['name']}")
except Exception as e:
print(f"An error occurred: {e}")
print("Ensure AZURE_STORAGE_CONNECTION_STRING is set and valid, and containers exist.")
Debug
Known issues
breakingEach release of `azure-multiapi-storage` frequently removes support for older Azure Storage API versions. For example, version 1.7.0b1 removes several older API versions for blob, fileshare, filedatalake, and queue services. Relying on a specific older API version means you might encounter breaking changes upon upgrading the library.fixAlways check release notes before upgrading and update your import paths (e.g., `from azure.multiapi.storage.vYYYY_MM_DD.blob import ...`) to use currently supported API versions. Pin your `azure-multiapi-storage` version if you need to stick to an older API.
affects: 1.0.0+
breakingVersion 1.5.0 of `azure-multiapi-storage` completely removed all 'Track 1' (older) SDKs. If your application was using these older APIs indirectly through this library, an upgrade to 1.5.0 or later will cause import and runtime errors.fixMigrate your code to use the 'Track 2' SDK patterns provided by `azure-multiapi-storage`, which involve explicit API versioning in the import paths (e.g., `v2021_08_06`).
affects: 1.5.0+
gotchaUsing `pip install --pre azure-multiapi-storage` to install preview/beta versions (e.g., `1.7.0b1`) can lead to very rapid and breaking API version changes between beta releases. New API versions are often introduced alongside the immediate removal of older ones in these pre-releases.fixAvoid using `--pre` for production environments. If testing new features, be prepared for frequent breaking changes and carefully review the release notes for each beta version you use.
affects: All preview/beta versions
gotchaThe `azure-multiapi-storage` library does not automatically handle API version negotiation or fallback. You must explicitly specify the desired Azure Storage API version in your import statements (e.g., `from azure.multiapi.storage.v2022_11_02.blob import ...`). Failing to do so, or using direct imports like `from azure.storage.blob import ...`, will bypass the multi-api functionality.fixAlways include the `vYYYY_MM_DD` segment in your import paths to correctly leverage the multi-API versioning capabilities of this library.
affects: All versions
Upgrade
Version history
1.6.0latest on PyPI · released Sep 28, 2025
Audit
Dependencies
azure-storage-blobrequiredCore functionality for Blob Storage service.
azure-storage-queuerequiredCore functionality for Queue Storage service.
azure-storage-file-sharerequiredCore functionality for File Share service.
azure-storage-file-datalakerequiredCore functionality for Data Lake Storage service.