De Azure-bibliotheken (SDK) gebruiken voor Python

De opensource-Azure bibliotheken voor Python het inrichten, beheren en gebruiken van Azure resources vanuit Python toepassingscode vereenvoudigen.

De details die u echt wilt weten

Gebruik de Azure-bibliotheken om te communiceren met Azure services from Python code die u lokaal of in de cloud uitvoert. Of u Python code binnen het bereik van een bepaalde service kunt uitvoeren, is afhankelijk van of die service zelf momenteel ondersteuning biedt voor Python.
De bibliotheken ondersteunen Python 3.9 of hoger. Zie Azure SDKs Python-versieondersteuningsbeleid voor meer informatie over ondersteunde versies van Python. Als u Py gebruikt, moet u ervoor zorgen dat de versie die u gebruikt ten minste ondersteuning biedt voor de eerder genoemde Python versie.
De Azure SDK voor Python bestaat uitsluitend uit meer dan 180 afzonderlijke Python bibliotheken die betrekking hebben op specifieke Azure services. Er zijn geen andere hulpprogramma's in de SDK.
Wanneer u code lokaal uitvoert, is verificatie met Azure afhankelijk van omgevingsvariabelen, zoals beschreven in Hoe u Python-apps verifieert voor Azure services met behulp van de Azure SDK voor Python.
Als u bibliotheekpakketten met pip wilt installeren, gebruikt u pip install <library_name> bibliotheeknamen uit de pakketindex. Als u bibliotheekpakketten wilt installeren in conda-omgevingen, gebruikt u conda install <package_name> met behulp van namen uit het kanaal Microsoft op anaconda.org. Zie Install Azure library packages voor meer informatie.
Er zijn verschillende beheerlibraries en clientlibraries (ook wel 'beheervlak' en 'gegevensvlak' genoemd). Elke set dient verschillende doeleinden en wordt gebruikt door verschillende soorten code. Zie de volgende secties verderop in dit artikel voor meer informatie:
- Azure-middelen maken en beheren met beheerbibliotheken
- Maak verbinding met en gebruik Azure-resources met clientbibliotheken
U vindt documentatie voor de bibliotheken op de Azure voor Python Reference, die is ingedeeld op basis van Azure Service of de Python API-browser, die is ingedeeld op pakketnaam.
Als u de bibliotheken voor uzelf wilt proberen, moet u eerst uw lokale ontwikkelomgeving instellen. Vervolgens kunt u een van de volgende zelfstandige voorbeelden (in elke volgorde): Voorbeeld: Een resourcegroep maken, Example: Maak en gebruik Azure Storage, Example: Een web-app maken en implementeren, Example: Een MySQL-database maken en er query's op uitvoeren, en Voorbeeld: Maak een virtuele machine.
Zie voor demonstratievideo's De Azure SDK voor Python (PyCon 2021) en Azure SDKs gebruiken om te communiceren met Azure resources (PyCon 2020).

Niet-essentiële maar toch interessante details

Omdat de Azure CLI is geschreven in Python en de beheerbibliotheken gebruikt, kunt u alles doen met Azure CLI opdrachten die u ook kunt doen vanuit een Python script. De CLI-opdrachten bieden veel nuttige functies, zoals het uitvoeren van meerdere taken, het automatisch verwerken van asynchrone bewerkingen, het opmaken van uitvoer zoals verbindingsreeksen en meer. Het gebruik van de CLI (of het equivalent daarvan, Azure PowerShell) voor het automatisch maken en beheren van scripts kan dus handiger zijn dan het schrijven van de equivalente Python code, tenzij u een veel preciezere mate van controle over het proces wilt hebben.
De Azure bibliotheken voor Python bouwen op basis van de onderliggende Azure REST API, zodat u deze API's kunt gebruiken via bekende Python paradigma's. U kunt de REST API echter altijd rechtstreeks vanuit Python code gebruiken, indien gewenst.
U vindt de broncode voor de Azure bibliotheken op https://github.com/Azure/azure-sdk-for-python. Als opensource-project zijn bijdragen welkom!
Hoewel u de bibliotheken kunt gebruiken met interpreters zoals IronPython en Jython waarop Microsoft niet test, kunnen er geïsoleerde problemen en incompatibiliteit optreden.
De bronopslagplaats voor de bibliotheek-API-referentiedocumentatie bevindt zich op https://github.com/MicrosoftDocs/azure-docs-sdk-python/.
Vanaf 2019 heeft Microsoft Azure Python bibliotheken bijgewerkt om algemene cloudpatronen te delen, zoals verificatieprotocollen, logboekregistratie, tracering, transportprotocollen, gebufferde antwoorden en nieuwe pogingen. De bijgewerkte bibliotheken voldoen aan currente Azure SDK richtlijnen.
- Op 31 maart 2023 heeft Microsoft de ondersteuning voor Azure SDK bibliotheken buiten gebruik gesteld die niet voldoen aan de huidige Azure SDK richtlijnen. Hoewel oudere bibliotheken nog steeds meer dan 31 maart 2023 kunnen worden gebruikt, ontvangen ze geen officiële ondersteuning en updates meer van Microsoft. Zie de kennisgeving Update your Azure SDK libraries voor meer informatie.
- Als u wilt voorkomen dat er beveiligings- en prestatie-updates voor de Azure SDKs ontbreken, voert u een upgrade uit naar de latest Azure SDK-bibliotheken uiterlijk op 31 maart 2023.
- Zie Azure SDK Afgeschafte releases voor Python om na te gaan welke bibliotheken in Python worden beïnvloed.
Zie de Python Richtlijnen: Inleiding voor meer informatie over de richtlijnen die Microsoft van toepassing is op de bibliotheken.

