Microsoft Azure SDK for Python

这是Microsoft Azure Deployment Manager客户端库。

Azure Resource Manager (ARM) 是下一代管理API，它取代了旧版的Azure Service Management (ASM)。

此包已在Python 2.7、3.5、3.6、3.7和3.8上进行了测试。

有关旧版Azure Service Management (ASM)库的信息，请参阅azure-servicemanagement-legacy库。

有关更完整的Azure库集，请参阅azure sdk python发布。

使用说明

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

有关文档和参考信息，请参阅 Python SDK 参考文档。本软件包的代码示例可以在 docs.microsoft.com 的 部署管理器管理 部分找到。不同 Azure 服务的额外代码示例可在 示例仓库 中找到。

提供反馈

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

发行历史

1.0.0 (2021-05-20)

功能特性

• 模型 RolloutPropertiesAutoGenerated 新增参数 artifact_source_id

破坏性更改

• 操作步骤 Operations.list 新增签名
• 操作服务 ServicesOperations.list 新增签名
• 操作服务 ServicesOperations.list 新增签名
• 操作服务拓扑 ServiceTopologiesOperations.list 新增签名
• 操作服务拓扑 ServiceTopologiesOperations.get 新增签名
• 操作服务拓扑 ServiceTopologiesOperations.get 新增签名
• 操作发布 RolloutsOperations.list 新增签名
• 操作资源源 ArtifactSourcesOperations.list 新增签名
• 模型 RolloutProperties 不再包含参数 step_groups
• 模型 RolloutProperties 不再包含参数 target_service_topology_id
• 模型 RolloutProperties 不再包含参数 build_version
• 模型 RolloutProperties 不再包含参数 artifact_source_id
• 模型 RolloutPropertiesAutoGenerated 新增必填参数 step_groups
• 模型 RolloutPropertiesAutoGenerated 新增必填参数 target_service_topology_id
• 模型 RolloutPropertiesAutoGenerated 新增必填参数 build_version
• 操作 ServiceUnitsOperations.list 新增签名
• 操作服务拓扑 ServiceTopologiesOperations.delete 新增签名

1.0.0b1 (2020-11-30)

这是测试预览版本。

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

一般破坏性更改

• 凭证系统已完全重做

  • 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 初始化文档中的参数接受](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)

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

• 之前返回 msrest.polling.LROPoller 的操作现在返回 azure.core.polling.LROPoller 并以前缀 begin_ 开头。

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

• 大多数操作 kwarg 已更改。以下是一些最显著的更改：

  • raw 已被移除。等效功能可以通过使用 cls，一个回调来访问内部 HTTP 响应，以供高级用户使用。
  • 有关支持的完整选项集，请参阅 [azure-core 请求文档中的参数接受](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)

一般新特性

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

0.2.0 (2019-12-31)

功能特性

• 添加了操作 ServiceUnitsOperations.list
• 添加了操作 RolloutsOperations.list
• 添加了操作 ArtifactSourcesOperations.list
• 添加了操作 ServiceTopologiesOperations.list
• 添加了操作 StepsOperations.list
• 添加了操作 ServicesOperations.list
• 添加了操作 Operations.list

破坏性更改

• 模型WaitStepProperties的参数属性现在为必需
• 移除了操作Operations.get

一般性重大变更

本版本使用的是下一代代码生成器，可能会因某些导入而引入破坏性变更。总结来说，一些模块被错误地设置为可见/可导入，并且已经重命名。这修复了由于使用原本不应使用的类而引起的一些问题。现在无法从azure.mgmt.deploymentmanager.deployment_manager_client导入DeploymentManagerClient（从azure.mgmt.deploymentmanager导入仍如以前一样工作） DeploymentManagerClientConfiguration的导入已从azure.mgmt.deploymentmanager.deployment_manager_client移动到azure.mgmt.deploymentmanager。来自“models”子模块的模型MyClass现在无法使用azure.mgmt.deploymentmanager.models.my_class导入（从azure.mgmt.deploymentmanager.models导入仍如以前一样工作） 来自operations子模块的操作类MyClassOperations现在无法使用azure.mgmt.deploymentmanager.operations.my_class_operations导入（从azure.mgmt.deploymentmanager.operations导入仍如以前一样工作） 最后但同样重要的是，HTTP连接池现在默认启用。您应始终将客户端作为上下文管理器使用，或调用close()，或每个进程最多使用一个客户端。

0.1.0 (2019-04-15)

• 首次发布