Microsoft Azure SDK for Python

This is the Microsoft Azure Storage Management Client Library. This package has been tested with Python 3.9+. For a more complete view of Azure libraries, see the azure sdk python release.

Disclaimer

Azure SDK Python packages support for Python 2.7 has ended 01 January 2022. For more information and questions, please refer to https://github.com/Azure/azure-sdk-for-python/issues/20691

Getting started

Prerequisites

• Python 3.9+ is required to use this package.
• Azure subscription

Install the package

pip install azure-mgmt-storage
pip install azure-identity

Authentication

By default, Azure Active Directory token authentication depends on correct configuration of the following environment variables.

• AZURE_CLIENT_ID for Azure client ID.
• AZURE_TENANT_ID for Azure tenant ID.
• AZURE_CLIENT_SECRET for Azure client secret.

In addition, Azure subscription ID can be configured via environment variable AZURE_SUBSCRIPTION_ID.

With above configuration, client can be authenticated by following code:

from azure.identity import DefaultAzureCredential
from azure.mgmt.storage import StorageManagementClient
import os

sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
client = StorageManagementClient(credential=DefaultAzureCredential(), subscription_id=sub_id)

Examples

Code samples for this package can be found at:

• Search Storage Management on docs.microsoft.com
• Azure Python Mgmt SDK Samples Repo

Troubleshooting

Next steps

Provide Feedback

If you encounter any bugs or have suggestions, please file an issue in the Issues section of the project.

Release History

24.0.0 (2025-10-22)

Features Added

• Model StorageManagementClient added parameter cloud_setting in method __init__
• Model ObjectReplicationPolicy added property priority_replication
• Model StorageAccount added property geo_priority_replication_status
• Model StorageAccountCreateParameters added property geo_priority_replication_status
• Model StorageAccountUpdateParameters added property geo_priority_replication_status
• Added model GeoPriorityReplicationStatus
• Added model ObjectReplicationPolicyPropertiesPriorityReplication

Breaking Changes

• Method StorageTaskAssignmentsOperations.list renamed its parameter from maxpagesize to top

23.1.0 (2025-09-22)

Features Added

• Model AzureFilesIdentityBasedAuthentication added property smb_o_auth_settings
• Model Endpoints added property ipv6_endpoints
• Model NetworkRuleSet added property ipv6_rules
• Model ProtocolSettings added property nfs
• Model SkuInformation added property location_info
• Model SmbSetting added property encryption_in_transit
• Model StorageAccount added property zones
• Model StorageAccount added property placement
• Model StorageAccount added property dual_stack_endpoint_preference
• Model StorageAccountCreateParameters added property zones
• Model StorageAccountCreateParameters added property placement
• Model StorageAccountCreateParameters added property dual_stack_endpoint_preference
• Model StorageAccountUpdateParameters added property zones
• Model StorageAccountUpdateParameters added property placement
• Model StorageAccountUpdateParameters added property dual_stack_endpoint_preference
• Added model DualStackEndpointPreference
• Added model EncryptionInTransit
• Added enum IntervalUnit
• Added model NfsSetting
• Added model Placement
• Added model SkuInformationLocationInfoItem
• Added model SmbOAuthSettings
• Added model StorageAccountIpv6Endpoints
• Added enum ZonePlacementPolicy

23.0.1 (2025-06-30)

Other Changes

• Fix for StorageTaskAssignmentsOperations

23.0.0 (2025-05-15)

Breaking Changes

• This package now only targets the latest Api-Version available on Azure and removes APIs of other Api-Version. After this change, the package can have much smaller size. If your application requires a specific and non-latest Api-Version, it's recommended to pin this package to the previous released version; If your application always only use latest Api-Version, please ignore this change.

22.2.0 (2025-04-21)

Features Added

• Enum ProvisioningState added member ACCEPTED

22.1.1 (2025-02-27)

Bugs Fixed

• Fix deserialization error for model FileShare and FileShareItem

22.1.0 (2025-02-19)

Features Added

