你当前正在访问 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 版本，以查看问题是否得到解决。 如果问题仍然存在，或者如果建议不可行， 请开具支持票证 以探索更多选项。
