Azure SDK for Python：微软云服务的 Python 入口

Azure SDK for Python：微软云服务的 Python 入口

微软官方维护的 Azure SDK for Python，目前已有 5546 个 Star：

这个项目是 Azure 官方 Python SDK 的活跃开发仓库，为开发者提供了一套完整的工具来访问和管理 Azure 云资源。无论是对象存储、虚拟机、容器服务还是认知服务，都能通过这套 SDK 用 Python 代码完成操作。

Azure SDK for Python 采用模块化设计。每个 Azure 服务都有独立的库，开发者可以根据需要选择安装，而不是引入一个臃肿的大包。这种设计让项目依赖更加精简，也便于按需升级。

所有客户端库共享一组核心功能，包括重试机制、日志记录、传输协议和认证协议。这些通用能力集中在 azure-core 库中，为上层各服务库提供统一的行为基础。

项目中的包按用途分为四个类别。

客户端库的新版本已经 GA，部分功能还在预览阶段。这些库允许你消费现有资源并与之交互，典型的场景是上传 Blob 文件、读取队列消息、调用认知服务 API 等。新版本遵循 Azure SDK 设计规范，接口风格统一，文档和示例也更加完善。

旧版本客户端库仍然可用，覆盖的服务范围更广。如果你的代码已经在生产环境运行，可以继续使用这些稳定版本。新项目的开发则建议优先选用遵循设计规范的新版本。

管理库的新版本提供资源创建和管理能力。这些库包含 Azure Identity 认证库、支持自定义策略的 HTTP Pipeline、统一的错误处理机制以及分布式追踪能力。从旧版本管理库迁移时，可以参考官方迁移指南完成升级。

旧版本管理库以 azure-mgmt- 开头，覆盖的 Azure 服务更多。在功能完整性有要求的情况下，这些库仍然是一个选择。

开始使用某个特定服务时，可以查看 /sdk 目录下对应文件夹中的 README 文件。每个库都有独立的项目文件夹，里面包含安装说明、使用示例和 API 参考。

SDK 支持多个 Python 版本，详细的版本支持策略可以在项目文档中查看。建议在开始开发前确认当前 Python 版本是否在支持范围内。

SDK 默认会收集遥测数据，用于改进产品和服务。如果需要在企业环境或隐私敏感场景中关闭这个功能，可以在创建客户端实例时传入自定义策略。定义一个继承自 UserAgentPolicy 的类，将 on_request 方法设为空操作，然后通过 user_agent_policy 参数传入实例。每个新创建的客户端都需要执行这个操作。

项目文档提供了详细的使用指南。遇到问题可以通过 Issues 提交，或在技术社区中搜索已有的讨论。这个项目欢迎外部贡献，提交代码前需要签署贡献者许可协议。

对于在 Azure 云上使用 Python 的开发者来说，这个 SDK 是绕不开的官方工具集。它的模块化设计和统一接口规范，让云资源的管理和调用变得更加直接。

。它的模块化设计和统一接口规范，让云资源的管理和调用变得更加直接。