Azure resources maken en beheren met beheerbibliotheken

De bibliotheken management (of 'beheervlak') van de SDK, waarvan alle beginnen met azure-mgmt-, helpen u bij het maken, configureren en anderszins beheren van Azure resources uit Python scripts. Alle Azure-services hebben bijbehorende beheerbibliotheken. Zie Azure besturingsvlak en gegevensvlak voor meer informatie.

Met behulp van de beheerbibliotheken kunt u configuratie- en implementatiescripts schrijven om dezelfde taken uit te voeren die u kunt uitvoeren via de Azure of de Azure CLI. (Zoals eerder vermeld, wordt de Azure CLI geschreven in Python en worden de beheerbibliotheken gebruikt om de verschillende opdrachten te implementeren.)

In de volgende voorbeelden ziet u hoe u enkele primaire beheerbibliotheken gebruikt:

Zie het bestand README.md of README.rst in de projectmap van de bibliotheek in de SDK GitHub-opslagplaats voor meer informatie over het werken met elke beheerbibliotheek. U kunt ook meer codefragmenten vinden in de referentiedocumentatie en de Azure Samples.

Migreren vanuit oudere beheerbibliotheken

Als u code migreert van oudere versies van de beheerbibliotheken, raadpleegt u de volgende details:

Als u de ServicePrincipalCredentials-klasse gebruikt, raadpleegt u Verifiëren met tokenreferenties.
De namen van asynchrone API's zijn gewijzigd zoals beschreven in bibliotheekgebruikspatronen: asynchrone bewerkingen. De namen van asynchrone API's in nieuwere bibliotheken beginnen met begin_. In de meeste gevallen blijft de API-handtekening hetzelfde.

Verbinding maken met de Azure-resources en deze gebruiken met clientbibliotheken.

De bibliotheken client (of 'gegevensvlak') van de SDK helpen u bij het schrijven van Python toepassingscode om te communiceren met al ingerichte services. Clientbibliotheken bestaan alleen voor services die ondersteuning bieden voor een client-API.

Het artikel Example: Gebruik Azure Storage biedt een eenvoudige illustratie van het gebruik van een clientbibliotheek.

Verschillende Azure-services bieden ook voorbeelden die gebruikmaken van deze bibliotheken. Zie de volgende indexpagina's voor andere koppelingen:

Zie het bestand README.md of README.rst in de projectmap van de bibliotheek in de SDK's GitHub-opslagplaats voor meer informatie over het werken met elke clientbibliotheek. U kunt ook meer codefragmenten vinden in de referentiedocumentatie en de Azure Samples.

Hulp krijgen en verbinding maken met het SDK-team

Ga naar de Azure-bibliotheken voor Python documentatie
Stel vragen in de community op Stack Overflow-
Open problemen met de SDK op GitHub
@AzureSDK vermelden op Twitter
Een korte enquête over de Azure SDK voor Python

Volgende stap

Stel uw lokale ontwikkelomgeving in, zodat u eenvoudig een van de Azure bibliotheken voor Python kunt gebruiken.

uw lokale ontwikkelomgeving instellen >>>

Feedback

Is deze pagina nuttig?

Last updated on 2026-03-06