Microsoft Azure SDK for Python

这是Microsoft Azure资源管理客户端库。此包已与Python 3.8+进行测试。要查看Azure库的完整视图，请参阅azure sdk python发布。

免责声明

Azure SDK Python包对Python 2.7的支持已于2022年1月1日结束。有关更多信息及疑问，请参考https://github.com/Azure/azure-sdk-for-python/issues/20691

入门指南

先决条件

• 使用此包需要Python 3.8及以上版本。
• Azure订阅

安装包

pip install azure-mgmt-resource
pip install azure-identity

身份验证

默认情况下，Azure Active Directory令牌身份验证依赖于以下环境变量的正确配置。

• AZURE_CLIENT_ID用于Azure客户端ID。
• AZURE_TENANT_ID用于Azure租户ID。
• AZURE_CLIENT_SECRET用于Azure客户端密钥。

此外，Azure订阅ID可以通过环境变量AZURE_SUBSCRIPTION_ID进行配置。

根据上述配置，客户端可以通过以下代码进行身份验证

from azure.identity import DefaultAzureCredential
from azure.mgmt.resource import ResourceManagementClient
import os

sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
client = ResourceManagementClient(credential=DefaultAzureCredential(), subscription_id=sub_id)

示例

此包的代码示例可以在以下位置找到

• 在docs.microsoft.com上搜索资源管理
• Azure Python Mgmt SDK 示例仓库

故障排除

下一步

提供反馈

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

发布历史

23.1.1 (2024-05-08)

其他更改

• 为避免由于错误的swagger导致的破坏性更改，从PolicyClient中删除了2023-04-01。

23.1.0 (2024-05-06)

新增功能

• 添加了DeploymentStacksOperations操作组
• 添加了PolicyDefinitionVersionsOperations操作组
• 添加了PolicySetDefinitionVersionsOperations操作组
• Model ContainerConfiguration有一个新的参数subnet_ids
• Model Location有一个新的参数availability_zone_mappings
• Model LocationMetadata有一个新的参数geography
• Model Operation有一个新的参数action_type
• Model Operation有一个新的参数is_data_action
• Model Operation有一个新的参数origin
• Model OperationAutoGenerated有一个新的参数action_type
• Model OperationAutoGenerated有一个新的参数is_data_action
• Model OperationAutoGenerated有一个新的参数origin
• Model OperationDisplayAutoGenerated有一个新的参数description
• Model ParameterDefinitionsValue有一个新的参数schema
• Model PolicyDefinition有一个新的参数version
• Model PolicyDefinition有一个新的参数versions
• Model PolicySetDefinition有一个新的参数version
• Model PolicySetDefinition有一个新的参数versions

23.1.0b2 (2023-06-16)

破坏性更改

• 模型DenySettings的参数mode现在为必需
• 由于仅在预览api版本文件夹中定义，已从默认api版本文件夹中删除了PolicyExemption。用户可以通过PolicyClient(...).models(api_version="2022-07-01-preview").PolicyExemption导入它。

23.1.0b1 (2023-05-19)

新增功能

• 添加了DeploymentStacksOperations操作组
• Model Location有一个新的参数availability_zone_mappings
• Model LocationMetadata有一个新的参数geography
• Model Operation有一个新的参数action_type
• Model Operation有一个新的参数is_data_action
• Model Operation有一个新的参数origin
• Model OperationAutoGenerated有一个新的参数action_type
• Model OperationAutoGenerated有一个新的参数is_data_action
• Model OperationAutoGenerated有一个新的参数origin
• Model OperationDisplayAutoGenerated有一个新的参数description

23.0.1 (2023-05-17)

其他更改

• 修复README.md

23.0.0 (2023-03-27)

新增功能

