Libreria client di amministrazione di Azure Purview per Python - versione 1.0.0b1

Articolo
04/05/2023

Azure Purview è un servizio cloud completamente gestito.

Per usare questa libreria, fare affidamento principalmente sulla documentazione del servizio

Codice | sorgente Pacchetto (PyPI) | Documentazione | di riferimento sulle API Documentazione del prodotto

Dichiarazione di non responsabilità

Il supporto dei pacchetti Python di Azure SDK per Python 2.7 termina il 01 gennaio 2022. Per altre informazioni e domande, fare riferimento a https://github.com/Azure/azure-sdk-for-python/issues/20691

Introduzione

Prerequisiti

Per usare questo pacchetto è necessario Python 2.7 o 3.6 o versione successiva.
Per usare questo pacchetto, è necessario avere una sottoscrizione di Azure e una purview .

Creare una risorsa Purview

Seguire queste istruzioni per creare la risorsa Purview

Installare il pacchetto

Installare la libreria client dell'account Azure Purview per Python con pip:

pip install azure-purview-administration

Autenticare il client

Per usare una credenziale del token di Azure Active Directory (AAD), specificare un'istanza del tipo di credenziale desiderato ottenuto dalla libreria azure-identity .

Per eseguire l'autenticazione con AAD, è prima necessario installare azure-identitypip e abilitare l'autenticazione AAD nella risorsa Purview

Dopo l'installazione, è possibile scegliere il tipo di credenziale da usare azure.identity. Ad esempio, DefaultAzureCredential può essere usato per autenticare il client:

Impostare i valori dell'ID client, dell'ID tenant e del segreto client dell'applicazione AAD come variabili di ambiente: AZURE_CLIENT_ID, AZURE_TENANT_ID AZURE_CLIENT_SECRET

Usare le credenziali del token restituite per autenticare il client:

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)

Concetti chiave

Client

Il pacchetto contiene due tipi di client: PurviewAccountClient e PurviewMetadataPoliciesClient. È possibile usarli con un pacchetto in base alle proprie esigenze.

Esempio

La sezione seguente illustra come inizializzare e autenticare il client, quindi elencare tutte le chiavi.

Ottenere chiavi

Ottenere chiavi

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)

La sezione seguente illustra come inizializzare e autenticare il client, quindi elencare tutti i ruoli.

List_Roles

Elencare i ruoli

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)

Risoluzione dei problemi

Generale

Il client Purview genererà eccezioni se il codice di stato delle risposte non è definito.

Registrazione

Questa libreria usa la libreria di registrazione standard per la registrazione. Le informazioni di base sulle sessioni HTTP (URL, intestazioni e così via) vengono registrate a livello di INFO.

La registrazione dettagliata a livello di debug, inclusi i corpi di richiesta-risposta e le intestazioni non modificate, può essere abilitata su un client con l'argomento parola chiave 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)

Analogamente, logging_enable può abilitare la registrazione dettagliata per una singola chiamata, anche quando non è abilitata per il client:

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

Passaggi successivi

Per altri esempi generici, vedere la documentazione del client.

Contributo

In questo progetto sono benvenuti i contributi e i suggerimenti. Per la maggior parte dei contenuti è necessario sottoscrivere un contratto di licenza di collaborazione (CLA, Contributor License Agreement) che stabilisce che l'utente ha il diritto di concedere, e di fatto concede a Microsoft i diritti d'uso del suo contributo. Per informazioni dettagliate, visitare cla.microsoft.com.

Quando si invia una richiesta pull, un bot CLA determina automaticamente se è necessario specificare un contratto CLA e completare la richiesta pull in modo appropriato (ad esempio con un'etichetta e un commento). Seguire le istruzioni specificate dal bot. È sufficiente eseguire questa operazione una sola volta per tutti i repository che usano il contratto CLA Microsoft.

Questo progetto ha adottato il Codice di comportamento di Microsoft per l'open source. Per altre informazioni, vedere Code of Conduct FAQ (Domande frequenti sul Codice di comportamento Open Source di Microsoft) oppure contattare opencode@microsoft.com per eventuali altre domande o commenti.

Condividi tramite