適用于 Python 的 Azure Purview 帳戶用戶端程式庫 - 1.0.0b1 版

發行項
04/05/2023

Azure Purview 帳戶是完全受控的雲端服務。

請高度依賴服務的檔和我們的用戶端檔來使用此文件庫

| 原始程式碼套件 (PyPI) | API 參考檔| 產品檔

開始使用

Prerequisites

需要 Python 2.7 或 3.6 或更新版本才能使用此套件。
您必須擁有 Azure 訂用帳戶和 Purview 才能使用此套件。

建立 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。

共用方式為