適用于 Python 的 Azure Purview 帳戶用戶端程式庫 - 1.0.0b1 版
Azure Purview 帳戶是完全受控的雲端服務。
| 原始程式碼套件 (PyPI) | API 參考檔| 產品檔
開始使用
Prerequisites
建立 Purview 資源
請遵循 這些 指示來建立 Purview 資源
安裝套件
使用 pip安裝適用于 Python 的 Azure Purview 帳戶用戶端程式庫:
pip install azure-purview-account
驗證用戶端
若要使用 Azure Active Directory (AAD) 權杖認證,請提供從 azure 身 分識別程式庫取得所需認證類型的實例。
若要使用 AAD 進行驗證,您必須先在Purview 資源上安裝azure-identity
並啟用 AAD 驗證
安裝之後,您可以選擇要使用的 azure.identity 認證類型 。 例如, DefaultAzureCredential 可用來驗證用戶端:
將 AAD 應用程式的用戶端識別碼、租使用者識別碼和用戶端密碼的值設定為環境變數:AZURE_CLIENT_ID、AZURE_TENANT_ID、AZURE_CLIENT_SECRET
使用傳回的權杖認證來驗證用戶端:
from azure.purview.account import PurviewAccountClient
from azure.identity import DefaultAzureCredential
credential = DefaultAzureCredential()
client = PurviewAccountClient(endpoint="https://<my-account-name>.purview.azure.com", credential=credential)
重要概念
用戶端
範例
下一節說明如何初始化和驗證用戶端,然後列出所有金鑰。
取得金鑰
from azure.purview.account import PurviewAccountClient
from azure.identity import DefaultAzureCredential
credential = DefaultAzureCredential()
client = PurviewAccountClient(endpoint="https://<my-account-name>.purview.azure.com", credential=credential)
response = client.accounts.get_access_keys()
print(response)
疑難排解
一般
如果未定義回應的狀態碼,Purview 帳戶用戶端將會引發例外狀況。
記錄
此程式庫會使用標準 記錄 程式庫進行記錄。 HTTP 會話的基本資訊 (URL、標頭等) 會記錄在 INFO 層級。
您可以在具備 logging_enable
關鍵字引數的用戶端啟用詳細的「偵錯」層級記錄,包括要求/回應本文和未刪改的標頭:
import sys
import logging
from azure.identity import DefaultAzureCredential
from azure.purview.account import PurviewAccountClient
# Create a logger for the 'azure' SDK
logger = logging.getLogger('azure')
logger.setLevel(logging.DEBUG)
# Configure a console output
handler = logging.StreamHandler(stream=sys.stdout)
logger.addHandler(handler)
endpoint = "https://<my-account-name>.purview.azure.com"
credential = DefaultAzureCredential()
# This client will log detailed information about its HTTP sessions, at DEBUG level
client = PurviewAccountClient(endpoint=endpoint, credential=credential, logging_enable=True)
同樣地, logging_enable
也可以啟用單一呼叫的詳細記錄,即使用戶端未啟用它:
result = client.accounts.get_access_keys(logging_enable=True)
下一步
如需更多泛型範例,請參閱 我們的用戶端檔。
參與
此專案歡迎參與和提供建議。 大部分的參與都要求您同意「參與者授權合約 (CLA)」,宣告您有權且確實授與我們使用投稿的權利。 如需詳細資訊,請造訪 cla.microsoft.com。
當您提交提取要求時,CLA Bot 會自動判斷您是否需要提供 CLA,並適當地裝飾 PR (例如標籤、註解)。 請遵循 bot 提供的指示。 您只需要使用我們的 CLA 在所有存放庫上執行此動作一次。
此專案採用 Microsoft Open Source Code of Conduct (Microsoft 開放原始碼管理辦法)。 如需詳細資訊,請參閱管理辦法常見問題集,如有任何其他問題或意見請連絡 opencode@microsoft.com。