Verwenden der Azure-Bibliotheken (SDK) für Python

Die Open Source-Azure-Bibliotheken für Python vereinfachen die Bereitstellung, Verwaltung und Verwendung von Azure Ressourcen aus Python Anwendungscode.

Die Details, die Sie wirklich wissen möchten

Verwenden Sie die Azure-Bibliotheken, um mit Azure Diensten from Python Code zu kommunizieren, den Sie entweder lokal oder in der Cloud ausführen. Ob Sie Python Code im Bereich eines bestimmten Diensts ausführen können, hängt davon ab, ob dieser Dienst selbst Python unterstützt.
Die Bibliotheken unterstützen Python 3.9 oder höher. Weitere Informationen zu unterstützten Versionen von Python finden Sie unter Azure SDKs Python Versionsunterstützungsrichtlinie. Wenn Sie PyPy verwenden, stellen Sie sicher, dass die verwendete Version mindestens die zuvor erwähnte Python Version unterstützt.
Die Azure SDK für Python besteht ausschließlich aus über 180 einzelnen Python Bibliotheken, die sich auf bestimmte Azure Dienste beziehen. Es gibt keine anderen Tools im SDK.
Wenn Sie Code lokal ausführen, basiert die Authentifizierung mit Azure auf Umgebungsvariablen, wie in How to authenticate Python apps to Azure services using the Azure SDK for Python.
Verwenden Sie pip install <library_name> mit Bibliotheksnamen aus dem Paketindex, um Bibliothekspakete mit pip zu installieren. Verwenden Sie zum Installieren von Bibliothekspaketen in Conda-Umgebungen conda install <package_name> Namen aus dem Microsoft-Kanal auf anaconda.org. Weitere Informationen finden Sie unter Installieren von Azure-Bibliothekspaketen.
Es gibt unterschiedliche Verwaltungs- und Clientbibliotheken (manchmal auch als "Verwaltungsebene" und "Datenebene"-Bibliotheken bezeichnet). Jedes Set dient verschiedenen Zwecken und wird von verschiedenen Arten von Code verwendet. Weitere Informationen finden Sie weiter unten in diesem Artikel in den folgenden Abschnitten:
- Erstellen und Verwalten von Azure Ressourcen mit Verwaltungsbibliotheken
- Anschließen und Verwenden von Azure-Ressourcen mit Clientbibliotheken
Sie finden die Dokumentation für die Bibliotheken im Azure für Python Reference, die nach Azure Service oder dem Python-API-Browser organisiert ist, der nach Paketname organisiert ist.
Um die Bibliotheken für sich selbst zu testen, richten Sie zuerst Ihre lokale Entwicklungsumgebung ein. Anschließend können Sie eines der folgenden eigenständigen Beispiele ausprobieren (in beliebiger Reihenfolge): Beispiel: Erstellen einer Ressourcengruppe, Beispiel: Erstellen und Verwenden von Azure Storage, Beispiel: Erstellen und Bereitstellen einer Web-App, Beispiel: Erstellen und Abfragen einer MySQL-Datenbank, und Beispiel: Erstellen einer virtuellen Maschine.
Demovideos finden Sie unter Introducing the Azure SDK for Python (PyCon 2021) and Using Azure SDKs to interact with Azure resources (PyCon 2020).

Nicht wesentliche, aber dennoch interessante Details

Da die Azure CLI in Python geschrieben ist und die Verwaltungsbibliotheken verwendet, können Sie alles mit Azure CLI Befehlen ausführen, die Sie auch über ein Python Skript ausführen können. Die CLI-Befehle bieten viele hilfreiche Features wie das Gemeinsame Ausführen mehrerer Aufgaben, die automatische Behandlung asynchroner Vorgänge, das Formatieren der Ausgabe wie Verbindungszeichenfolgen und vieles mehr. Die Verwendung der CLI (oder seiner Entsprechung, Azure PowerShell) für automatisierte Erstellungs- und Verwaltungsskripts kann also praktischer sein als das Schreiben des entsprechenden Python Codes, es sei denn, Sie möchten einen viel genaueren Grad an Kontrolle über den Prozess haben.
Die Azure-Bibliotheken für Python auf dem zugrunde liegenden Azure REST-API aufbauen, sodass Sie diese APIs über vertraute Python Paradigmen verwenden können. Sie können die REST-API jedoch bei Bedarf immer direkt aus Python Code verwenden.
Sie finden den Quellcode für die Azure-Bibliotheken auf https://github.com/Azure/azure-sdk-for-python. Als Open-Source-Projekt sind Beiträge willkommen!
Obwohl Sie die Bibliotheken mit Interpretern wie IronPython und Jython verwenden können, die von Microsoft nicht getestet werden, könnten isolierte Probleme und Inkompatibilitäten auftreten.
Das Quell-Repository für die Bibliotheks-API-Referenzdokumentation befindet sich auf https://github.com/MicrosoftDocs/azure-docs-sdk-python/.
Ab 2019 hat Microsoft Azure Python Bibliotheken aktualisiert, um gemeinsame Cloudmuster wie Authentifizierungsprotokolle, Protokollierung, Ablaufverfolgung, Transportprotokolle, gepufferte Antworten und Wiederholungen freizugeben. Die aktualisierten Bibliotheken entsprechen current Azure SDK Richtlinien.
- Am 31. März 2023 hat Microsoft den Support für Azure SDK Bibliotheken eingestellt, die nicht den aktuellen Azure SDK Richtlinien entsprechen. Ältere Bibliotheken können zwar noch über den 31. März 2023 hinaus verwendet werden, aber sie erhalten keinen offiziellen Support und keine updates mehr von Microsoft. Weitere Informationen finden Sie im Hinweis Update your Azure SDK libraries.
- Um zu vermeiden, dass Sicherheits- und Leistungsupdates für die Azure SDKs fehlen, führen Sie ein Upgrade auf die latest Azure SDK-Bibliotheken bis zum 31. März 2023 durch.
- Informationen dazu, welche Python Bibliotheken betroffen sind, finden Sie unter Azure SDK Veraltete Versionen für Python.
Ausführliche Informationen zu den Richtlinien, die von Microsoft für die Bibliotheken angewendet werden, finden Sie in den Python Guidelines: Introduction.