• 添加了ApplicationsOperations.begin_refresh_permissions操作
• 添加了PolicyExemptionsOperations.update操作
• 添加了JitRequestsOperations操作组
• Model Application有一个新的参数artifacts
• Model Application有一个新的参数authorizations
• Model Application有一个新的参数billing_details
• Model Application有一个新的参数created_by
• Model Application有一个新的参数customer_support
• Model Application有一个新的参数jit_access_policy
• Model Application有一个新的参数management_mode
• Model Application有一个新的参数publisher_tenant_id
• Model Application有一个新的参数support_urls
• Model Application有一个新的参数updated_by
• Model ApplicationDefinition有一个新的参数deployment_policy
• Model ApplicationDefinition有一个新的参数locking_policy
• Model ApplicationDefinition有一个新的参数management_policy
• Model ApplicationDefinition有一个新的参数notification_policy
• Model ApplicationDefinition有一个新的参数policies
• 模型 ApplicationPatchable 新增了参数 artifacts
• 模型 ApplicationPatchable 新增了参数 authorizations
• 模型 ApplicationPatchable 新增了参数 billing_details
• 模型 ApplicationPatchable 新增了参数 created_by
• 模型 ApplicationPatchable 新增了参数 customer_support
• 模型 ApplicationPatchable 新增了参数 jit_access_policy
• 模型 ApplicationPatchable 新增了参数 management_mode
• 模型 ApplicationPatchable 新增了参数 publisher_tenant_id
• 模型 ApplicationPatchable 新增了参数 support_urls
• 模型 ApplicationPatchable 新增了参数 updated_by
• 模型 PolicyAssignment 新增了参数 overrides
• 模型 PolicyAssignment 新增了参数 resource_selectors
• 模型 PolicyAssignmentUpdate 新增了参数 overrides
• 模型 PolicyAssignmentUpdate 新增了参数 resource_selectors
• 模型 PolicyExemption 新增了参数 assignment_scope_validation
• 模型 PolicyExemption 新增了参数 resource_selectors

破坏性更改

• 模型 ApplicationDefinition 不再需要参数 identity
• 模型 ApplicationArtifact 的参数 name 现在是必需的
• 模型 ApplicationArtifact 的参数 type 现在是必需的
• 模型 ApplicationArtifact 的参数 uri 现在是必需的

23.0.0b1 (2023-02-22)

新增功能

• 添加了ApplicationsOperations.begin_refresh_permissions操作
• 添加了JitRequestsOperations操作组
• Model Application有一个新的参数artifacts
• Model Application有一个新的参数authorizations
• Model Application有一个新的参数billing_details
• Model Application有一个新的参数created_by
• Model Application有一个新的参数customer_support
• Model Application有一个新的参数jit_access_policy
• Model Application有一个新的参数management_mode
• Model Application有一个新的参数publisher_tenant_id
• Model Application有一个新的参数support_urls
• Model Application有一个新的参数updated_by
• Model ApplicationDefinition有一个新的参数deployment_policy
• Model ApplicationDefinition有一个新的参数locking_policy
• Model ApplicationDefinition有一个新的参数management_policy
• Model ApplicationDefinition有一个新的参数notification_policy
• Model ApplicationDefinition有一个新的参数policies
• 模型 ApplicationPatchable 新增了参数 artifacts
• 模型 ApplicationPatchable 新增了参数 authorizations
• 模型 ApplicationPatchable 新增了参数 billing_details
• 模型 ApplicationPatchable 新增了参数 created_by
• 模型 ApplicationPatchable 新增了参数 customer_support
• 模型 ApplicationPatchable 新增了参数 jit_access_policy
• 模型 ApplicationPatchable 新增了参数 management_mode
• 模型 ApplicationPatchable 新增了参数 publisher_tenant_id
• 模型 ApplicationPatchable 新增了参数 support_urls
• 模型 ApplicationPatchable 新增了参数 updated_by

破坏性更改

• 模型 ApplicationDefinition 不再需要参数 identity
• 模型 ApplicationArtifact 的参数 name 现在是必需的
• 模型 ApplicationArtifact 的参数 type 现在是必需的
• 模型 ApplicationArtifact 的参数 uri 现在是必需的

22.1.0b1 (2023-02-16)

其他更改

• 在 github 仓库中添加了生成的示例
• 停止对 python<3.7.0 的支持

22.0.0 (2022-12-15)

破坏性更改

