Använd Azure-biblioteken (SDK) för Python

Azure-bibliotek med öppen källkod för Python förenklar etablering, hantering och användning av Azure-resurser från Python-programkod.

Den information som du verkligen vill veta

Använd Azure-biblioteken för att kommunicera med Azure tjänster från Python kod som du kör antingen lokalt eller i molnet. Om du kan köra Python kod inom omfånget för en viss tjänst beror på om själva tjänsten för närvarande stöder Python.
Biblioteken stöder Python 3.9 eller senare. Mer information om versioner av Python som stöds finns i supportpolicyn för Azure SDKs Python-versioner. Om du använder PyPy kontrollerar du att den version som du använder åtminstone stöder den Python version som nämnts tidigare.
Azure SDK för Python består endast av över 180 enskilda Python bibliotek som avser specifika Azure tjänster. Det finns inga andra verktyg i SDK:n.
När du kör kod lokalt förlitar sig autentisering med Azure på miljövariabler enligt beskrivningen i Så här autentiserar du Python appar för att Azure tjänster med hjälp av Azure SDK för Python.
Om du vill installera bibliotekspaket med pip använder du pip install <library_name> biblioteksnamn från paketindexet. Om du vill installera bibliotekspaket i conda-miljöer använder du conda install <package_name> med namn från kanalen Microsoft på anaconda.org. Mer information finns i Installera Azure bibliotekspaket.
Det finns distinkta hanterings- och klientbibliotek (kallas ibland för "hanteringsplan" och "dataplan"-bibliotek). Varje uppsättning har olika syften och används av olika typer av kod. Mer information finns i följande avsnitt senare i den här artikeln:
- Skapa och hantera Azure resurser med hanteringsbibliotek
- Anslut till och använd Azure resurser med klientbibliotek
Du hittar dokumentationen för biblioteken på Azure för Python Reference, som organiseras av Azure Service eller Python API-webbläsaren, som ordnas efter paketnamn.
Om du vill prova biblioteken själv måste du först konfigurera din lokala utvecklingsmiljö. Sedan kan du prova något av följande fristående exempel (i valfri ordning): Example: Skapa en resursgrupp, Example: Skapa och använda Azure Storage, Example: Skapa och distribuera en webbapp, Example: Skapa och fråga efter en MySQL-databas, och Example: Skapa en virtuell dator.
Demonstrationsvideor finns i Introducing the Azure SDK for Python (PyCon 2021) and Using Azure SDKs to interact with Azure resources (PyCon 2020).

Oviktiga men fortfarande intressanta detaljer

Eftersom Azure CLI skrivs i Python och använder hanteringsbiblioteken, kan du göra allt med Azure CLI kommandon som du också kan göra från ett Python skript. CLI-kommandona innehåller många användbara funktioner som att utföra flera uppgifter tillsammans, automatiskt hantera asynkrona åtgärder, formatera utdata som anslutningssträngar med mera. Det kan därför vara enklare att använda CLI (eller motsvarande Azure PowerShell) för automatiserade skapande- och hanteringsskript än att skriva motsvarande Python kod, såvida du inte vill ha en mycket mer krävande kontroll över processen.
Azure-biblioteken för Python bygger ovanpå det underliggande Azure REST API, så att du kan använda dessa API:er genom välbekanta Python-paradigmer. Du kan dock alltid använda REST-API:et direkt från Python kod, om så önskas.
Du hittar källkoden för Azure-biblioteken på https://github.com/Azure/azure-sdk-for-python. Som ett projekt med öppen källkod är bidrag välkomna!
Även om du kan använda biblioteken med tolkar som IronPython och Jython som Microsoft inte testar mot, kan du stöta på isolerade problem och inkompatibiliteter.
Källdatabasen för biblioteks-API-referensdokumentationen finns på https://github.com/MicrosoftDocs/azure-docs-sdk-python/.
Från och med 2019 uppdaterade Microsoft Azure Python bibliotek för att dela vanliga molnmönster som autentiseringsprotokoll, loggning, spårning, transportprotokoll, buffrade svar och återförsök. De uppdaterade biblioteken följer aktuella Azure SDK riktlinjer.
- Den 31 mars 2023 upphörde Microsofts support för Azure SDK bibliotek som inte överensstämmer med aktuella Azure SDK riktlinjer. Äldre bibliotek kan fortfarande användas efter den 31 mars 2023, men de får inte längre officiell support och uppdateringar från Microsoft. Mer information finns i meddelandet Update your Azure SDK libraries.
- För att undvika att säkerhets- och prestandauppdateringar saknas i Azure SDKs uppgraderar du till latest Azure SDK bibliotek senast den 31 mars 2023.
- Information om vilka Python bibliotek som påverkas finns i Azure SDK Inaktuella versioner för Python.
Mer information om de riktlinjer som Microsoft tillämpar på biblioteken finns i Python Guidelines: Introduction.

