---
id: azure-storage-file-share
version: "12.26.0"
license: MIT License
license_treatment: permissive
maintenance: active
---

# azure-storage-file-share — Microsoft Azure Azure File Share Storage Client Library for Python

License: permissive · Maintenance: active · Downloads: 19.4M/mo

## 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 above — 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

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

- License: MIT License (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 19.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

azure file share client, cloud file storage python, smb protocol azure, azure storage sdk, managed file shares, azure file sync, cloud file management, azure-sdk, cloud-storage, file-sharing

[View on SkillFed](https://skillfed.io/packages/azure-storage-file-share) · [View on PyPI](https://pypi.org/project/azure-storage-file-share/)