• 将操作 TagsOperations.create_or_update_at_scope 重命名为 TagsOperations.begin_create_or_update_at_scope
• 将操作 TagsOperations.delete_at_scope 重命名为 TagsOperations.begin_delete_at_scope
• 将操作 TagsOperations.update_at_scope 重命名为 TagsOperations.begin_update_at_scope

21.2.1 (2022-10-20)

已修复的错误

• 修复了分页操作中 next_link 的 urlencode

21.2.0 (2022-10-10)

新增功能

• 添加了操作组 VariableValuesOperations
• 添加了操作组 VariablesOperations

21.1.0 (2022-05-05)

新特性

• GA azure.mgmt.resource.changes

21.1.0b1 (2022-04-19)

新特性

• 添加了操作 TemplateSpecVersionsOperations.get_built_in
• 添加了操作 TemplateSpecVersionsOperations.list_built_ins
• 添加了操作 TemplateSpecsOperations.get_built_in
• 添加了操作 TemplateSpecsOperations.list_built_ins
• 添加了操作组 ChangesOperations
• 将操作文件合并为一个

修复

• 修复了分页操作中重复的查询参数（更多详情，请参阅 https://github.com/Azure/azure-sdk-for-python/issues/23828）

21.0.0 (2022-03-22)

新特性

• 添加了操作 PrivateLinkAssociationOperations.list
• 添加了操作 ResourceManagementPrivateLinkOperations.list_by_resource_group

重大变更

• 操作 PrivateLinkAssociationOperations.get 具有新的签名

20.1.0 (2022-01-25)

新特性

• 添加了操作 SubscriptionsOperations.check_zone_peers
• 添加了操作组 PrivateLinkAssociationOperations
• 添加了操作组 ResourceManagementPrivateLinkOperations
• 模型 ProviderResourceType 新增了参数 zone_mappings

20.0.0 (2021-09-03)

新特性

• 模型 PolicyAssignment 新增了参数 system_data
• 模型 PolicyDefinition 新增了参数 system_data
• 模型 Location 新增了参数 type
• 模型 PolicySetDefinition 新增了参数 system_data
• 模型 LocationMetadata 新增了参数 home_location
• 模型 TenantIdDescription 新增了参数 tenant_branding_logo_url
• 模型 TenantIdDescription 新增了参数 tenant_type
• 模型 TenantIdDescription 新增了参数 default_domain
• 添加了操作 PolicyAssignmentsOperations.update_by_id
• 添加了操作 PolicyAssignmentsOperations.update

重大变更

• 操作 ProvidersOperations.list_at_tenant_scope 具有新的签名
• 操作 ProvidersOperations.list 具有新的签名
• 操作 SubscriptionsOperations.list_locations 具有新的签名

19.0.0 (2021-07-19)

重大变更

• 操作 SubscriptionFeatureRegistrationsOperations.create_or_update 具有新的签名
• 操作 SubscriptionFeatureRegistrationsOperations.delete 具有新的签名
• 操作 SubscriptionFeatureRegistrationsOperations.get 具有新的签名
• 操作 SubscriptionFeatureRegistrationsOperations.list_by_subscription 具有新的签名

18.1.0 (2021-07-13)

新特性

• 添加了操作组 SubscriptionFeatureRegistrationsOperations

18.0.0 (2021-05-19)

重大变更

• 操作 ResourceGroupsOperations.begin_delete 具有新的签名

17.0.0 (2021-05-13)

新特性

• 模型 Provider 新增了参数 provider_authorization_consent_state
• 模型 TemplateSpec 新增了参数 metadata
• 模型 GenericResourceExpanded 新增了参数 extended_location
• 模型资源新增了参数 extended_location
• 模型模板版本SpecVersion新增了参数 ui_form_definition
• 模型模板版本SpecVersion新增了参数 metadata
• 模型模板版本SpecVersion新增了参数 linked_templates
• 模型模板版本SpecVersion新增了参数 main_template
• 模型 WhatIfChange新增了参数 unsupported_reason
• 模型通用资源GenericResource新增了参数 extended_location
• 新增操作 ProvidersOperations.provider_permissions

重大变更