Skapa och hantera Azure resurser med hanteringsbibliotek

SDK:s bibliotek management (eller "hanteringsplan") och namnen som alla börjar med azure-mgmt-, hjälper dig att skapa, konfigurera och på annat sätt hantera Azure resurser från Python skript. Alla Azure tjänster har motsvarande hanteringsbibliotek. Mer information finns i Azure kontrollplan och dataplan.

Med hjälp av hanteringsbiblioteken kan du skriva konfigurations- och distributionsskript för att utföra samma uppgifter som du kan via Azure-portalen eller Azure CLI. (Som tidigare nämnts skrivs Azure CLI i Python och använder hanteringsbiblioteken för att implementera sina olika kommandon.)

Följande exempel visar hur du använder några av de primära hanteringsbiblioteken:

Mer information om hur du arbetar med varje hanteringsbibliotek finns i filen README.md eller README.rst i bibliotekets projektmapp i SDK GitHub lagringsplats. Du hittar även fler kodfragment i dokumentationen reference och Azure Samples.

Migrering från äldre hanteringsbibliotek

Om du migrerar kod från äldre versioner av hanteringsbiblioteken kan du läsa följande information:

Om du använder klassen ServicePrincipalCredentials, se Autentisera med token-baserade inloggningsuppgifter.
Namnen på asynkrona API:er har ändrats enligt beskrivningen i Biblioteksanvändningsmönster – asynkrona åtgärder. Namnen på asynkrona API:er i nyare bibliotek börjar med begin_. I de flesta fall förblir API-signaturen densamma.

Ansluta till och använda Azure resurser med klientbibliotek

SDK:ts bibliotek client (eller "dataplan") hjälper dig att skriva Python programkod för att interagera med redan etablerade tjänster. Klientbibliotek finns bara för de tjänster som stöder ett klient-API.

Artikeln Example: Use Azure Storage innehåller en grundläggande bild av hur du använder ett klientbibliotek.

Olika Azure tjänster innehåller också exempel som använder dessa bibliotek. Se följande indexsidor för andra länkar:

Mer information om hur du arbetar med varje klientbibliotek finns i filen README.md eller README.rst i bibliotekets projektmapp i SDK:s GitHub lagringsplats. Du hittar även fler kodfragment i dokumentationen reference och Azure Samples.

Få hjälp och få kontakt med SDK-teamet

Besök biblioteken Azure för Python dokumentation
Skicka frågor till communityn på Stack Overflow
Öppna problem mot SDK på GitHub
Nämn @AzureSDK på Twitter
Komplettera en kort undersökning om Azure SDK för Python

Nästa steg

Konfigurera din lokala utvecklingsmiljö så att du enkelt kan använda något av de Azure biblioteken för Python.

Konfigurera din lokala utvecklingsmiljö >>>

Feedback

Var den här sidan till hjälp?

Last updated on 2026-03-12