你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

适用于 Python 的 Azure 存储客户端库

(12.X.X) 的客户端包 - 最新

包名称	参考	包管理器	源
存储 Blob	引用	PyPi	GitHub
存储队列	引用	PyPi	GitHub
存储文件共享	引用	PyPi	GitHub
存储文件 Data Lake (预览版)	引用	PyPi	GitHub

(2.X.X) 的客户端包 - 旧版

包名称	参考	包管理器	源
存储 Blob	引用	PyPi	GitHub
存储队列	引用	PyPi	GitHub
存储文件共享	引用	PyPi	GitHub

管理

包名称	参考	包管理器	源
存储管理	引用	PyPi	GitHub

安装库

客户端

Azure 存储客户端库由 3 个包组成：Blob、文件共享和队列。 若要安装 Blob 包，请运行：

pip install azure-storage-blob

管理

pip install azure-mgmt-storage

示例

项目	说明
在 Python 中开始使用 Azure Blob 存储	在 Azure 存储中创建、读取、更新、限制访问和删除文件与对象。
管理 Azure 存储帐户	创建、更新和删除存储帐户。 检索和重新生成存储帐户访问密钥。

详细了解可在应用中使用的示例 Python 代码。

已知问题

本部分详细介绍适用于 Python 的 Azure 存储客户端库的已知问题。

使用 SDK Beta 版本时出现 InvalidHeaderValue 错误消息

在极少数情况下，已升级到 SDK 的最新 beta 版本或正式发布版本的应用程序可能会收到 InvalidHeaderValue 错误消息。 使用任何存储库时，都可能发生此问题。 错误消息类似于以下示例：

HTTP/1.1 400 The value for one of the HTTP headers is not in the correct format.
Content-Length: 328
Content-Type: application/xml
Server: Microsoft-HTTPAPI/2.0
x-ms-request-id: <REMOVED>
Date: Fri, 19 May 2023 17:10:33 GMT
 
<?xml version="1.0" encoding="utf-8"?><Error><Code>InvalidHeaderValue</Code><Message>The value for one of the HTTP headers is not in the correct format.
RequestId:<REMOVED>
Time:2023-05-19T17:10:34.2972651Z</Message><HeaderName>x-ms-version</HeaderName><HeaderValue>yyyy-mm-dd</HeaderValue></Error> 

如果已升级到最新的 Beta 版或正式版 SDK，但遇到此错误，建议降级到以前正式发布的 SDK 版本，以查看问题是否得到解决。 如果问题仍然存在，或者如果建议不可行， 请开具支持票证 以探索更多选项。