• 操作 ProvidersOperations.register 有了新的签名
• 模型模板版本SpecVersion不再有参数 template
• 模型模板版本SpecVersion不再有参数 artifacts

16.1.0 (2021-04-16)

新特性

• 模型托管服务身份ManagedServiceIdentity新增了参数 tenant_id

16.0.0 (2021-02-26)

新特性

• 模型参数定义值元数据ParameterDefinitionsValueMetadata新增了参数 strong_type
• 模型参数定义值元数据ParameterDefinitionsValueMetadata新增了参数 assign_permissions
• 模型提供者资源类型ProviderResourceType新增了参数 location_mappings
• 模型部署属性DeploymentProperties新增了参数 expression_evaluation_options
• 模型策略分配PolicyAssignment新增了参数 non_compliance_messages
• 模型模板链接TemplateLink新增了参数 query_string
• 模型模板SpecSpecVersion新增了参数 versions
• 模型部署假设属性DeploymentWhatIfProperties新增了参数 expression_evaluation_options
• 新增操作 ApplicationDefinitionsOperations.get_by_id
• 新增操作 ApplicationDefinitionsOperations.begin_create_or_update_by_id
• 新增操作 ApplicationDefinitionsOperations.begin_delete_by_id
• 新增操作 ProvidersOperations.register_at_management_group_scope
• 新增操作 PolicySetDefinitionsOperations.list_by_management_group
• 新增操作 PolicyDefinitionsOperations.list_by_management_group
• 新增操作组 ProviderResourceTypesOperations
• 新增操作组 DataPolicyManifestsOperations
• 新增操作组 ApplicationClientOperationsMixin
• 新增操作组 PolicyExemptionsOperations

重大变更

• 操作 PolicyAssignmentsOperations.list 有了新的签名
• 操作 PolicyAssignmentsOperations.list_for_management_group 有了新的签名
• 操作 PolicyAssignmentsOperations.list_for_resource 有了新的签名
• 操作 PolicyAssignmentsOperations.list_for_resource_group 有了新的签名
• 操作 TemplateSpecsOperations.get 有了新的签名
• 操作 TemplateSpecsOperations.list_by_resource_group 有了新的签名
• 操作 TemplateSpecsOperations.list_by_subscription 有了新的签名
• 模型策略分配PolicyAssignment不再有参数 sku
• 操作 PolicySetDefinitionsOperations.list_built_in 有了新的签名
• 操作 PolicySetDefinitionsOperations.list 有了新的签名
• 操作 PolicyDefinitionsOperations.list_built_in 有了新的签名
• 操作 PolicyDefinitionsOperations.list 有了新的签名

15.0.0 (2020-09-17)

新特性

• 模型提供者资源类型ProviderResourceType新增了参数 default_api_version
• 模型提供者资源类型ProviderResourceType新增了参数 api_profiles
• 模型 AzureResourceBase新增了参数 system_data
• 模型别名路径AliasPath新增了参数 metadata
• 模型模板链接TemplateLink新增了参数 id
• 模型模板链接TemplateLink新增了参数 relative_path
• 模型别名Alias新增了参数 default_metadata
• 新增操作 DeploymentsOperations.begin_what_if_at_management_group_scope
• 新增操作 DeploymentsOperations.begin_what_if_at_tenant_scope
• 新增操作组 TemplateSpecsOperations
• 新增操作组 TemplateSpecVersionsOperations
• 新增操作组 SubscriptionClientOperationsMixin

15.0.0b1 (2020-06-17)

这是beta预览版本。

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

一般破坏性变更

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

  • azure.common.credentials 或 msrestazure.azure_active_directory 实例不再受支持，请使用 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）。

• 大多数操作关键字段已更改。其中一些最显著的更改包括：

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

通用新功能：

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

10.0.0 (2020-06-02)

新特性

• 模型AzurePowerShellScript有一个新的参数storage_account_settings。
• 模型DeploymentOperationProperties有一个新的参数provisioning_operation。
• 模型AzureCliScript有一个新的参数storage_account_settings。

重大变更

• 模型AliasPathType不再有参数pattern。

9.0.0 (2020-03-31)

新特性

