此存储库用于主动开发适用于 Python 的 Azure SDK。对于 SDK 的使用者,我们建议访问我们的公共开发者文档或版本化的开发者文档。
Azure SDK Python 包对 Python 2.7 的支持已于 2022 年 1 月 1 日结束。欲了解更多信息和问题,请参阅 https://github.com/Azure/azure-sdk-for-python/issues/20691
为方便起见,每个服务都有一组单独的库,你可以选择使用这些库,而不是一个大型 Azure 包。要开始使用特定库,请参阅位于库的项目文件夹中的 (或) 文件。
README.md
README.rst
你可以在目录中找到服务库。
/sdk
客户端库在 Python 3.7 或更高版本上受支持。有关更多详细信息,请阅读适用于 Python 的 Azure SDK 版本支持策略页面。
每个服务可能具有以下每个类别中可用的库:
我们宣布为 GA 的新一波软件包,以及目前正在预览版发布的几个软件包。这些库允许你使用和使用现有资源并与之交互,例如:上传 Blob。这些库共享许多核心功能,例如:重试、日志记录、传输协议、身份验证协议等,这些功能可在 Azure 核心库中找到。你可以通过阅读它们遵循的指南来了解有关这些库的更多信息 此处.
注意:如果需要确保代码已准备好用于生产,请使用稳定的非预览库之一。
已提供供 Azure 使用且可用于生产就绪的包的最后稳定版本。这些库提供与预览库类似的功能,因为它们允许你使用和使用现有资源并与之交互,例如:上传 Blob。它们可能未实施指南或具有与 11 月版本相同的功能集。但是,它们确实提供了更广泛的服务覆盖范围。
现在提供了一组遵循适用于 Python 的 Azure SDK 设计指南的新管理库。这些新库提供了许多在所有 Azure SDK 之间共享的核心功能,包括直观的 Azure 标识库、具有自定义策略的 HTTP 管道、错误处理、分布式跟踪等。可在此处找到这些新库的文档和代码示例。此外,此处还提供了演示如何从旧版本的库转换的迁移指南。
注意:如果需要确保代码已准备好用于生产,请使用稳定的非预览库之一。此外,如果在升级某些包后遇到管理库的身份验证问题,则可能在不更改身份验证代码的情况下升级到新版本的 SDK,请参阅上述迁移指南以获取正确说明。
有关可用于预配和管理 Azure 资源的管理库的完整列表,请查看此处。它们可能没有与新版本相同的功能集,但它们确实提供了更广泛的服务覆盖范围。管理库可以通过以 开头的命名空间来标识,例如
azure-mgmt-
azure-mgmt-compute
azure
python
安全问题和 bug 应通过电子邮件私下报告给 Microsoft 安全响应中心 (MSRC) secure@microsoft.com。你应该会在 24 小时内收到回复。如果由于某种原因你没有这样做,请通过电子邮件跟进以确保我们收到你的原始消息。更多信息,包括 MSRC PGP 密钥,可以在安全技术中心找到。
有关参与此存储库的详细信息,请参阅贡献指南。
该项目欢迎贡献和建议。大多数贡献要求你同意贡献者许可协议 (CLA),声明你有权并且实际上确实授予我们使用你的贡献的权利。有关详细信息,请访问 https://cla.microsoft.com。
当你提交拉取请求时,CLA 机器人将自动确定你是否需要提供 CLA 并适当地装饰 PR(例如,标签、评论)。只需按照机器人提供的说明进行操作即可。你只需要使用我们的 CLA 在所有存储库中执行此操作一次。
该项目采用了微软开源行为准则。有关更多信息,请参阅行为准则常见问题解答或联系 opencode@microsoft.com 提出任何其他问题或意见。