Biblioteka klienta konta usługi Azure Purview dla języka Python — wersja 1.0.0b1
Konto usługi Azure Purview to w pełni zarządzana usługa w chmurze.
W dużej mierze polegaj na dokumentacji usługi i dokumentacji klienta , aby korzystać z tej biblioteki
Kod | źródłowy Pakiet (PyPI) | Dokumentacja referencyjna interfejsu| API Dokumentacja produktu
Wprowadzenie
Wymagania wstępne
- Do korzystania z tego pakietu jest wymagany język Python w wersji 2.7 lub 3.6 lub nowszej.
- Aby korzystać z tego pakietu, musisz mieć subskrypcję platformy Azure i usługę Purview .
Tworzenie zasobu usługi Purview
Postępuj zgodnie z tymi instrukcjami, aby utworzyć zasób usługi Purview
Instalowanie pakietu
Zainstaluj bibliotekę klienta konta usługi Azure Purview dla języka Python za pomocą narzędzia pip:
pip install azure-purview-account
Uwierzytelnianie klienta
Aby użyć poświadczeń tokenu usługi Azure Active Directory (AAD), podaj wystąpienie żądanego typu poświadczeń uzyskanego z biblioteki azure-identity .
Aby uwierzytelnić się w usłudze AAD, musisz najpierw zainstalować azure-identity narzędzie pip i włączyć uwierzytelnianie usługi AAD w zasobie usługi Purview
Po skonfigurowaniu możesz wybrać typ poświadczeń z pliku azure.identity do użycia. Na przykład wartość DefaultAzureCredential może służyć do uwierzytelniania klienta:
Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i klucza tajnego klienta aplikacji usługi AAD jako zmienne środowiskowe: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET
Użyj zwróconego poświadczenia tokenu, aby uwierzytelnić klienta:
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)
Kluczowe pojęcia
Klient
Przykłady
W poniższej sekcji pokazano, jak zainicjować i uwierzytelnić klienta, a następnie wyświetlić listę wszystkich kluczy.
Uzyskiwanie kluczy
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)
Rozwiązywanie problemów
Ogólne
Klient konta usługi Purview zgłosi wyjątki, jeśli kod stanu odpowiedzi nie jest zdefiniowany.
Rejestrowanie
Ta biblioteka używa standardowej biblioteki rejestrowania do rejestrowania. Podstawowe informacje o sesjach HTTP (adresach URL, nagłówkach itp.) są rejestrowane na poziomie INFORMACJI.
Szczegółowe rejestrowanie na poziomie DEBUG, w tym treści żądań/odpowiedzi i nieredagowanych nagłówków, można włączyć na kliencie z argumentem słowa kluczowego 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 Podobnie można włączyć szczegółowe rejestrowanie dla pojedynczego wywołania, nawet jeśli nie jest włączone dla klienta:
result = client.accounts.get_access_keys(logging_enable=True)
Następne kroki
Aby uzyskać więcej ogólnych przykładów, zobacz dokumentację klienta.
Współtworzenie
W tym projekcie zachęcamy do współtworzenia i zgłaszania sugestii. Współtworzenie w większości przypadków wymaga zgody na umowę licencyjną dotyczącą współautorów (CLA, Contributor License Agreement), zgodnie z którą współautor ma prawo udzielić i faktycznie udziela nam praw do używania wytworzonej przez siebie zawartości. Aby uzyskać szczegółowe informacje, odwiedź cla.microsoft.com.
Po przesłaniu żądania ściągnięcia robot CLA automatycznie określi, czy musisz przekazać umowę CLA, i doda odpowiednie informacje do tego żądania (na przykład etykietę czy komentarz). Po prostu postępuj zgodnie z instrukcjami robota. Wystarczy zrobić to raz dla wszystkich repozytoriów, w przypadku których jest używana nasza umowa CLA.
W tym projekcie przyjęto Kodeks postępowania oprogramowania Open Source firmy Microsoft. Aby uzyskać więcej informacji, zobacz Często zadawane pytania dotyczące kodeksu postępowania lub skontaktuj się z opencode@microsoft.com dodatkowymi pytaniami lub komentarzami.
Azure SDK for Python