適用于 Python 的 Azure 儲存體用戶端程式庫

用戶端套件 (12.X.X) - 最新

封裝名稱 參考 套件管理員 來源
儲存體 Blob 參考 PyPi GitHub
儲存體佇列 參考 PyPi GitHub
儲存體檔案共用 參考 PyPi GitHub
儲存體檔案 Data Lake (Preview) 參考 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 儲存體用戶端程式庫已知問題。

使用 Beta 版 SDK 時,InvalidHeaderValue 錯誤訊息

在少數情況下,升級至最新 Beta 版或正式推出 SDK 的應用程式可能會收到 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 版本,以查看問題是否已解決。 如果問題持續發生,或建議不可行, 請開啟支援票證 以探索進一步的選項。