Microsoft Azure Storage File Client Library for Python
项目描述
Microsoft Azure Storage SDK for Python
此项目提供了一个Python客户端库,简化了对Microsoft Azure Storage服务的使用。有关文档,请参阅Microsoft Azure Python开发者中心 和我们的 API参考(也可在readthedocs上找到)。
如果您正在寻找Service Bus或Azure管理库,请访问https://github.com/Azure/azure-sdk-for-python。
兼容性
重要:如果您有azure包的早期版本(版本 < 1.0),在安装此包之前应先卸载它。
您可以使用pip检查版本
pip freeze
如果您看到azure==0.11.0(或任何低于1.0的版本),请先卸载它,然后再重新安装
pip uninstall azure
pip install azure
如果您是从低于0.30.0的版本升级,请参阅升级文档、samples目录中的使用示例以及ChangeLog和BreakingChanges。
如果您在安装Azure存储时遇到问题,升级pip可能有所帮助。
重要:如果您安装了 azure-storage 包的早期版本(版本 <= 0.36.0),在安装新拆分包之前,您应该先卸载它。
您可以使用pip检查版本
pip freeze
如果您看到 azure-storage==0.36.0(或任何低于 0.36.0 的版本),请先卸载它。
pip uninstall azure-storage
功能
块
创建/读取/更新/删除容器
创建/读取/更新/删除块
高级块操作
队列
创建/删除队列
插入/查看队列消息
高级队列操作
文件
创建/更新/删除共享
创建/更新/删除目录
创建/读取/更新/删除文件
高级文件操作
入门
下载
Python 的 Azure 存储 SDK 由 5 个包组成
azure-storage-blob
包含块服务 API。
azure-storage-file
包含文件服务 API。
azure-storage-queue
包含队列服务 API。
azure-storage-common
包含块、文件和队列共享的公共代码。
azure-storage-nspkg
拥有 azure.storage 命名空间,用户不应直接使用此包。
注意:在版本 0.36.0 及之前,曾经有一个包含所有服务的单个包(azure-storage)。它不再受支持,并且根据需要,用户应单独安装上述 3 个服务包。另外,表 包不再在 azure-storage 命名空间下发布,请参阅 cosmosdb。
选项 1:通过 PyPi
要通过 Python 包索引(PyPI)安装,请键入
pip install azure-storage-blob pip install azure-storage-file pip install azure-storage-queue
选项 2:通过 Git 获取源代码
要使用 git 获取 SDK 的源代码,请键入
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
将 azure-storage-blob 替换为 azure-storage-file 或 azure-storage-queue,以安装其他服务。
选项 3:源代码 Zip 文件
通过 GitHub 或 PyPi 下载代码的 zip 文件。然后按照选项 2 中的相同说明进行操作。
最低要求
Python 2.7、3.3、3.4、3.5 或 3.6。
请参阅 setup.py 以获取依赖项
用法
要使用此 SDK 调用 Microsoft Azure 存储服务,您需要首先 创建一个账户。
日志记录
为了简化调试,建议开启名为 'azure.storage' 的日志记录器的日志记录。以下是两个示例配置
# Basic configuration: configure the root logger, including 'azure.storage'
logging.basicConfig(format='%(asctime)s %(name)-20s %(levelname)-5s %(message)s', level=logging.INFO)
# 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)
以下是我们的日志记录级别使用方法,建议使用 INFO
DEBUG:记录签名字符串
INFO:记录出站请求和响应,以及重试尝试
WARNING:未使用
ERROR:记录所有重试后仍然失败的调用
代码示例
请参阅 samples 目录以获取块、队列和文件使用示例。
需要帮助?
如果您在使用提供的代码时遇到问题,请务必查看 Microsoft Azure MSDN 开发者论坛 或 Stack Overflow 开发者论坛。
贡献代码或提供反馈
如果您想成为此项目的积极贡献者,请按照 Azure 项目贡献指南 中提供的说明操作。您可以在 CONTRIBUTING.md 文档 中找到有关贡献的更多详细信息。
如果您在库中遇到任何错误,请在项目的 问题 部分中提交一个问题。
了解更多
项目详情
下载文件
下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。
源代码分发
构建分发
哈希值 for azure_storage_file-2.1.0-py2.py3-none-any.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 07e01b6b1ccbac97946a3abab773fdc4904965577c3afa0151e786c463bd7260 |
|
MD5 | bd480cfa188d55a02b184a48795a6d6a |
|
BLAKE2b-256 | e030e7ce72375b8982fb093fad7eb9bdb5c4b6165bf94e9f4087aca538927f99 |