• 模型Location有一个新的参数metadata。
• 模型Location有一个新的参数regional_display_name。
• 模型Deployment有一个新的参数tags。
• 模型AliasPathType有一个新的参数pattern。
• 模型ScopedDeployment有一个新的参数tags。
• 模型DeploymentPropertiesExtended有一个新的参数template_hash。
• 模型DeploymentPropertiesExtended有一个新的参数validated_resources。
• 模型DeploymentPropertiesExtended有一个新的参数error。
• 模型DeploymentPropertiesExtended有一个新的参数output_resources。
• 模型DeploymentExtended有一个新的参数tags。
• 模型Subscription有一个新的参数tags。
• 添加了操作FeaturesOperations.unregister。
• 添加了操作TagsOperations.get_at_scope。
• 添加了操作TagsOperations.update_at_scope。
• 添加了操作TagsOperations.delete_at_scope。
• 添加了操作TagsOperations.create_or_update_at_scope。
• 添加了操作组DeploymentScriptsOperations。

重大变更

• 模型Location不再有参数latitude。
• 模型Location不再有参数longitude。
• 模型DeploymentPropertiesExtended不再有参数template。
• 模型TagsResource不再有参数tags。
• 模型TagsResource不再有参数location。
• 操作DeploymentsOperations.validate_at_management_group_scope有一个新的签名。
• 操作DeploymentsOperations.validate_at_subscription_scope有一个新的签名。
• 操作DeploymentsOperations.create_or_update_at_subscription_scope有一个新的签名。
• 操作DeploymentsOperations.create_or_update_at_tenant_scope有一个新的签名。
• 操作DeploymentsOperations.create_or_update_at_scope有一个新的签名。
• 操作DeploymentsOperations.validate有一个新的签名。
• 操作DeploymentsOperations.create_or_update有一个新的签名。
• 操作DeploymentsOperations.validate_at_scope有一个新的签名。
• 操作DeploymentsOperations.validate_at_tenant_scope有一个新的签名。
• 操作DeploymentsOperations.create_or_update_at_management_group_scope有一个新的签名。
• 模型TenantIdDescription有一个新的签名。
• 移除了操作TagsOperations.resource_get。
• 移除了操作TagsOperations.resource_delete。
• 移除了操作TagsOperations.resource_create。
• 移除了操作TagsOperations.resource_update。

8.0.1 (2020-02-04)

错误修复：

• 添加了缺失的API版本。

8.0.0 (2020-01-24)

新特性

• 添加了操作PolicyAssignmentsOperations.list_for_management_group。

重大变更

• 操作DeploymentsOperations.create_or_update_at_tenant_scope有一个新的签名。
• 操作DeploymentsOperations.validate_at_tenant_scope有一个新的签名。
• 操作DeploymentsOperations.validate_at_management_group_scope有一个新的签名。
• 操作DeploymentsOperations.create_or_update_at_management_group_scope有一个新的签名。

7.0.0 (2019-12-07)

新特性

• 模型TenantIdDescription有一个新的参数display_name。
• 模型TenantIdDescription有一个新的参数domains。
• 模型Application有一个新的参数ui_definition_uri。
• 模型ApplicationPatchable有一个新的参数ui_definition_uri。

重大变更

• 操作DeploymentsOperations.create_or_update_at_tenant_scope有一个新的签名。
• 操作DeploymentsOperations.create_or_update_at_management_group_scope有一个新的签名。
• 操作DeploymentsOperations.validate_at_management_group_scope有一个新的签名。
• 操作DeploymentsOperations.validate_at_tenant_scope有一个新的签名。
• 模型PolicySetDefinition不再有参数policy_definition_groups。
• 模型Subscription不再有参数managed_by_tenants。
• 模型DeploymentValidateResult不再有参数error。
• 移除了操作DeploymentsOperations.what_if。
• 已移除操作 DeploymentsOperations.what_if_at_subscription_scope
• Model PolicyDefinitionReference 有了一个新的签名

6.0.0 (2019-11-01)

新特性

• Model PolicySetDefinition 有了一个新的参数 policy_definition_groups

重大变更

