使用用于Python的Azure库(SDK)

用于Python的开源Azure库简化了Python应用程序代码中的预配、管理和使用Azure资源。

真正想要了解的详细信息

非必要但仍然有趣的细节

  • 由于 Azure CLI是用 Python 编写的并使用管理库的,因此可以使用Azure CLI命令执行任何作,也可以通过Python脚本执行任何作。 CLI 命令提供了许多有用的功能,例如一起执行多个任务、自动处理异步作、格式化输出(如连接字符串等)。 因此,使用 CLI(或其等效的Azure PowerShell)自动创建和管理脚本比编写等效Python代码更方便,除非你想要对过程拥有更确切的控制度。

  • Python库是构建在基础的Azure REST API之上的,因此可以通过熟悉的Python习惯用法来使用这些API。 但是,如果需要,始终可以直接从Python代码使用 REST API。

  • 可以在 https://github.com/Azure/azure-sdk-for-python 上找到Azure库的源代码。 作为开源项目,欢迎贡献!

  • 虽然你可以在 IronPython、Jython 等 Microsoft 未测试过的解释器中使用这些库,但可能会遇到个别问题和不兼容的情况。

  • 库 API 参考文档的源存储库位于https://github.com/MicrosoftDocs/azure-docs-sdk-python/。

  • Azure Python 库遵循常见的云端设计模式,例如身份验证协议、日志记录、跟踪、传输协议、缓冲响应和重试。 这些库遵循当前的Azure SDK准则。

  • 有关Microsoft对库应用的指南的详细信息,请参阅Python 指南:简介。

使用管理库创建和管理Azure资源

SDK 的 management(或“管理平面”)库的名称全部以 azure-mgmt- 开头,可帮助你从Python脚本创建、配置和其他管理Azure资源。 所有Azure服务都有相应的管理库。 有关详细信息,请参阅 Azure 控制平面和数据平面。

通过使用管理库,可以编写配置和部署脚本来执行通过 Azure 门户或 Azure CLI 执行的任务。 (如前所述,Azure CLI以Python编写,并使用管理库实现其各种命令。

以下示例演示如何使用某些主要管理库:

有关使用每个管理库的详细信息,请参阅 README.md 或 README.rst 文件,该文件位于 SDK GitHub 存储库。 还可以在 reference 文档和 Azure Samples中找到更多代码片段。

从旧版管理库迁移

如果要从旧版管理库迁移代码,请参阅以下详细信息:

通过客户端库连接到和使用Azure资源

SDK 的 client(或“数据平面”)库可帮助你编写Python应用程序代码以与已预配的服务进行交互。 客户端库仅适用于支持客户端 API 的服务。

本文Example:使用 Azure 存储 提供了使用客户端库的基本插图。

不同的Azure服务还提供使用这些库的示例。 有关其他链接,请参阅以下索引页:

有关使用每个客户端库的详细信息,请参阅 README.md 或 README.rst 文件位于 SDK 的 GitHub 存储库中的库项目文件夹中。 还可以在 reference 文档和 Azure Samples中找到更多代码片段。

获取帮助并与 SDK 团队联系

后续步骤

设置本地开发环境,以便您可以轻松使用任何适用于Python的Azure库。