# azure-storage-common > Microsoft Azure Storage Common Client Library for Python - **URL**: https://www.freshcrate.ai/projects/azure-storage-common - **Author**: Microsoft Corporation - **Category**: Databases - **Latest version**: `2.1.0` (2026-04-21) - **License**: MIT License - **Source**: https://github.com/Azure/azure-storage-python - **Language**: Python - **GitHub**: 340 stars, 241 forks - **Registry**: pypi (`azure-storage-common`) - **Tags**: `pypi` ## Description Microsoft Azure Storage SDK for Python ====================================== .. image:: https://travis-ci.org/Azure/azure-storage-python.svg :target: https://travis-ci.org/Azure/azure-storage-python .. image:: https://img.shields.io/codecov/c/github/azure/azure-storage-python.svg :target: https://codecov.io/gh/Azure/azure-storage-python This project provides a client library in Python that makes it easy to consume Microsoft Azure Storage services. For documentation please see the Microsoft Azure `Python Developer Center`_ and our `API Reference`_ (also available on `readthedocs`_). If you are looking for the Service Bus or Azure Management libraries, please visit https://github.com/Azure/azure-sdk-for-python. Compatibility ============= **IMPORTANT**: If you have an earlier version of the azure package (version < 1.0), you should uninstall it before installing this package. You can check the version using pip: .. code:: shell pip freeze If you see azure==0.11.0 (or any version below 1.0), uninstall it first then install it again: .. code:: shell pip uninstall azure pip install azure If you are upgrading from a version older than 0.30.0, see the upgrade doc, the usage samples in the samples directory, and the ChangeLog and BreakingChanges. If you are encountering `problems`_ installing azure storage on Azure Web Apps, `upgrading pip`_ might help. **IMPORTANT**: If you have an earlier version of the azure-storage package (version <= 0.36.0), you should uninstall it before installing the new split packages. You can check the version using pip: .. code:: shell pip freeze If you see azure-storage==0.36.0 (or any version below 0.36.0), uninstall it first: .. code:: shell pip uninstall azure-storage Features ======== - Blob - Create/Read/Update/Delete Containers - Create/Read/Update/Delete Blobs - Advanced Blob Operations - Queue - Create/Delete Queues - Insert/Peek Queue Messages - Advanced Queue Operations - Files - Create/Update/Delete Shares - Create/Update/Delete Directories - Create/Read/Update/Delete Files - Advanced File Operations Getting Started =============== Download -------- The Azure Storage SDK for Python is composed of 5 packages: - azure-storage-blob - Contains the blob service APIs. - azure-storage-file - Contains the file service APIs. - azure-storage-queue - Contains the queue service APIs. - azure-storage-common - Contains common code shared by blob, file and queue. - azure-storage-nspkg - Owns the azure.storage namespace, user should not use this directly. **Note**: prior to and including version 0.36.0, there used to be a single package (azure-storage) containing all services. It is no longer supported, and users should install the 3 before-mentioned service packages individually, depending on the need. In addition, the **table** package is no longer releasing under the azure-storage namespace, please refer to `cosmosdb`_. Option 1: Via PyPi ~~~~~~~~~~~~~~~~~~ To install via the Python Package Index (PyPI), type: :: pip install azure-storage-blob pip install azure-storage-file pip install azure-storage-queue Option 2: Source Via Git ~~~~~~~~~~~~~~~~~~~~~~~~ To get the source code of the SDK via git just type: :: git clone git://github.com/Azure/azure-storage-python.git cd ./azure-storage-python/azure-storage-nspkg python setup.py install cd ../azure-storage-common python setup.py install cd ../azure-storage-blob python setup.py install Replace azure-storage-blob with azure-storage-file or azure-storage-queue, to install the other services. Option 3: Source Zip ~~~~~~~~~~~~~~~~~~~~ Download a zip of the code via GitHub or PyPi. Then follow the same instructions in option 2. Minimum Requirements -------------------- - Python 2.7, 3.3, 3.4, 3.5, or 3.6. - See setup.py for dependencies Usage ----- To use this SDK to call Microsoft Azure storage services, you need to first `create an account`_. Logging ----------- To make debugging easier, it is recommended to turn on logging for the logger named 'azure.storage'. Here are two example configurations: .. code:: python # Basic configuration: configure the root logger, including 'azure.storage' logging.basicConfig(format='%(asctime)s %(name)-20s %(levelname)-5s %(message)s', level=logging.INFO) .. code:: python # More advanced configuration allowing more control logger = logging.getLogger('azure.storage') handler = logging.StreamHandler() formatter = logging.Formatter('%(asctime)s %(name)-20s %(levelname)-5s %(message)s') handler.setFormatter(formatter) logger.addHandler(handler) logger.setLevel(logging.INFO) Here is how we use the logging levels, it is recommended to use INFO: - DEBUG: log strings to sign - INFO: log outgoing requests and responses, as well as retry attempts - WARNING: not used - ERROR: log ## Recent releases | Version | Date | Urgency | Changes | | --- | --- | --- | --- | | `2.1.0` | 2026-04-21 | Low | Imported from PyPI (2.1.0) | | `v2.1.0-blob` | 2019-08-02 | Low | - Support for 2019-02-02 REST version. Please see our REST API documentation and blog for information about the related added features. - Added Batch Delete Blob API. - Added Batch Set Standard Blob Tier API(for BlockBlob). - Added support to set rehydrate blob priority for Set Standard Blob Tier API - Added Blob Tier support for PutBlob/PutBlockList/CopyBlob APIs. - Added support for client provided encryption key to numerous APIs. | | `v2.1.0-file` | 2019-08-02 | Low | - Support for 2019-02-02 REST version. Please see our REST API documentation and blog for information about the related added features. - Added update_range_from_file_url API to writes the bytes from one Azure File endpoint into the specified range of another Azure File endpoint. - Added set_directory_properties, create_permission_for_share and get_permission_for_share APIs - Added optional parameters(file_permission, smb_properties) for create_file*, create_directory* related APIs and set_fi | | `v2.1.0-queue` | 2019-08-02 | Low | - Support for 2019-02-02 REST version. No new features for Queue. | | `v2.1.0-queue` | 2019-08-02 | Low | - Support for 2019-02-02 REST version. No new features for Queue. | | `v2.1.0-queue` | 2019-08-02 | Low | - Support for 2019-02-02 REST version. No new features for Queue. | | `v2.1.0-queue` | 2019-08-02 | Low | - Support for 2019-02-02 REST version. No new features for Queue. | | `v2.1.0-queue` | 2019-08-02 | Low | - Support for 2019-02-02 REST version. No new features for Queue. | | `v2.1.0-queue` | 2019-08-02 | Low | - Support for 2019-02-02 REST version. No new features for Queue. | | `v2.1.0-queue` | 2019-08-02 | Low | - Support for 2019-02-02 REST version. No new features for Queue. | ## Dependency audit - **Score**: 87/100 - **Total deps**: 7 - **Resolved**: 6 - **Unresolved**: 1 - **License conflicts**: 0 - **Warnings**: 5 - **Scanned**: 2026-05-25 ## Citation - HTML: https://www.freshcrate.ai/projects/azure-storage-common - Markdown: https://www.freshcrate.ai/projects/azure-storage-common.md - Dependencies JSON: https://www.freshcrate.ai/api/projects/azure-storage-common/deps _Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._