Condividi tramite


Usare le librerie di Azure (SDK) per Python

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

Informazioni che è necessario conoscere

Dettagli non essenziali ma comunque interessanti

  • Poiché l'interfaccia della riga di comando di Azure è scritta in Python usando le librerie di gestione, è possibile eseguire qualsiasi operazione con i comandi dell'interfaccia della riga di comando di Azure che è possibile eseguire anche da uno script Python. Detto questo, i comandi dell'interfaccia della riga di comando offrono molte funzionalità utili, ad esempio l'esecuzione simultanea di più attività, la gestione automatica di operazioni asincrone, la formattazione dell'output come 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, se si preferisce, è sempre possibile usare l'API REST direttamente dal codice Python.

  • Il codice sorgente delle librerie di Azure è disponibile all'indirizzo https://github.com/Azure/azure-sdk-for-python. Essendo un progetto open source, i contributi sono benvenuti.

  • Anche se è possibile usare le librerie con interpreti come IronPython e Jython che non vengono testati, si potrebbero riscontrare incompatibilità e problemi isolati.

  • Il repository di origine per la documentazione di riferimento delle API delle librerie si trova all'indirizzo 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. Per tutti i servizi di Azure sono disponibili 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à eseguibili 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 è scritta in Python e usa le librerie di gestione per implementare i vari comandi.

I seguenti esempi 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 disponibile nella cartella di progetto della libreria nel repository GitHub dell'SDK. È anche possibile trovare altri frammenti di codice nella documentazione di riferimento e negli esempi di Azure.

Migrazione dalle librerie di gestione precedenti

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

Connettersi e usare le risorse di Azure con le librerie client

Le librerie client (o "piano dati") dell'SDK consentono di scrivere il codice applicativo Python per interagire con servizi di cui è già stato effettuato il provisioning. Le librerie client sono disponibili 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.

Anche diversi servizi di Azure forniscono esempi di uso di 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 disponibile nella cartella di progetto della libreria nel repository GitHub dell'SDK. È anche possibile trovare altri frammenti di codice nella documentazione di riferimento e negli esempi di Azure.

Ottenere assistenza e contattare il team dell'SDK

Passaggio successivo

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