• 操作DeploymentsOperations.validate_at_tenant_scope有一个新的签名。
• 操作DeploymentsOperations.create_or_update_at_management_group_scope有一个新的签名。
• 操作DeploymentsOperations.validate_at_management_group_scope有一个新的签名。
• 操作DeploymentsOperations.create_or_update_at_tenant_scope有一个新的签名。
• Model PolicyDefinitionReference 有了一个新的签名

5.1.0 (2019-10-04)

新特性

• 添加了操作 DeploymentsOperations.what_if
• 添加了操作 DeploymentsOperations.what_if_at_subscription_scope

5.0.0 (2019-09-22)

新特性

• Model DeploymentValidateResult 有了一个新的参数 error
• Model Subscription 有了一个新的参数 managed_by_tenants

重大变更

• Model Application 不再有参数 ui_definition_uri
• Model ApplicationPatchable 不再有参数 ui_definition_uri
• Model TenantIdDescription 不再有参数 display_name
• Model TenantIdDescription 不再有参数 domains

4.0.0 (2019-09-03)

新特性

• Model PolicyAssignment 有了一个新的参数 enforcement_mode
• 添加了操作 DeploymentOperations.get_at_scope
• 添加了操作 DeploymentOperations.list_at_tenant_scope
• 添加了操作 DeploymentOperations.get_at_tenant_scope
• 添加了操作 DeploymentOperations.list_at_scope
• 添加了操作 DeploymentsOperations.create_or_update_at_tenant_scope
• 添加了操作 DeploymentsOperations.list_at_tenant_scope
• 添加了操作 DeploymentsOperations.delete_at_scope
• 添加了操作 DeploymentsOperations.cancel_at_tenant_scope
• 添加了操作 DeploymentsOperations.list_at_scope
• 添加了操作 DeploymentsOperations.get_at_scope
• 添加了操作 DeploymentsOperations.export_template_at_tenant_scope
• 添加了操作 DeploymentsOperations.validate_at_scope
• 添加了操作 DeploymentsOperations.delete_at_tenant_scope
• 添加了操作 DeploymentsOperations.export_template_at_scope
• 添加了操作 DeploymentsOperations.validate_at_tenant_scope
• 添加了操作 DeploymentsOperations.create_or_update_at_scope
• 添加了操作 DeploymentsOperations.check_existence_at_tenant_scope
• 添加了操作 DeploymentsOperations.check_existence_at_scope
• 添加了操作 DeploymentsOperations.cancel_at_scope
• 添加了操作 DeploymentsOperations.get_at_tenant_scope
• 添加了操作 DeploymentsOperations.calculate_template_hash
• 添加了操作 ProvidersOperations.list_at_tenant_scope
• 添加了操作 ProvidersOperations.get_at_tenant_scope

重大变更

• 模型DeploymentValidateResult不再有参数error。
• Model ErrorResponse 有了一个新的签名

3.1.0 (2019-07-20)

新特性

• 模型TenantIdDescription有一个新的参数domains。
• 模型TenantIdDescription有一个新的参数display_name。

3.0.0 (2019-06-13)

新特性

• Model Provider 有了一个新的参数 registration_policy
• Model ProviderResourceType 有了一个新的参数 capabilities
• Model DeploymentOperationProperties 有了一个新的参数 duration
• Model DeploymentPropertiesExtended 有了一个新的参数 duration
• 添加了操作 DeploymentOperations.get_at_management_group_scope
• 添加了操作 DeploymentOperations.list_at_management_group_scope
• 添加了操作 DeploymentsOperations.export_template_at_management_group_scope
• 添加了操作 DeploymentsOperations.create_or_update_at_management_group_scope
• 添加了操作 DeploymentsOperations.list_at_management_group_scope
• 添加了操作 DeploymentsOperations.get_at_management_group_scope
• 添加了操作 DeploymentsOperations.check_existence_at_management_group_scope
• 添加了操作 DeploymentsOperations.cancel_at_management_group_scope
• 添加了操作 DeploymentsOperations.delete_at_management_group_scope
• 添加了操作 DeploymentsOperations.validate_at_management_group_scope
• 策略默认 API 版本现在是 2018-05-01