• Added operation FileServicesOperations.get_service_usage
• Added operation FileServicesOperations.list_service_usages
• Model FileShare has a new parameter file_share_paid_bursting
• Model FileShare has a new parameter included_burst_iops
• Model FileShare has a new parameter max_burst_credits_for_iops
• Model FileShare has a new parameter next_allowed_provisioned_bandwidth_downgrade_time
• Model FileShare has a new parameter next_allowed_provisioned_iops_downgrade_time
• Model FileShare has a new parameter next_allowed_quota_downgrade_time
• Model FileShare has a new parameter provisioned_bandwidth_mibps
• Model FileShare has a new parameter provisioned_iops
• Model FileShareItem has a new parameter file_share_paid_bursting
• Model FileShareItem has a new parameter included_burst_iops
• Model FileShareItem has a new parameter max_burst_credits_for_iops
• Model FileShareItem has a new parameter next_allowed_provisioned_bandwidth_downgrade_time
• Model FileShareItem has a new parameter next_allowed_provisioned_iops_downgrade_time
• Model FileShareItem has a new parameter next_allowed_quota_downgrade_time
• Model FileShareItem has a new parameter provisioned_bandwidth_mibps
• Model FileShareItem has a new parameter provisioned_iops
• Model ObjectReplicationPolicy has a new parameter metrics
• Enum SkuName added member STANDARD_V2_LRS
• Enum SkuName added member STANDARD_V2_GRS
• Enum SkuName added member STANDARD_V2_ZRS
• Enum SkuName added member STANDARD_V2_GZRS
• Enum SkuName added member PREMIUM_V2_LRS
• Enum SkuName added member PREMIUM_V2_ZRS

22.0.0 (2025-01-15)

Breaking Changes

• Removed subfolders of some unused Api-Versions for smaller package size. If your application requires a specific and non-latest Api-Version, it's recommended to pin this package to the previous released version; If your application always only use latest Api-Version, please ignore this change.
• Removed operation UsageOperations.list_by_location

21.2.1 (2024-06-27)

Bugs Fixed

• Fix signature maxpagesize type of Operation StorageTaskAssignmentInstancesReportOperations.list from str to int
• Fix signature maxpagesize type of Operation StorageTaskAssignmentsInstancesReportOperations.list from str to int
• Fix signature maxpagesize type of Operation StorageTaskAssignmentsOperations.list from str to int

21.2.0 (2024-06-17)

Features Added

• Added operation group NetworkSecurityPerimeterConfigurationsOperations
• Added operation group StorageTaskAssignmentInstancesReportOperations
• Added operation group StorageTaskAssignmentsInstancesReportOperations
• Added operation group StorageTaskAssignmentsOperations
• Model LocalUser has a new parameter allow_acl_authorization
• Model LocalUser has a new parameter extended_groups
• Model LocalUser has a new parameter group_id
• Model LocalUser has a new parameter is_nf_sv3_enabled
• Model LocalUser has a new parameter user_id
• Model LocalUsers has a new parameter next_link
• Model StorageAccount has a new parameter enable_extended_groups
• Model StorageAccountCreateParameters has a new parameter enable_extended_groups
• Model StorageAccountUpdateParameters has a new parameter enable_extended_groups
• Operation LocalUsersOperations.list has a new optional parameter filter
• Operation LocalUsersOperations.list has a new optional parameter include
• Operation LocalUsersOperations.list has a new optional parameter maxpagesize

21.1.0 (2023-08-18)

Features Added

• Added operation StorageAccountsOperations.begin_customer_initiated_migration
• Added operation StorageAccountsOperations.get_customer_initiated_migration
• Model BlobInventoryPolicyFilter has a new parameter creation_time
• Model GeoReplicationStats has a new parameter can_planned_failover
• Model GeoReplicationStats has a new parameter post_failover_redundancy
• Model GeoReplicationStats has a new parameter post_planned_failover_redundancy
• Model StorageAccount has a new parameter account_migration_in_progress
• Model StorageAccount has a new parameter is_sku_conversion_blocked

21.1.0b1 (2023-02-20)

Other Changes

• Added generated samples in github repo
• Drop support for python<3.7.0

21.0.0 (2022-11-15)

Features Added

• Model ManagementPolicyBaseBlob has a new parameter tier_to_cold
• Model ManagementPolicyBaseBlob has a new parameter tier_to_hot
• Model ManagementPolicySnapShot has a new parameter tier_to_cold
• Model ManagementPolicySnapShot has a new parameter tier_to_hot
• Model ManagementPolicyVersion has a new parameter tier_to_cold
• Model ManagementPolicyVersion has a new parameter tier_to_hot

Breaking Changes

• Operation EncryptionScopesOperations.list has a new parameter filter
• Operation EncryptionScopesOperations.list has a new parameter include
• Operation EncryptionScopesOperations.list has a new parameter maxpagesize
• Operation StorageAccountsOperations.begin_failover has a new