Usare le librerie di Azure (SDK) per Python

2025-06-17

Le librerie di Azure open source per Python semplificano il provisioning, la gestione e l'uso delle risorse di Azure dal codice dell'applicazione Python.

I dettagli che vuoi davvero sapere

Le librerie di Azure sono il modo in cui si comunica con i servizi di Azure dal codice Python eseguito in locale o nel cloud. Se è possibile eseguire codice Python nell'ambito di un determinato servizio, dipende dal fatto che tale servizio attualmente supporti Python.
Le librerie supportano Python 3.8 o versione successiva. Per altre informazioni sulle versioni supportate di Python, vedere Criteri di supporto delle versioni di Python per Azure SDK. Se si usa PyPy, assicurarsi che la versione usata supporti almeno la versione di Python indicata in precedenza.
Azure SDK per Python è composto esclusivamente da oltre 180 singole librerie Python correlate a servizi di Azure specifici. Non sono disponibili altri strumenti nell'SDK.
Quando si esegue il codice in locale, l'autenticazione con Azure si basa su variabili di ambiente, come descritto in Come autenticare le app Python nei servizi di Azure usando Azure SDK per Python.
Per installare i pacchetti di libreria con pip, utilizzare pip install <library_name> utilizzando i nomi delle librerie dall'indice dei pacchetti. Per installare i pacchetti di libreria in ambienti conda, usare conda install <package_name> i nomi del canale Microsoft in anaconda.org. Per altre informazioni, vedere Installare pacchetti di libreria di Azure.
Sono disponibili librerie client e di gestione distinte (talvolta denominate "piano di gestione" e "piano dati"). Ogni set svolge scopi diversi e viene usato da diversi tipi di codice. Per altre informazioni, vedere le sezioni seguenti più avanti in questo articolo:
- Creare e gestire le risorse di Azure con le librerie di gestione
- Connettersi e usare le risorse di Azure con le librerie client
La documentazione per le librerie è disponibile nel riferimento di Azure per Python, organizzato dal servizio di Azure o dal browser API Python, organizzato in base al nome del pacchetto.
Per provare autonomamente le librerie, è consigliabile innanzitutto configurare l'ambiente di sviluppo locale. È quindi possibile provare uno degli esempi autonomi seguenti (in qualsiasi ordine): Esempio: Creare un gruppo di risorse, Esempio: Creare e usare Archiviazione di Azure, Esempio: Creare e distribuire un'app Web, Esempio: Creare ed eseguire query su un database MySQL ed esempio: Creare una macchina virtuale.
Per i video dimostrativi, vedere Introduzione ad Azure SDK per Python (PyCon 2021) e Uso degli SDK di Azure per interagire con le risorse di Azure (PyCon 2020).

Dettagli non essenziali ma ancora interessanti

Poiché Azure CLI è scritto in Python usando le librerie di gestione, tutte le operazioni eseguibili con i comandi di Azure CLI possono essere eseguite anche da uno script Python. Detto questo, i comandi dell'interfaccia della riga di comando forniscono molte funzionalità utili, ad esempio l'esecuzione di più attività insieme, la gestione automatica delle operazioni asincrone, la formattazione dell'output come le stringhe di connessione e così via. Pertanto, l'uso dell'interfaccia della riga di comando (o dell'equivalente, Azure PowerShell) per la creazione e gli script di gestione automatizzati può risultare più pratico rispetto alla scrittura del codice Python equivalente, a meno che non si voglia avere un grado di controllo molto più preciso sul processo.
Le librerie di Azure per Python si basano sull'API REST di Azure sottostante, consentendo di usare tali API tramite paradigmi Python noti. Tuttavia, è sempre possibile usare l'API REST direttamente dal codice Python, se necessario.
È possibile trovare il codice sorgente per le librerie di Azure in https://github.com/Azure/azure-sdk-for-python. Come progetto open source, i contributi sono benvenuti!
Sebbene sia possibile usare le librerie con interpreti come IronPython e Jython che non vengono testate, è possibile che si verifichino problemi isolati e incompatibilità.
Il repository di origine per la documentazione di riferimento dell'API di libreria risiede in https://github.com/MicrosoftDocs/azure-docs-sdk-python/.
A partire dal 2019, sono state aggiornate le librerie Python di Azure per condividere modelli cloud comuni, ad esempio protocolli di autenticazione, registrazione, traccia, protocolli di trasporto, risposte memorizzate nel buffer e tentativi. Le librerie aggiornate rispettano le linee guida correnti di Azure SDK.
- Il 31 marzo 2023 è stato ritirato il supporto per le librerie di Azure SDK che non sono conformi alle linee guida correnti di Azure SDK. Anche se le librerie meno recenti possono ancora essere usate oltre il 31 marzo 2023, non riceveranno più il supporto e gli aggiornamenti ufficiali da Microsoft. Per altre informazioni, vedere l'avviso Aggiornare le librerie di Azure SDK.
- Per evitare aggiornamenti di sicurezza e prestazioni mancanti per gli SDK di Azure, eseguire l'aggiornamento alle librerie più recenti di Azure SDK entro il 31 marzo 2023.
- Per verificare quali librerie Python sono interessate, vedere Versioni deprecate di Azure SDK per Python.
Per informazioni dettagliate sulle linee guida applicate alle librerie, vedere Le linee guida per Python: Introduzione.