Erstellen und Verwalten von Azure Ressourcen mit Verwaltungsbibliotheken

Die management-Bibliotheken (oder "Verwaltungsebene") des SDK, deren Namen alle mit azure-mgmt- beginnen, helfen Ihnen beim Erstellen, Konfigurieren und anderen Verwalten von Azure Ressourcen aus Python Skripts. Alle Azure Dienste verfügen über entsprechende Verwaltungsbibliotheken. Weitere Informationen finden Sie unter Azure Steuerebene und Datenebene.

Mithilfe der Verwaltungsbibliotheken können Sie Konfigurations- und Bereitstellungsskripts schreiben, um dieselben Aufgaben auszuführen, die Sie über das portal Azure oder die Azure CLI ausführen können. (Wie bereits erwähnt, wird die Azure CLI in Python geschrieben und verwendet die Verwaltungsbibliotheken, um ihre verschiedenen Befehle zu implementieren.)

Die folgenden Beispiele veranschaulichen die Verwendung einiger der primären Verwaltungsbibliotheken:

Ausführliche Informationen zum Arbeiten mit den einzelnen Verwaltungsbibliotheken finden Sie in der Datei README.md oder README.rst im Projektordner der Bibliothek im SDK GitHub Repository. Weitere Codeausschnitte finden Sie auch in der Dokumentation Reference und den Azure Samples.

Migrieren von älteren Verwaltungsbibliotheken

Wenn Sie Code aus älteren Versionen der Verwaltungsbibliotheken migrieren, lesen Sie die folgenden Details:

Wenn Sie die ServicePrincipalCredentials Klasse verwenden, lesen Sie " Authentifizieren mit Tokenanmeldeinformationen".
Die Namen asynchroner APIs haben sich geändert, wie in Bibliotheksnutzungsmustern beschrieben – asynchrone Vorgänge. Die Namen asynchroner APIs in neueren Bibliotheken beginnen mit begin_. In den meisten Fällen bleibt die API-Signatur gleich.

Herstellen einer Verbindung zu und Verwenden von Azure-Ressourcen mit Clientbibliotheken

Die client(oder "Data Plane")-Bibliotheken des SDK helfen Ihnen, Python Anwendungscode für die Interaktion mit bereits bereitgestellten Diensten zu schreiben. Clientbibliotheken sind nur für dienste vorhanden, die eine Client-API unterstützen.

Der Artikel Example: Verwenden von Azure Storage enthält eine grundlegende Abbildung der Verwendung einer Clientbibliothek.

Verschiedene Azure-Dienste bieten auch Beispiele für die Verwendung dieser Bibliotheken. Weitere Links finden Sie auf den folgenden Indexseiten:

Ausführliche Informationen zum Arbeiten mit jeder Clientbibliothek finden Sie in der Datei README.md oder README.rst im Projektordner der Bibliothek im SDK GitHub Repository. Weitere Codeausschnitte finden Sie auch in der Dokumentation Reference und den Azure Samples.

Abrufen von Hilfe und Herstellen einer Verbindung mit dem SDK-Team

Besuchen Sie die Azure-Bibliotheken für Python Dokumentation
Stellen Sie Fragen in der Community auf Stack Overflow
Offene Probleme gegen das SDK auf GitHub
Erwähnen @AzureSDK auf Twitter
Vervollständigen Sie eine kurze Umfrage über die Azure SDK für Python

Nächster Schritt

Richten Sie Ihre lokale Entwicklungsumgebung ein, damit Sie problemlos eine der Azure-Bibliotheken für Python verwenden können.

Einrichten Ihrer lokalen Entwicklungsumgebung >>>

Feedback

War diese Seite hilfreich?

Last updated on 2026-03-11