Azure Purview Administration-clientbibliotheek voor Python - versie 1.0.0b1

Artikel
04/05/2023

Azure Purview is een volledig beheerde cloudservice.

Vertrouw sterk op de documentatie van de service om deze bibliotheek te gebruiken

Broncode | Pakket (PyPI) | API-referentiedocumentatie| Productdocumentatie

Disclaimer

Ondersteuning voor Azure SDK Python-pakketten voor Python 2.7 eindigt op 1 januari 2022. Voor meer informatie en vragen raadpleegt u https://github.com/Azure/azure-sdk-for-python/issues/20691

Aan de slag

Vereisten

Python 2.7 of 3.6 of hoger is vereist voor het gebruik van dit pakket.
U moet een Azure-abonnement en een Purview hebben om dit pakket te kunnen gebruiken.

Een Purview-resource maken

Volg deze instructies om uw Purview-resource te maken

Het pakket installeren

Installeer de Azure Purview-accountclientbibliotheek voor Python met pip:

pip install azure-purview-administration

De client verifiëren

Als u een AAD-tokenreferentie (Azure Active Directory) wilt gebruiken, geeft u een exemplaar op van het gewenste referentietype dat is verkregen uit de azure-identity-bibliotheek .

Als u wilt verifiëren met AAD, moet u eerst AAD-verificatie installeren azure-identity en inschakelen voor uw Purview-resource

Na de installatie kunt u kiezen welk type referentie van azure.identity u wilt gebruiken. Als voorbeeld kan DefaultAzureCredential worden gebruikt om de client te verifiëren:

Stel de waarden van de client-id, tenant-id en clientgeheim van de AAD-toepassing in als omgevingsvariabelen: AZURE_CLIENT_ID, AZURE_TENANT_ID AZURE_CLIENT_SECRET

Gebruik de geretourneerde tokenreferentie om de client te verifiëren:

from azure.purview.administration.account import PurviewAccountClient
from azure.purview.administration.metadatapolicies import PurviewMetadataPoliciesClient
from azure.identity import DefaultAzureCredential

credential = DefaultAzureCredential()
endpoint = "https://<my-account-name>.purview.azure.com"
account_client = PurviewAccountClient(endpoint=endpoint, credential=credential)
metadatapolicy_client = PurviewMetadataPoliciesClient(endpoint=endpoint, credential=credential)

Belangrijkste concepten

Client

Het pakket bevat twee soorten clients: PurviewAccountClient en PurviewMetadataPoliciesClient. U kunt ze gebruiken met één pakket volgens uw vereisten.

Voorbeelden

In de volgende sectie ziet u hoe u uw client initialiseert en verifieert en vervolgens al uw sleutels weergeeft.

Sleutels ophalen

Sleutels ophalen

from azure.purview.administration.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)

In de volgende sectie ziet u hoe u uw client initialiseert en verifieert en vervolgens al uw rollen weergeeft.

List_Roles

Rollen weergeven

from azure.purview.administration.metadatapolicies import PurviewMetadataPoliciesClient
from azure.identity import DefaultAzureCredential

credential = DefaultAzureCredential()
client = PurviewMetadataPoliciesClient(endpoint="https://<my-account-name>.purview.azure.com", credential=credential)
response = client.metadata_roles.list()
result = [item for item in response]
print(result)

Problemen oplossen

Algemeen

De Purview-client genereert uitzonderingen als de statuscode van uw antwoorden niet is gedefinieerd.

Logboekregistratie

Deze bibliotheek maakt gebruik van de standaardbibliotheek voor logboekregistratie voor logboekregistratie. Basisinformatie over HTTP-sessies (URL's, headers, enzovoort) wordt geregistreerd op INFO-niveau.

Gedetailleerde logboekregistratie op DEBUG-niveau met aanvraag/antwoord-body's en niet-geredigeerde headers, kan worden ingeschakeld op een client met het sleutelwoordargument logging_enable:

import sys
import logging
from azure.identity import DefaultAzureCredential
from azure.purview.administration.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)

Op dezelfde manier logging_enable kan gedetailleerde logboekregistratie voor één aanroep worden ingeschakeld, zelfs wanneer deze niet is ingeschakeld voor de client:

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

Volgende stappen

Zie onze clientdocumenten voor meer algemene voorbeelden.

Bijdragen

Wij verwelkomen bijdragen en suggesties voor dit project. Voor de meeste bijdragen moet u instemmen met een licentieovereenkomst voor bijdragers (CLA: Contributor License Agreement) waarin u verklaart dat u gerechtigd bent ons het recht te geven uw bijdrage te gebruiken, en dat u dit ook doet. Ga naar cla.microsoft.com voor meer informatie.

Wanneer u een pull-aanvraag indient, wordt met een CLA-bot automatisch bepaald of u een CLA moet verschaffen en wordt de pull-aanvraag dienovereenkomstig opgemaakt (bijvoorbeeld met een label of commentaar). Volg gewoon de instructies van de bot. U hoeft dit maar eenmaal te doen voor alle repo's waar gebruik wordt gemaakt van onze CLA.

Op dit project is de Microsoft Open Source Code of Conduct (Microsoft Open Source-gedragscode) van toepassing. Zie de Veelgestelde vragen over de gedragscode voor meer informatie of neem contact op opencode@microsoft.com met eventuele aanvullende vragen of opmerkingen.

Delen via