通用重大更改

本版本使用了一个下一代代码生成器，它可能会在您从 v20xx_yy_zz API 文件夹导入时引入重大更改。简而言之，一些模块被错误地可见/导入，并已被重命名。这解决了由于使用本不应该使用的类而引起的一些问题。

以下适用于所有客户端和命名空间，我们以 ResourceManagementClient 和 "resources" 为例：- ResourceManagementClient 不能从 azure.mgmt.resource.resources.v20xx_yy_zz.resource_management_client 中导入（从 azure.mgmt.resource.resources.v20xx_yy_zz 的导入与之前相同）- ResourceManagementClientConfiguration 的导入已从 azure.mgmt.resource.resources.v20xx_yy_zz.resource_management_client 移至 azure.mgmt.resource.resources.v20xx_yy_zz - 来自 "models" 子模块的模型 MyClass 不能再使用 azure.mgmt.resource.resources.v20xx_yy_zz.models.my_class 导入（从 azure.mgmt.resource.resources.v20xx_yy_zz.models 的导入与之前相同）- 来自 operations 子模块的操作类 MyClassOperations 不能再使用 azure.mgmt.resource.resources.v20xx_yy_zz.operations.my_class_operations 导入（从 azure.mgmt.resource.resources.v20xx_yy_zz.operations 的导入与之前相同）

最后但同样重要的是，HTTP连接池现在默认启用。您应该始终使用客户端作为上下文管理器，或者调用close()，或者每个进程使用不超过一个客户端。

2.2.0 (2019-05-23)

订阅功能

• 现在返回订阅信息中的tenant_id部分

锁功能

• 添加list_by_scope

2.1.0 (2019-02-01)

策略功能

• 策略的新API版本2018-05-01
• Model PolicyAssignment有新的参数location
• Model PolicyAssignment有新的参数identity

2.0.0 (2018-07-20)

新特性

• Identity类现在有user_assigned_identities属性
• Client类可以用作上下文管理器，以保持底层HTTP会话打开以提高性能

2.0.0rc2 (2018-06-13)

策略功能

• 策略的新API版本2018-03-01。这是2017-06-01-preview和2016-12-01的合并，没有外部API破坏。

资源功能

• 资源新的Api版本2018-05-01
• Model Deployment有新的参数location
• Model DeploymentExtended有新的参数location
• 添加操作DeploymentsOperations.export_template_at_subscription_scope
• 添加操作DeploymentsOperations.get_at_subscription_scope
• 添加操作DeploymentsOperations.cancel_at_subscription_scope
• 添加操作DeploymentsOperations.delete_at_subscription_scope
• 添加操作DeploymentsOperations.create_or_update_at_subscription_scope
• 添加操作DeploymentsOperations.validate_at_subscription_scope
• 添加操作DeploymentsOperations.check_existence_at_subscription_scope
• 添加操作DeploymentsOperations.list_at_subscription_scope
• 添加操作DeploymentOperations.get_at_subscription_scope
• 添加操作DeploymentOperations.list_at_subscription_scope

资源上的破坏性变更

• 操作DeploymentsOperations.create_or_update丢失了被忽略的"location"参数。
• 操作DeploymentsOperations.validate丢失了被忽略的"location"参数。

公共功能

• Client类可以用作上下文管理器，以保持底层HTTP会话打开以提高性能

2.0.0rc1 (2018-04-23)

通用重大更改

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

