Microsoft Azure SDK for Python

这是Microsoft Azure Advisor客户端库。此包已在Python 2.7、3.5、3.6、3.7和3.8上进行了测试。要查看Azure库的更完整视图，请参阅azure sdk python release。

用法

要了解如何使用此包，请参阅快速入门指南

有关文档和参考，请参阅Python SDK参考。该包的代码示例可以在Advisor Management上找到，位于docs.microsoft.com。有关不同Azure服务的附加代码示例，请参阅示例存储库

提供反馈

如果您遇到任何错误或有任何建议，请在项目的问题部分提交问题。

发布历史

9.0.0 (2020-12-22)

功能

• 模型SuppressionContract新增参数expiration_time_stamp

9.0.0b1 (2020-11-03)

这是一个测试预览版本。

本版本使用新一代代码生成器，引入了重要的破坏性更改，但也引入了重要的新功能（如统一身份验证和异步编程）。

一般破坏性更改

• 凭证系统已被完全重构成

  • azure.common.credentials或msrestazure.azure_active_directory实例不再受支持，请使用azure-identity类：[https://pypi.ac.cn/project/azure-identity/](https://pypi.ac.cn/project/azure-identity/)
  • credentials参数已被重命名为credential

• 客户端上的config属性不再存在，配置应作为kwarg传递。例如：MyClient(credential, subscription_id, enable_logging=True)。有关支持的完整选项集，请参阅azure-core初始化文档中的参数接受

• 您不能再导入version模块，请使用__version__代替

• 之前返回msrest.polling.LROPoller的操作现在返回azure.core.polling.LROPoller，并带有前缀begin_。

• 异常树已简化，大多数异常现在为azure.core.exceptions.HttpResponseError（已删除CloudError）。

• 大多数操作kwarg已更改。其中一些最引人注目的是

  • raw已被删除。等效功能可以通过使用cls找到，这是一个回调，将为高级用户提供对内部HTTP响应的访问
  • 有关支持的完整选项集，请参阅azure-core请求文档中的参数接受

一般新功能

• 支持使用typing进行类型注解。SDKs已准备好mypy。
• 此客户端现在对异步具有稳定和官方的支持。检查您的包中的aio命名空间以找到异步客户端。
• 此客户端现在原生支持如OpenCensus或OpenTelemetry之类的跟踪库。有关概述，请参阅此跟踪快速入门

4.0.0 (2020-03-14)

功能

• 模型ResourceRecommendationBase新增参数resource_metadata

破坏性更改

• 模型ConfigData有新的签名

3.0.0 (2019-10-24)

功能

• 添加了操作组RecommendationMetadataOperations

一般破坏性更改

本版本使用新一代代码生成器，可能会引入破坏性更改，如果某些导入。总之，一些模块不正确可见/可导入，并已重命名。这解决了由于使用最初不应该使用的类而引起的一些问题。无法从azure.mgmt.advisor.advisor_management_client导入AdvisorManagementClient anymore（从azure.mgmt.advisor导入与之前相同） AdvisorManagementClientConfiguration导入已从azure.mgmt.advisor.advisor_management_client移动到azure.mgmt.advisor 一个来自“models”子模块的MyClass模型无法再使用azure.mgmt.advisor.models.my_class导入（从azure.mgmt.advisor.models导入与之前相同） 一个来自操作子模块的操作类MyClassOperations无法再使用azure.mgmt.advisor.operations.my_class_operations导入（从azure.mgmt.advisor.operations导入与之前相同） 最后但同样重要的是，HTTP连接池现在默认启用。您应始终使用客户端作为上下文管理器，或调用close()，或每个进程使用不超过一个客户端。

2.0.1 (2018-10-16)

错误修复

• 修复2.0.0中sdist损坏的问题。没有代码更改。

2.0.0 (2018-10-15)

功能

• 模型ResourceRecommendationBase新增参数extended_properties
• 客户端类可以用作上下文管理器以保持底层HTTP会话打开以提高性能

一般破坏性更改

本版本使用下一代代码生成器，可能会引入破坏性更改。

• 模型签名现在仅使用关键字参数语法。所有位置参数都必须重写为关键字参数。为了在大多数情况下保持自动完成，现在为 Python 2 和 Python 3 生成模型。Python 3 使用 "*" 语法表示关键字参数。
• 枚举类型现在使用 "str" 混合（类 AzureEnum(str, Enum)）来改进遇到未识别枚举值时的行为。虽然这不是破坏性更改，但区别很重要，这里进行了文档说明：https://docs.pythonlang.cn/3/library/enum.html#others 简要概述
  • “is”应完全不用。
  • “format”将返回字符串值，其中 "%s" 字符串格式化将返回 NameOfEnum.stringvalue。应优先使用格式语法。
• 新的长时间运行操作
  • 返回类型从 msrestazure.azure_operation.AzureOperationPoller 更改为 msrest.polling.LROPoller。外部 API 保持不变。
  • 返回类型现在始终是 msrest.polling.LROPoller，无论使用的是哪些可选参数。
  • 使用 raw=True 时的行为已更改。现在不再返回初始调用结果作为 ClientRawResponse，而是返回 LROPoller，而不进行轮询。轮询后，最终资源将作为 ClientRawResponse 返回。
  • 新增 polling 参数。默认行为是 Polling=True，这将使用 ARM 算法进行轮询。当 Polling=False 时，将返回初始调用的响应，而不进行轮询。
  • polling 参数接受 msrest.polling.PollingMethod 子类的实例。
  • 如果 add_done_callback 在轮询完成后调用，则不再引发异常，而是立即执行回调。

注意

• 在 Python 3 上不再安装 azure-mgmt-nspkg（基于 PEP420 的命名空间包）

1.0.1 (2018-02-13)

• 修复 list_by_subscription 返回类型
• 修复 list_by_resource_group 返回类型

1.0.0 (2018-01-16)

• GA 版本

0.1.0 (2017-11-06)

• 初始版本