Microsoft Azure Storage SDK for 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 Page.

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:

pip freeze

If you see azure==0.11.0 (or any version below 1.0), uninstall it first then install it again:

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.

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
• Table
  • Create/Read/Update/Delete Tables
  • Create/Read/Update/Delete Entities
  • Batch operations
  • Advanced Table Operations
• Files
  • Create/Update/Delete Shares
  • Create/Update/Delete Directories
  • Create/Read/Update/Delete Files
  • Advanced File Operations

Getting Started

Download

Option 1: Via PyPi

To install via the Python Package Index (PyPI), type:

pip install azure-storage

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
python setup.py install

Option 3: Source Zip

Download a zip of the code via GitHub or PyPi. Then, type:

cd ./azure-storage-python
python setup.py install

Minimum Requirements

• Python 2.7, 3.3, 3.4, or 3.5.
• See setup.py for dependencies

Usage

To use this SDK to call Microsoft Azure storage services, you need to first create an account.

Code Sample

See the samples directory for blob, queue, table, and file usage samples.

Need Help?

Be sure to check out the Microsoft Azure Developer Forums on MSDN or the Developer Forums on Stack Overflow if you have trouble with the provided code.

Contribute Code or Provide Feedback

If you would like to become an active contributor to this project, please follow the instructions provided in Azure Projects Contribution Guidelines. You can find more details for contributing in the CONTRIBUTING.md doc.

If you encounter any bugs with the library, please file an issue in the Issues section of the project.

Learn More

• Python Developer Center
• Azure Storage Service
• Azure Storage Team Blog
• API Reference