Partager via

Utiliser les bibliothèques Azure (SDK) pour Python

Les bibliothèques Azure open source pour Python simplifient l’approvisionnement, la gestion et l’utilisation des ressources Azure à partir du code d’application Python.

Les détails que vous voulez vraiment savoir

Détails non essentiels, mais toujours intéressants

  • Étant donné que l’interface Azure CLI est écrite en Python à l’aide des bibliothèques de gestion, tout ce que vous pouvez faire avec les commandes Azure CLI que vous pouvez également effectuer à partir d’un script Python. Cela dit, les commandes CLI fournissent de nombreuses fonctionnalités utiles telles que l’exécution de plusieurs tâches ensemble, la gestion automatique des opérations asynchrones, la mise en forme de sortie comme les chaînes de connexion, etc. Par conséquent, l’utilisation de l’interface CLI (ou de son équivalent, Azure PowerShell) pour les scripts de création et de gestion automatisés peut être plus pratique que l’écriture du code Python équivalent, sauf si vous souhaitez avoir un degré de contrôle beaucoup plus précis sur le processus.

  • Les bibliothèques Azure pour Python s’appuient sur l’API REST Azure sous-jacente, ce qui vous permet d’utiliser ces API par le biais de paradigmes Python familiers. Toutefois, vous pouvez toujours utiliser l’API REST directement à partir du code Python, si vous le souhaitez.

  • Vous trouverez le code source des bibliothèques Azure sur https://github.com/Azure/azure-sdk-for-python. En tant que projet open source, les contributions sont bienvenues !

  • Bien que vous puissiez utiliser les bibliothèques avec des interpréteurs tels que IronPython et Jython que nous ne testons pas, vous pouvez rencontrer des problèmes isolés et des incompatibilités.

  • Le référentiel source de la documentation de référence de l’API de bibliothèque réside sur https://github.com/MicrosoftDocs/azure-docs-sdk-python/.

  • À compter de 2019, nous avons mis à jour les bibliothèques Azure Python pour partager des modèles cloud courants tels que les protocoles d’authentification, la journalisation, le suivi, les protocoles de transport, les réponses mises en mémoire tampon et les nouvelles tentatives. Les bibliothèques mises à jour respectent les instructions actuelles du Kit de développement logiciel (SDK) Azure.

  • Pour plus d’informations sur les instructions que nous appliquons aux bibliothèques, consultez les instructions Python : Introduction.

Créer et gérer des ressources Azure avec des bibliothèques de gestion

Les bibliothèques de gestion (ou « plan de gestion ») du Kit de développement logiciel (SDK), dont tous commencent azure-mgmt-par , vous aident à créer, configurer et gérer les ressources Azure à partir de scripts Python. Tous les services Azure ont des bibliothèques de gestion correspondantes. Pour plus d’informations, consultez plan de contrôle Azure et le plan de données.

Avec les bibliothèques de gestion, vous pouvez écrire des scripts de configuration et de déploiement pour effectuer les mêmes tâches que celles que vous pouvez effectuer via le portail Azure ou le Azure CLI. (Comme indiqué précédemment, Azure CLI est écrit en Python et utilise les bibliothèques de gestion pour implémenter ses différentes commandes.)

Les exemples suivants illustrent comment utiliser certaines des bibliothèques de gestion primaires :

Pour plus d’informations sur l’utilisation de chaque bibliothèque de gestion, consultez le fichier README.md ou README.rst situé dans le dossier de projet de la bibliothèque dans le dépôt GitHub du KIT de développement logiciel (SDK). Vous trouverez également d’autres extraits de code dans la documentation de référence et les exemples Azure .

Migration à partir d’anciennes bibliothèques de gestion

Si vous migrez du code à partir de versions antérieures des bibliothèques de gestion, consultez les détails suivants :

Se connecter aux ressources Azure et les utiliser avec des bibliothèques clientes

Les bibliothèques clientes (ou « plan de données ») du Kit de développement logiciel (SDK) vous aident à écrire du code d’application Python pour interagir avec les services déjà approvisionnés. Les bibliothèques clientes existent uniquement pour ces services qui prennent en charge une API cliente.

L’article , Exemple : Utiliser stockage Azure, fournit une illustration de base de l’utilisation de la bibliothèque cliente.

Différents services Azure fournissent également des exemples à l’aide de ces bibliothèques. Consultez les pages d’index suivantes pour d’autres liens :

Pour plus d’informations sur l’utilisation de chaque bibliothèque cliente, consultez le fichier README.md ou README.rst situé dans le dossier de projet de la bibliothèque dans le dépôt GitHub du Kit de développement logiciel (SDK). Vous trouverez également d’autres extraits de code dans la documentation de référence et les exemples Azure .

Obtenir de l’aide et se connecter à l’équipe du Kit de développement logiciel (SDK)

Étape suivante

Nous vous recommandons vivement d’effectuer une configuration unique de votre environnement de développement local afin de pouvoir facilement utiliser l’une des bibliothèques Azure pour Python.

Configurer votre environnement de développement local >>>