Biblioteca de clientes da Conta Azure Purview para Python - versão 1.0.0b1

Artigo
04/05/2023

A Azure Purview Account é um serviço de nuvem totalmente gerido.

Por favor, confie fortemente na documentação do serviço e nos nossos médicos clientes para usar esta biblioteca

Código fonte | Pacote (PyPI) | Documentação de| referência da API Documentação do produto

Introdução

Pré-requisitos

Python 2.7, ou 3.6 ou mais tarde é obrigado a usar este pacote.
Você deve ter uma assinatura Azure e um Purview para usar este pacote.

Criar um recurso de competência

Siga estas instruções para criar o seu recurso Purview

Instale o pacote

Instale a biblioteca de clientes da Conta Azure Purview para Python com pip:

pip install azure-purview-account

Autenticar o cliente

Para utilizar uma credencial de token Azure Ative(AAD), forneça uma instância do tipo credencial pretendido obtido a partir da biblioteca de identidade azul .

Para autenticar com AAD, tem primeiro de instalar azure-identity pip e ativar a autenticação AAD no seu recurso Purview

Após a configuração, pode escolher que tipo de credencial a azul.identidade a usar. Como exemplo, o DefaultAzureCredential pode ser usado para autenticar o cliente:

Decreta os valores do ID do cliente, iD do inquilino e o segredo do cliente da aplicação AAD como variáveis ambientais: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET

Utilize a credencial simbólica devolvida para autenticar o cliente:

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)

Conceitos-chave

Cliente

Exemplos

A seguinte secção mostra-lhe como inicializar e autenticar o seu cliente e, em seguida, listar todas as suas chaves.

Obter Chaves

Obter Chaves

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)

Resolução de problemas

Geral

O cliente da Conta Desres visão levantará exceções se o código de estado das suas respostas não for definido.

Registo

Esta biblioteca utiliza a biblioteca de registos padrão para registar registos. Informações básicas sobre sessões HTTP (URLs, cabeçalhos, etc.) são registadas ao nível info.

A registo detalhado do nível DEBUG, incluindo os órgãos de pedido/resposta e os cabeçalhos não redigidos, pode ser ativado num cliente com o argumento da logging_enable palavra-chave:

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)

Da mesma forma, logging_enable pode permitir a registo detalhado para uma única chamada, mesmo quando não está habilitado para o cliente:

result = client.accounts.get_access_keys(logging_enable=True)

Passos seguintes

Para mais amostras genéricas, consulte os médicos dos nossos clientes.

Contribuir

Agradecemos todas as contribuições e sugestões para este projeto. A maioria das contribuições requerem que celebre um Contrato de Licença de Contribuição (CLA) no qual se declare que tem o direito de conceder e que, na verdade, concede-nos os direitos para utilizar a sua contribuição. Para mais detalhes, visite cla.microsoft.com.

Quando submete um pedido Pull, um bot do CLA determina automaticamente se tem de fornecer um CLA e decorar o PR de forma adequada (por exemplo, etiqueta, comentário). Só tem de seguir as instruções fornecidas pelo bot. Apenas terá de fazer isto uma vez em todos os repositórios com o nosso CLA.

Este projeto adotou o Microsoft Open Source Code of Conduct (Código de Conduta do Microsoft Open Source). Para mais informações consulte o Código de Conduta FAQ ou contacte opencode@microsoft.com com quaisquer perguntas ou comentários adicionais.

Partilhar via