Delen via


De Azure-bibliotheken (SDK) voor Python gebruiken

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

De details die u echt wilt weten

Niet-essentiële maar nog steeds interessante details

  • Omdat de Azure CLI is geschreven in Python met gebruik van de beheerbibliotheken, kunt u alles wat u met Azure CLI-opdrachten kunt doen ook vanuit een Python-script uitvoeren. 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, enzovoort. 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 we niet testen, 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 hebben we Azure Python-bibliotheken bijgewerkt om algemene cloudpatronen te delen, zoals verificatieprotocollen, logboekregistratie, tracering, transportprotocollen, gebufferde antwoorden en nieuwe pogingen. De bijgewerkte bibliotheken voldoen aan huidige Azure SDK-richtlijnen.

    • Op 31 maart 2023 hebben we ondersteuning voor Azure SDK-bibliotheken buiten gebruik gesteld die niet voldoen aan de huidige Richtlijnen voor Azure SDK. Oudere bibliotheken kunnen nog steeds worden gebruikt na 31 maart 2023, maar ontvangen geen officiële ondersteuning en updates meer van Microsoft. Zie de kennisgeving Uw Azure SDK-bibliotheken bijwerkenvoor meer informatie.

    • Als u wilt voorkomen dat er beveiligings- en prestatie-updates voor de Azure SDK's ontbreken, voert u een upgrade uit naar de nieuwste Azure SDK-bibliotheken op 31 maart 2023.

    • Als u wilt controleren welke Python-bibliotheken worden beïnvloed, raadpleegt u afgeschafte releases van Azure SDK voor Python.

  • Zie de Python-richtlijnen: Inleidingvoor meer informatie over de richtlijnen die we toepassen op de bibliotheken.

Azure-resources maken en beheren met beheerbibliotheken

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

Met de beheerbibliotheken kunt u configuratie- en implementatiescripts schrijven om dezelfde taken uit te voeren die u kunt uitvoeren via de Azure Portal 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 de README.md of README.rst bestand in de projectmap van de bibliotheek in de gitHub-opslagplaats van de SDKvoor 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:

Verbinding maken met en gebruikmaken van Azure-resources met clientbibliotheken

De -clientbibliotheken van de SDK (of 'gegevensvlak') 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 Voorbeeld: Azure Storagegebruiken, biedt een eenvoudige illustratie van het gebruik van de clientbibliotheek.

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

Zie de README.md of README.rst bestand in de projectmap van de bibliotheek in de GitHub-opslagplaats van de SDKvoor 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

Volgende stap

We raden u ten zeerste aan een eenmalige installatie van uw lokale ontwikkelomgeving uit te voeren, zodat u eenvoudig een van de Azure-bibliotheken voor Python kunt gebruiken.