• 模型签名现在只使用关键字参数语法。所有位置参数必须重写为关键字参数。为了在大多数情况下保持自动完成，现在为Python 2和Python 3生成了模型。Python 3使用"*"语法来表示关键字参数。
• 枚举类型现在使用"str"混合（类AzureEnum(str, Enum)），以改善遇到未识别枚举值时的行为。虽然这不是破坏性变更，但区别很重要，这里进行了说明：[https://docs.pythonlang.cn/3/library/enum.html#others](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`在轮询完成后调用将不再引发异常，而是立即执行回调。

新特性

• 添加新的ApiVersion 2018-02-01（新默认值）
  • 添加on_error_deployment
  • 在通用ARM资源中支持MSI
• 所有客户端现在支持Azure配置文件。
• 添加通用资源更新（2017-05-10和2018-02-01）
• 添加计划版本

错误修复：

• 与wheel 0.31.0的sdist兼容性

1.2.2 (2017-10-17)

错误修复

• 在Python 2.7中，Unicode字符串是有效的“subscription_id”
• 添加了一些弃用警告

1.2.1 (2017-10-06)

错误修复：

• 在未知策略资源上使用“Get”应引发异常，而不是返回None

1.2.0 (2017-10-05)

新特性

• 添加 validate_move_resources
• 将模式和元数据添加到 PolicyDefinition
• 添加 policy_definitions.get_built_in
• 添加 policy_definitions.list_built_in
• 添加 policy_definitions.create_or_update_at_management_group
• 添加 policy_definitions.delete_at_management_group
• 添加 policy_definitions.get_at_management_group
• 添加 policy_definitions.list_by_management_group
• 添加 Policy 2017-06-01-preview 的预览版本
  • 添加 policy_set_definitions 操作组
  • 将策略集定义添加到 policy_assignments 操作组
  • 将 skus 添加到策略分配

错误修复

• 删除策略分配时不要在 204 失败（2016-12-01）

预览客户端的破坏性更改

• 主要重命名到 ManagedApplication 客户端，GA ApiVersion 2017-09-01

免责声明

• 我们移除了 policy_definitions.list 方法的 "filter" 参数。然而，我们没有升级包的主要版本，因为这个参数对 RestAPI 没有意义，并且没有任何方式让 Python 用户能够使用它。

1.1.0 (2017-05-15)

• 将 1.1.0rc2 标记为稳定（相同内容）

1.1.0rc2（2017-05-12）

• 添加 Policy ApiVersion 2015-10-01-preview（AzureStack 默认）

1.1.0rc1（2017-05-08）

• 新默认 ApiVersion 现在是 2017-05-10。1.0.0rc3 中描述的破坏性更改现在默认应用。

1.0.0rc3（2017-05-04）

错误修复

• 订阅：移除了已弃用的租户 ID
• 托管应用程序：所有列表方法都返回一个迭代器

添加新的资源 ApiVersion 2017-05-10

• 从一个模板部署资源到多个资源组

• 与之前版本相比，引入了一些破坏性更改

  • deployments.list 已重命名为 deployments.list_by_resource_group
  • resource_groups.list_resources 已移动到 resources.list_by_resource_group
  • resource_groups.patch 已重命名为 resource_groups.update，现在接受 ResourceGroupPatchable 实例（而不是 ResourceGroup）。

在此包中默认仍然是 2016-09-01，等待 ApiVersion 广泛可用。

1.0.0rc2（2017-05-02）

• 添加托管应用程序客户端（预览）

1.0.0rc1（2017-04-11）

错误修复

• tag_count 现在是正确的 int 而不是字符串
• deployment_properties 现在对于所有部署操作都是必需的，如预期

破坏性更改

• Locks 移动到新的 ApiVersion，并带来了几个命名重构和新方法

新特性

为了帮助具有主权云（非通用 Azure）的客户，此版本对以下资源类型提供官方多 ApiVersion 支持

• Locks：2015-01-01 和 2016-09-01
• Policy：2016-04-01 和 2016-12-01
• Resources：2016-02-01 和 2016-09-01

以下资源类型支持一个 ApiVersion

• Features：2015-12-01
• Links：2016-09-01
• Subscriptions：2016-06-01

0.31.0 (2016-11-10)

破坏性更改

• Resource.Links 'create_or_update' 方法具有更简单的参数

0.30.2 (2016-10-20)

新特性

• 添加 Resource.Links 客户端

0.30.1 (2016-10-17)

错误修复：

• 位置现在是正确地声明为可选的，而不是必需的。

0.30.0 (2016-10-04)

• 预览发布。基于 API 版本 2016-09-01。

0.20.0 (2015-08-31)

• 初始预览发布。基于 API 版本 2014-04-01-preview