azure-storage-file-share

What it is and what it does

This is the official Python client library for Azure File Share storage, part of the Azure SDK. It provides a programmatic interface to interact with fully managed file shares hosted in Azure, accessible via the standard SMB protocol. You can work with storage accounts, file shares, directories, and individual files up to 1 TiB in size.

The library supports multiple authentication methods (shared keys, SAS tokens, and other credential types) and offers both synchronous and asynchronous APIs. It's designed for scenarios like replacing on-premises file servers, migrating applications to the cloud, or sharing configuration and diagnostic data across cloud and on-premises deployments. The package is production-stable, actively maintained, and part of the official Azure SDK ecosystem.

Use it for:

• Replace on-premises file servers with cloud-hosted shares accessible from multiple operating systems.
• Store and retrieve shared application configuration, diagnostic logs, and dev/test artifacts in the cloud.
• Implement 'lift and shift' migrations by mounting Azure file shares in existing applications.
• Cache frequently accessed files on Windows Servers using Azure File Sync for local performance.
• Programmatically manage file shares, directories, and permissions in automated deployment pipelines.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Interact with Azure File Share storage—create, read, update, and delete files and directories in cloud-hosted SMB file shares accessible from Windows, Linux, and macOS.

Yes. This is a production-stable, actively maintained official Azure SDK library with no known vulnerabilities, low install friction, and permissive licensing. Install it if you need to work with Azure File Share storage from Python—it's the standard way to do so. No gotchas for typical use cases.

Install

azure-storage-file-share on PyPI

pip install azure-storage-file-share

uv add azure-storage-file-share

poetry add azure-storage-file-share

Installing azure-storage-file-share

Before you install

Low install friction with a pure-Python wheel. Actively maintained with recent releases; last commit 2026-08-14. Depends on azure-core, cryptography, typing-extensions, and isodate—all standard Azure SDK components.

License in practice

MIT License (permissive). You may use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install azure-storage-file-share

from azure.storage.fileshare import ShareServiceClient

service = ShareServiceClient(
    account_url="https://<account>.file.core.windows.net/",
    credential="<account_key_or_sas_token>"
)

Requires Python 3.9 or later. You must have an Azure subscription and a pre-configured storage account with file service endpoint.

Verify before relying

• Whether async support requires aiohttp or another specific transport library to be installed separately.
• Maximum file size and share capacity limits beyond the 1 TiB per-file mention in the description.

Package facts

Evidence: azure_storage_file_share-12.26.0-py3-none-any.whl

Keywords: azure, azure sdk

Tags

More Internet packages