Creare e gestire le risorse di Azure con le librerie di gestione

Le librerie di gestione (o "piano di gestione") dell'SDK, i cui nomi iniziano tutti con azure-mgmt-, consentono di creare, configurare e gestire in altro modo le risorse di Azure dagli script Python. Tutti i servizi di Azure hanno librerie di gestione corrispondenti. Per altre informazioni, vedere piano di controllo di Azure e piano dati.

Con le librerie di gestione è possibile scrivere script di configurazione e distribuzione per eseguire le stesse attività che è possibile eseguire tramite il portale di Azure o l'interfaccia della riga di comando di Azure . Come indicato in precedenza, l'interfaccia della riga di comando di Azure viene scritta in Python e usa le librerie di gestione per implementare i vari comandi.

Gli esempi seguenti illustrano come usare alcune delle librerie di gestione primarie:

Per informazioni dettagliate sull'uso di ogni libreria di gestione, vedere il file README.md o README.rst che si trova nella cartella del progetto della libreria nel repository GitHub SDK. È anche possibile trovare altri frammenti di codice nella documentazione di riferimento e Esempi di Azure.

Migrazione da librerie di gestione meno recenti

Se si esegue la migrazione del codice da versioni precedenti delle librerie di gestione, vedere i dettagli seguenti:

Se si usa la classe ServicePrincipalCredentials, vedere Autenticarsi con credenziali token.
I nomi delle API asincrone sono stati modificati come descritto in Modelli di utilizzo della libreria - operazioni asincrone. I nomi delle API asincrone nelle librerie più recenti iniziano con begin_. Nella maggior parte dei casi, la firma DELL'API rimane invariata.

Connettersi e usare le risorse di Azure con le librerie client

Le librerie client (o "piano dati") dell'SDK consentono di scrivere il codice dell'applicazione Python per interagire con i servizi di cui è già stato effettuato il provisioning. Le librerie client esistono solo per i servizi che supportano un'API client.

L'articolo Esempio: Usare Archiviazione di Azure fornisce un'illustrazione di base dell'uso della libreria client.

Diversi servizi di Azure forniscono anche esempi che usano queste librerie. Per altri collegamenti, vedere le pagine di indice seguenti:

Per informazioni dettagliate sull'uso di ogni libreria client, vedere il file README.md o README.rst che si trova nella cartella del progetto della libreria nel repository GitHub dell'SDK. È anche possibile trovare altri frammenti di codice nella documentazione di riferimento e Esempi di Azure.

Ottenere assistenza e connettersi al team SDK

Vedere la documentazione sulle librerie di Azure per Python
Inviare domande alla community su Stack Overflow
Aprire i problemi relativi all'SDK in GitHub
Menzionare @AzureSDK su Twitter
Completare un breve sondaggio su Azure SDK per Python

Passo successivo

È consigliabile eseguire una sola configurazione dell'ambiente di sviluppo locale in modo da poter usare facilmente qualsiasi libreria di Azure per Python.

Configurare l'ambiente di sviluppo locale >>>

Condividi tramite