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

2025-06-19

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

Die Azure-Bibliotheken dienen zur Kommunikation mit Azure-Diensten mittels Python-Code, 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.8 oder höher. Weitere Informationen zu unterstützten Versionen von Python finden Sie in der Supportrichtlinie für Azure SDKs Python-Version. Wenn Sie PyPy verwenden, stellen Sie sicher, dass die version, die Sie verwenden, mindestens die zuvor erwähnte Python-Version unterstützt.
Das 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 beschrieben.
Verwenden Sie pip install <library_name> mit Bibliotheksnamen aus dem Paketindex, um Bibliothekspakete mit pip zu installieren. Verwenden Sie conda install <package_name> mit Namen aus dem Microsoft-Kanal auf anaconda.org zum Installieren von Bibliothekspaketen in Conda-Umgebungen. Weitere Informationen erhalten Sie in 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
- Herstellen einer Verbindung mit Azure-Ressourcen und Verwenden von Azure-Ressourcen mit Clientbibliotheken
Die Dokumentation für die Bibliotheken finden Sie in der Azure for Python-Referenz, 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, empfehlen wir zunächst die Einrichtung Ihrer lokalen Entwicklungsumgebung. Anschließend können Sie eines der folgenden eigenständigen Beispiele (in beliebiger Reihenfolge) ausprobieren : 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 eines virtuellen Computers.
Demovideos finden Sie unter Einführung des Azure SDK für Python (PyCon 2021) und verwenden von Azure SDKs für die Interaktion mit Azure-Ressourcen (PyCon 2020).

Nicht wesentliche, aber dennoch interessante Details

Da die Azure CLI mithilfe der Verwaltungsbibliotheken in Python geschrieben wird, können Sie alles, was Sie mit Azure CLI-Befehlen tun können, auch über ein Python-Skript ausführen. Die CLI-Befehle bieten viele hilfreiche Features wie das gleichzeitige Ausführen mehrerer Aufgaben, die automatische Behandlung asynchroner Vorgänge, die Formatierung der Ausgabe, wie etwa bei Verbindungszeichenfolgen, und so weiter. Daher kann die Verwendung der CLI (oder seiner Entsprechung , Azure PowerShell) für automatisierte Erstellungs- und Verwaltungsskripts bequemer sein als das Schreiben des entsprechenden Python-Codes, es sei denn, Sie möchten ein viel genaueres Maß an Kontrolle über den Prozess haben.
Die Azure-Bibliotheken für Python basieren auf der zugrunde liegenden Azure REST-API, sodass Sie diese APIs über vertraute Python-Paradigmen verwenden können. Sie können die REST-API jedoch jederzeit direkt aus Python-Code verwenden, falls gewünscht.
Den Quellcode für die Azure-Bibliotheken finden Sie unter https://github.com/Azure/azure-sdk-for-python. Als Open-Source-Projekt sind Beiträge willkommen!
Obwohl Sie die Bibliotheken mit Dolmetschern wie IronPython und Jython verwenden können, die wir nicht testen, können 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 haben wir Azure Python-Bibliotheken aktualisiert, um gemeinsame Cloudmuster wie Authentifizierungsprotokolle, Protokollierung, Ablaufverfolgung, Transportprotokolle, gepufferte Antworten und Wiederholungen zu teilen. Die aktualisierten Bibliotheken entsprechen den aktuellen Azure SDK-Richtlinien.
- Am 31. März 2023 haben wir die Unterstützung 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 nicht mehr offiziellen Support und Updates von Microsoft. Weitere Informationen finden Sie im Hinweis zum Aktualisieren Ihrer Azure SDK-Bibliotheken.
- Um zu vermeiden, dass Sicherheits- und Leistungsupdates auf die Azure SDKs fehlen, aktualisieren Sie bis zum 31. März 2023 auf die neuesten Azure SDK-Bibliotheken .
- Um zu überprüfen, welche Python-Bibliotheken betroffen sind, lesen Sie die veralteten Versionen von Azure SDK für Python.
Ausführliche Informationen zu den Richtlinien, die wir für die Bibliotheken anwenden, finden Sie in den Python-Richtlinien: Einführung.

Erstellen und Verwalten von Azure-Ressourcen mit Verwaltungsbibliotheken

Die Verwaltungsbibliotheken (oder "Verwaltungsebene") des SDK, mit denen alle beginnen azure-mgmt-, helfen Ihnen, Azure-Ressourcen aus Python-Skripts zu erstellen, zu konfigurieren und anderweitig zu verwalten. Alle Azure-Dienste verfügen über entsprechende Verwaltungsbibliotheken. Weitere Informationen finden Sie unter Azure-Steuerebene und -Datenebene.

Mit den Verwaltungsbibliotheken können Sie Konfigurations- und Bereitstellungsskripts schreiben, um dieselben Aufgaben auszuführen, die Sie über das Azure-Portal 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 jeder Verwaltungsbibliothek 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 Referenzdokumentation und in den Azure-Beispielen.

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 mit Azure-Ressourcen und Verwenden von Azure-Ressourcen mit Clientbibliotheken

Die Clientbibliotheken (oder "Datenebene") des SDK helfen Ihnen beim Schreiben von Python-Anwendungscode für die Interaktion mit bereits bereitgestellten Diensten. Clientbibliotheken sind nur für dienste vorhanden, die eine Client-API unterstützen.

Der Artikel "Beispiel: Verwenden von Azure Storage" bietet eine grundlegende Abbildung der Verwendung von Clientbibliotheken.

Verschiedene Azure-Dienste bieten auch Beispiele für diese 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 GitHub-Repository des SDK. Weitere Codeausschnitte finden Sie auch in der Referenzdokumentation und in den Azure-Beispielen.

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 bezüglich des SDK auf GitHub
Erwähnen @AzureSDK auf Twitter
Eine kurze Umfrage zum Azure SDK für Python abschließen

Nächster Schritt

Es wird dringend empfohlen, ein einmaliges Setup Ihrer lokalen Entwicklungsumgebung durchzuführen, damit Sie alle Azure-Bibliotheken für Python problemlos verwenden können.

Einrichten Ihrer lokalen Entwicklungsumgebung >>>

Freigeben über