Azure Purview Account Python客户端库

Azure Purview Account是一个全托管的云服务。

请务必参考服务文档和我们的客户端文档来使用此库

源代码 | 包（PyPI） | API参考文档 | 产品文档

入门

先决条件

• 使用此软件包需要Python 2.7或更高版本（3.6或更高）。
• 您必须拥有Azure订阅和Purview才能使用此软件包。

创建Purview资源

按照这些说明创建您的Purview资源

安装包

使用pip安装Azure Purview Account Python客户端库

pip install azure-purview-account

客户端认证

要使用Azure Active Directory (AAD) 令牌凭据，请提供一个从azure-identity库中获得的所需凭据类型的实例。

要使用 AAD 进行身份验证，您必须首先使用pip 安装azure-identity并在您的 Purview 资源上启用 AAD 身份验证。

设置完成后，您可以选择使用 azure.identity 中的哪种类型的凭据。例如，可以使用DefaultAzureCredential来对客户端进行身份验证。

将 AAD 应用程序的客户端 ID、租户 ID 和客户端密钥的值设置为环境变量：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 账户客户端会在您的响应状态码未定义时抛出异常。

日志记录

此库使用标准的logging库进行日志记录。HTTP 会话（URL、头部等）的基本信息在 INFO 级别进行记录。

可以通过在客户端中使用 logging_enable 关键字参数启用详细的 DEBUG 级别日志记录，包括请求/响应体和未摘录的头部。

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（例如，标签、注释）。只需遵循机器人提供的说明即可。您只需在所有使用我们的 CLA 的存储库中这样做一次。

此项目采用了Microsoft 开源行为准则。有关更多信息，请参阅行为准则常见问题解答或联系opencode@microsoft.com以获取任何额外的问题或评论。

发布历史

1.0.0b1 (2021-08-23)

• 这是 Azure Purview Account 库的初始发布。