Utiliser les bibliothèques Azure (SDK) pour PythonUse the Azure libraries (SDK) for Python

Les bibliothèques Azure open source pour Python simplifient le provisionnement, la gestion et l’utilisation des ressources Azure à partir du code d’application Python.The open-source Azure libraries for Python simplify provisioning, managing, and using Azure resources from Python application code.

Détails à connaître absolumentThe details you really want to know

Détails non essentiels, mais néanmoins intéressantsNon-essential but still interesting details

  • Étant donné qu’Azure CLI est écrit en Python à l’aide de bibliothèques de gestion, tout ce que vous pouvez faire avec des commandes Azure CLI peut également être réalisé à partir d’un script Python.Because the Azure CLI is written in Python using the management libraries, anything you can do with Azure CLI commands you can also do from a Python script. Cela dit, les commandes CLI fournissent de nombreuses fonctionnalités utiles, telles que l’exécution simultanée de plusieurs tâches, la gestion automatique des opérations asynchrones, la mise en forme de la sortie comme les chaînes de connexion, etc.That said, the CLI commands provide many helpful features such as performing multiple tasks together, automatically handling asynchronous operations, formatting output like connection strings, and so on. Par conséquent, l’utilisation de l’interface CLI (ou de son équivalent, Azure PowerShell) pour les scripts d’approvisionnement et de gestion automatisés peut être beaucoup plus pratique que l’écriture du code Python équivalent, à moins que vous ne souhaitiez avoir un degré de contrôle beaucoup plus précis sur le processus.Consequently, using the CLI (or its equivalent, Azure PowerShell) for automated provisioning and management scripts can be significantly more convenient than writing the equivalent Python code, unless you want to have a much more exacting degree of control over the process.

  • Les bibliothèques Azure pour Python sont ajoutées sur l’API REST Azure sous-jacente, ce qui vous permet d’utiliser ces API via les paradigmes Python bien connus.The Azure libraries for Python build on top of the underlying Azure REST API, allowing you to use those APIs through familiar Python paradigms. Toutefois, vous pouvez toujours utiliser l’API REST directement à partir du code Python, si vous le souhaitez.However, you can always use the REST API directly from Python code, if desired.

  • Vous trouverez le code source des bibliothèques Azure dans https://github.com/Azure/azure-sdk-for-python.You can find the source code for the Azure libraries on https://github.com/Azure/azure-sdk-for-python. Comme il s’agit d’un projet open source, les contributions sont les bienvenues.As an open-source project, contributions are welcome!

  • Bien que vous puissiez utiliser les bibliothèques avec des interpréteurs tels qu’IronPython et Jython que nous ne testons pas, vous pouvez rencontrer des incompatibilités et des problèmes isolés.Although you can use the libraries with interpreters such as IronPython and Jython that we don't test against, you may encounter isolated issues and incompatibilities.

  • Le référentiel source de la documentation de référence de l’API des bibliothèques se trouve sur https://github.com/MicrosoftDocs/azure-docs-sdk-python/.The source repo for the library API reference documentation resides on https://github.com/MicrosoftDocs/azure-docs-sdk-python/.

  • Nous mettons actuellement à jour les bibliothèques Azure pour Python afin de partager des modèles cloud courants tels que les protocoles d’authentification, la journalisation, le traçage, les protocoles de transport, les réponses mises en mémoire tampon et les nouvelles tentatives.We're currently updating the Azure libraries for Python libraries to share common cloud patterns such as authentication protocols, logging, tracing, transport protocols, buffered responses, and retries.

    • Ces fonctionnalités partagées sont incluses dans la bibliothèque azure-core.This shared functionality is contained in the azure-core library.

    • Les bibliothèques qui fonctionnent actuellement avec la bibliothèque Core sont répertoriées sur la page des dernières publications du Kit de développement logiciel (SDK) Azure pour Python.The libraries that currently work with the Core library are listed on Azure SDK for Python latest releases. Ces bibliothèques, principalement les bibliothèques clientes, sont parfois appelées « traçage 2 ».These libraries, primarily the client libraries, are sometimes referred to as "track 2".

    • Les bibliothèques de gestion et toutes les autres qui ne sont pas encore mises à jour sont parfois appelées « traçage 1 ».The management libraries and any other that aren't yet updated are sometimes referred to as "track 1".

  • Pour plus d’informations sur les instructions que nous appliquons aux bibliothèques, consultez Instructions Python : Introduction.For details on the guidelines we apply to the libraries, see the Python Guidelines: Introduction.

Approvisionner et gérer des ressources Azure avec des bibliothèques de gestionProvision and manage Azure resources with management libraries

Les bibliothèques de gestion (ou « plan de gestion ») du de développement logiciel (SDK), dont les noms commencent par azure-mgmt-, vous aident à créer, approvisionner et gérer des ressources Azure à partir de scripts Python.The SDK's management (or "management plane") libraries, the names of which all begin with azure-mgmt-, help you create, provision and otherwise manage Azure resources from Python scripts. Tous les services Azure ont des bibliothèques de gestion correspondantes.All Azure services have corresponding management libraries.

Grâce aux 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 à l’aide du Portail Azure ou d’Azure CLI.With the management libraries, you can write configuration and deployment scripts to perform the same tasks that you can through the Azure portal or the 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.)(As noted earlier, the Azure CLI is written in Python and uses the management libraries to implement its various commands.)

Les exemples suivants montrent comment utiliser certaines bibliothèques de gestion principales :The following examples illustrate how to use some of the primary management libraries:

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 SDK.For details on working with each management library, see the README.md or README.rst file located in the library's project folder in the SDK GitHub repository. Vous trouverez également des extraits de code supplémentaires dans la documentation de référence et la page Exemples Azure.You can also find additional code snippets in the reference documentation and the Azure Samples.

Migration à partir d’anciennes bibliothèques de gestionMigrating from older management libraries

Si vous migrez du code depuis des versions antérieures des bibliothèques de gestion, consultez les informations suivantes :If you are migrating code from older versions of the management libraries, see the following details:

Se connecter à des ressources Azure et les utiliser avec des bibliothèques clientesConnect to and use Azure resources with client libraries

Les bibliothèques cliente (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.The SDK's client (or "data plane") libraries help you write Python application code to interact with already-provisioned services. Les bibliothèques clientes existent uniquement pour les services qui prennent en charge une API cliente.Client libraries exist only for those services that support a client API.

L’article Exemple : Utiliser Stockage Azure fournit une illustration de base de l’utilisation de la bibliothèque de client.The article, Example: Use Azure Storage, provides a basic illustration of using client library.

Différents services Azure fournissent également des exemples d’utilisation de ces bibliothèques.Different Azure services also provide examples using these libraries. Consultez les pages de l’index suivant pour obtenir des liens supplémentaires :See the following index pages for additional links:

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 SDK.For details on working with each client library, see the README.md or README.rst file located in the library's project folder in the SDK's GitHub repository. Vous trouverez également des extraits de code supplémentaires dans la documentation de référence et la page Exemples Azure.You can also find additional code snippets in the reference documentation and the Azure Samples.

Obtenez de l’aide et communiquez avec l’équipe du Kit de développement logiciel (SDK)Get help and connect with the SDK team

Étape suivanteNext step

Nous vous recommandons vivement de procéder à une installation unique de votre environnement de développement local pour pouvoir utiliser facilement l’une des bibliothèques Azure pour Python.We strongly recommend doing a one-time setup of your local development environment so that you can easily use any of the Azure libraries for Python.