NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1200 most downloaded on PyPI
Microsoft Corporation Azure Storage File Share Client Library for Python
Last release 4 days ago
30 Sep 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 38 of 38 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
65 releases · first in 2019
This version and all future versions will require Python 3.10+. Python 3.9 is no longer supported.
This version and all future versions will require Python 3.10+. Python 3.9 is no longer supported.
azure-core Request/Response types will no longer be supported and may now cause errors if used. Please ensure custom transports are utilizing types from azure.core.rest.Deprecated ShareFileClient's get_ranges and get_ranges_diff APIs in favor of list_ranges and list_ranges_diff.
list_ranges and list_ranges_diff APIs to ShareFileClient which return an auto-paging iterable of
FileRange and support continuation tokens and results_per_page for enumerating file ranges across multiple
service responses.ShareFileClient's get_ranges and get_ranges_diff APIs in favor of list_ranges and
list_ranges_diff.One column per quarter.
Stable release of features from 12.26.0b1
Code | Docs Storage - Files Share azure-storage-file-share
Code | Docs
Storage - Files Share
azure-storage-file-share
file_property_semantics in ShareClient's create_directory and DirectoryClient's
create_directory APIs, which specifies permissions to be configured upon directory creation.data to FileClient's create_file API, which specifies the
optional initial data to be uploaded (up to 4MB).account_urls to accept URLs with -ipv6 and -dualstack suffixes
for ShareClient, ShareDirectoryClient, and ShareFileClient.max_concurrency=None by defaulting to the shared DEFAULT_MAX_CONCURRENCY constant.Code | Docs Support: Active
Code | Docs
Support: Active
logging_enable and logging_body keywords on a per-request
basis and with retries. Prior to this fix logging may have not behaved as expected, especially on retries.Added support for service version 2026-04-06.
user_delegation_tid to ShareServiceClient.get_user_delegation_key API, which
can be used in generate_share_sas and generate_file_sas to specify the Tenant ID that is authorized
to use the generated SAS URL. Note that user_delegation_tid must be used together with user_delegation_oid.azure-core dependency to 1.37.0.Stable release of features from 12.24.0b1
connection_data_block_size for all clients from 4 KiB to 256 KiB. This should result in
significantly better throughput on large file downloads for most environments.Added support for service version 2026-02-06.
get_user_delegation_key API to ShareServiceClient to obtain a user delegation key
for the purposes of signing SAS tokens.user_delegation_oid to generate_share_sas and generate_file_sas,
which specifies the Entra ID of the user that is authorized to use the generated SAS URL.user_delegation_key to generate_share_sas and generate_file_sas used with
user_delegation_oid to authenticate the request to generate a new SAS URL.encryption_in_transitin ShareSmbSettings used by set_service_properties
for the SMB protocol to specify whether encryption in transit is required.ShareFileClient.download_file via the decompress keyword.FileProperties and DirectoryProperties did not contain timezone information for
change_time, creation_time, and last_write_time attributes.Fixed MyPy attr-defined errors for ShareClient, ShareDirectoryClient, and ShareFileClient.
attr-defined errors for ShareClient, ShareDirectoryClient, and ShareFileClient.Stable release of features from 12.23.0b1
ShareClient's list_directories_and_files API specified with name_starts_with
would not return all results when the share contains a large number of files and directories.__enter__ and __exit__ attributes for all asynchronous client objects for raising explicit TypeError,
and let the AttributeError raise directly.This version and all future versions will require Python 3.9+. Python 3.8 is no longer supported.
This version and all future versions will require Python 3.9+. Python 3.8 is no longer supported.
Stable release of features from 12.22.0b1
Added support for service version 2025-07-05.
create_symbolic_link and get_symbolic_link APIs to ShareFileClient to
create/get symbolic links to specified files and is only supported for the NFS protocol.Stable release of features from 12.21.0b1
Added support for service version 2025-05-05.
owner, group, and file_mode options to
create_file, create_directory, set_http_headers (File and Directory), DirectoryProperties, and FileProperties.create_hard_link method to ShareFileClient to create hard links to specified
files and is only supported for the NFS protocol.create_file, create_directory, and set_http_headers (File and Directory) APIs no longer send
request headers x-ms-file-permission-key, x-ms-file-attributes, x-ms-file-creation-time, and
x-ms-file-last-write-time by default. The request headers have been optional in the REST API since
service version 2021-06-08. The default behavior of these APIs remain the same.Fixed an issue where custom transports may encounter AttributeError on certain requests.
AttributeError on certain requests.Stable release of features from 12.20.0b1
Added support for service version 2025-01-05.
Premium enum value in access_tier for create_share and set_share_properties APIs.file_permission_format to specify permission format for File's copy_file API.provisioned_iops and provisioned_bandwidth_mibps for
ShareClient and ShareServiceClient's create_share APIs; provisioned_max_iops and provisioned_max_bandwidth_mibps
for ShareClient's set_share_properties API; and retrieve included_burst_iop, max_burst_credits_for_iops,
next_provisioned_iops_downgrade and next_provisioned_bandwidth_downgrade through get_share_properties API.
ShareServiceClient's list_shares API returns the new properties through get_share_properties for each share.Updated type hints across the entire package and enabled MyPy to run during CI. Some public types may have been adjusted if they were previously erron
Stable release of features from 12.18.0b1
Code | Docs Synapse - AccessControl azure-synapse-accesscontrol
Code | Docs
Synapse - AccessControl
azure-synapse-accesscontrol
paid_bursting_enabled, paid_bursting_bandwidth_mibps, and paid_bursting_iops for Share's
create_share and set_share_properties APIs, and also retrieve them on the get_share_properties API.file_permission_format to specify permission format for Share's create_permission_for_share and
get_permission_for_share APIs; File's create_file, rename_file, and set_http_headers APIs; and
Directory's rename_directory and set_http_headers APIs.azure-core dependency to 1.30.0.Code | Docs Support: Active
Code | Docs
Support: Active
Added a more descriptive authorization error message when facing authorization errors.
Stable release of features from 12.16.0b1
This version and all future versions will require Python 3.8+. Python 3.7 is no longer supported.
This version and all future versions will require Python 3.8+. Python 3.7 is no longer supported.
exists method to ShareFileClient to check if a file exists.services parameter has been added to the generate_account_sas API, which enables the ability to generate SAS
tokens to be used with multiple services. By default, the SAS token service scope will default to the current service.client_name property to Handle.support_rename to get_ranges_diff()ShareDirectoryClient returned by get_subdirectory_client with a ShareDirectoryClient
pointing to the root of the file share would raise an InvalidResourceName on any operations.typing-extensions to >=4.6.0 to avoid potential TypeError with typing.TypeVar on
Python 3.12.AttributeError instead of ClientAuthenticationError when
using async OAuth credentials.delete_snapshots to delete_share API did not support all possible enums. This change
makes delete_snapshots now accept string literals 'include' and 'include-leased'.InvalidHeaderValue due to improper precision parsing.Stable release of features from 12.15.0b1
Added support for service version 2023-11-03.
audience as an optional keyword that can be specified on APIs that have a credential parameter. This
keyword only has an effect when the credential provided is of type TokenCredential.Fixed an issue when an invalid type was provided for credential during client construction, the __str__ of the object would be present in the exceptio
credential during client construction, the
__str__ of the object would be present in the exception message and therefore potentially logged.Fixed breaking KeyError: 'sdk_moniker' in create_configuration. NOTE: This is not an exported method and therefore should not be imported/called direc
KeyError: 'sdk_moniker' in create_configuration.
NOTE: This is not an exported method and therefore should not be imported/called directly.Stable release of features from 12.14.0b1
Added support for service versions 2023-05-03 and 2023-08-03.
Stable release of features from 12.13.0b1
Added support for service version 2023-01-03.
access_rights property to Handle.Stable release of features from 12.12.0b1
Added support for service version 2022-11-02.
TokenCredential to be used for authentication. A TokenCredential can be provided for the
credential parameter to any client constructor. Note: When using a TokenCredential, the new keyword parameter
token_intent is required and must be provided. Additionally, this form of authentication is only supported for
certain operations in the Data Plane SDK.allow_trailing_dot and allow_source_trailing_dot on client construction. When
allow_trailing_dot is provided, the service will not silently remove any trailing . character from directory/file
names for all operations made from that client. allow_source_trailing_dot will apply this same rule to source files
when performing a rename or copy operation.Fixed "duplicate type signatures" MyPy error.
Stable release of features from 12.11.0b1
Added support for service version 2021-12-02.
AsyncIterable as data type for async file upload.name_starts_with was not being passed to the service properly for the list_shares async APImsrest dependency.typing-extensions>=4.0.1 as a dependency.isodate>=0.6.1 as a dependency.aio for installing optional async dependencies. Use pip install azure-storage-file-share[aio] to install.Fixed possible ValueError for invalid content range that gets raised when downloading empty files through Azurite.
ValueError for invalid content range that gets raised when downloading empty files through Azurite.Stable release of features from 12.10.0b1.
download_file with an invalid base64-encoded account key would raise an
AttributeError rather than the proper AzureSigningError.read_timeout to 60 seconds for all clients.This version and all future versions will require Python 3.7+. Python 3.6 is no longer supported.
This version and all future versions will require Python 3.7+. Python 3.6 is no longer supported.
AzureNamedKeyCredential as a valid credential type.Stable release of features from 12.9.0b1.
upload_file() and download_file() via a new optional callback, progress_hook.Added support for file_change_time to start_copy_from_url API
file_change_time to start_copy_from_url APIStable release of features from 12.8.0b1.
Added support for service version 2021-06-08.
create_directory() including file_attributes, file_creation_time,
file_last_write_time, file_permission and file_permission_key.content_type on rename_file().file_change_time on create_directory(), set_http_headers() (directory)
rename_directory(), create_file(), set_http_headers() (file) and rename_file().file_last_write_mode on upload_range() and upload_range_from_url()
with possible values of Now or Preserve.create_share() docstring to have the correct return-type of NoneCode | Docs Text Analytics azure-ai-textanalytics
Code | Docs
Text Analytics
azure-ai-textanalytics
This version and all future versions will require Python 3.6+. Python 2.7 is no longer supported.
exists().rename_directory() and rename_file().Create (c) SAS permission for Share SAS.start_copy_from_url() was not sending the ignore_read_only parameter correctly.This version and all future versions will require Python 3.6+. Python 2.7 is no longer supported.
This version and all future versions will require Python 3.6+. Python 2.7 is no longer supported.
rename_directory() and rename_file().Create (c) SAS permission for Share SAS.azure-core dependency to avoid inconsistent dependencies from being installed.generate_account_sas()
was not generating the proper SAS signature.Added support for service version 2021-02-12.
exists().Stable release of preview features
Stable release of preview features
Added OAuth support for file copy source.
New features
Fixes
Added support for lease operation on a share, eg. acquire_lease
New features
Added support for lease operation on a share, eg. acquire_lease
New features
Make AccountName, AccountKey etc. in conn_str case insensitive
Fixes
AccountName, AccountKey etc. in conn_str case insensitivedownloader.chunks() return chunks in different size (#9419, #15648)ThreadPoolExecutor (#8955)Fixes - Fixed msrest dependency issue
Fixes
Stable release of preview features
Stable release of preview features
AzureSasCredential to allow SAS rotation in long living clients.Added support for enabling root squash and share protocols for file share.
New features
Stable release of preview features
Stable release of preview features
get_ranges on ShareFileClientNew features
set_share_properties which allows setting share tier.Notes
azure-core from azure-core<2.0.0,>=1.2.2 to azure-core<2.0.0,>=1.9.0 to get continuation_token attr on AzureError.Added support for enabling SMB Multichannel for the share service.
New features
Stable release of preview features
Stable release of preview features
undelete_share on FileShareServiceClient.Added undelete_share on FileShareServiceClient so that users can restore deleted share on share soft delete enabled account. Users can also list delet
New features
undelete_share on FileShareServiceClient so that users can restore deleted share on share soft delete enabled account. Users can also list deleted shares when list_shares by specifying include_deleted=True.Your coding agent can read these notes before it upgrades. Set up the MCP server →