Microsoft Azure SDK for Python

这是Microsoft Azure授权管理客户端库。此包已在Python 3.7+上进行了测试。有关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.7+。
• Azure 订阅

安装包

pip install azure-mgmt-authorization
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.authorization import AuthorizationManagementClient
import os

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

示例

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

• 在 docs.microsoft.com 上搜索授权管理
• Azure Python 管理SDK 示例存储库

故障排除

下一步

提供反馈

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

发行历史

4.0.0 (2023-07-21)

新增功能

• 添加了操作 RoleAssignmentScheduleRequestsOperations.validate
• 添加了操作 RoleEligibilityScheduleRequestsOperations.validate
• 模型 AlertConfiguration 有一个新参数 alert_definition
• 模型 AlertConfigurationProperties 有一个新参数 alert_definition
• 模型 AlertOperationResult 有一个新参数 created_date_time
• 模型 AlertOperationResult 有一个新参数 last_action_date_time
• 模型 AlertOperationResult 有一个新参数 resource_location
• 模型 AlertOperationResult 有一个新参数 status_detail
• 模型 AzureRolesAssignedOutsidePimAlertConfigurationProperties 有一个新参数 alert_definition
• 模型 DenyAssignment 有一个新参数 condition
• 模型 DenyAssignment 有一个新参数 condition_version
• 模型 DenyAssignment 有一个新参数 created_by
• 模型 DenyAssignment 有一个新参数 created_on
• 模型 DenyAssignment 有一个新参数 updated_by
• 模型 DenyAssignment 有一个新参数 updated_on
• 模型 DuplicateRoleCreatedAlertConfigurationProperties 有一个新参数 alert_definition
• 模型 Permission 有一个新参数 condition
• 模型 Permission 有一个新参数 condition_version
• 模型 RoleDefinition 有一个新参数 created_by
• 模型 RoleDefinition 有一个新参数 created_on
• 模型 RoleDefinition 有一个新参数 updated_by
• 模型 RoleDefinition 有一个新参数 updated_on
• 模型 TooManyOwnersAssignedToResourceAlertConfigurationProperties 有一个新参数 alert_definition
• 模型 TooManyPermanentOwnersAssignedToResourceAlertConfigurationProperties 有一个新参数 alert_definition

破坏性更改

• 删除了操作 AlertOperationOperations.list_for_scope

3.1.0b1 (2023-02-15)

新增功能

• 模型 AlertConfiguration 有一个新参数 alert_definition
• 模型 AlertConfigurationProperties 有一个新参数 alert_definition
• 模型 AzureRolesAssignedOutsidePimAlertConfigurationProperties 有一个新参数 alert_definition
• 模型 DenyAssignment 有一个新参数 condition
• 模型 DenyAssignment 有一个新参数 condition_version
• 模型 DenyAssignment 有一个新参数 created_by
• 模型 DenyAssignment 有一个新参数 created_on
• 模型 DenyAssignment 有一个新参数 updated_by
• 模型 DenyAssignment 有一个新参数 updated_on
• 模型 DuplicateRoleCreatedAlertConfigurationProperties 有一个新参数 alert_definition
• 模型 RoleDefinition 有一个新参数 created_by
• 模型 RoleDefinition 有一个新参数 created_on
• 模型 RoleDefinition 有一个新参数 updated_by
• 模型 RoleDefinition 有一个新参数 updated_on
• 模型 TooManyOwnersAssignedToResourceAlertConfigurationProperties 有一个新参数 alert_definition
• 模型 TooManyPermanentOwnersAssignedToResourceAlertConfigurationProperties 有一个新参数 alert_definition

3.0.0 (2022-10-11)

新增功能

• 添加了操作 AccessReviewInstancesOperations.create
• 添加了操作组 AccessReviewHistoryDefinitionInstanceOperations
• 添加了操作组 AccessReviewHistoryDefinitionInstancesOperations
• 添加了操作组 AccessReviewHistoryDefinitionOperations
• 添加了操作组 AccessReviewHistoryDefinitionsOperations
• 添加了操作组 AccessReviewInstanceContactedReviewersOperations
• 添加了操作组 AlertConfigurationsOperations
• 添加了操作组 AlertDefinitionsOperations
• 添加了操作组 AlertIncidentsOperations
• 添加了操作组 AlertOperationOperations
• 添加了操作组 AlertsOperations
• 添加了操作组 ScopeAccessReviewDefaultSettingsOperations
• 添加了操作组 ScopeAccessReviewHistoryDefinitionInstanceOperations
• 添加了操作组 ScopeAccessReviewHistoryDefinitionInstancesOperations
• 添加了操作组 ScopeAccessReviewHistoryDefinitionOperations
• 添加了操作组 ScopeAccessReviewHistoryDefinitionsOperations
• 添加了操作组 ScopeAccessReviewInstanceContactedReviewersOperations
• 添加了操作组 ScopeAccessReviewInstanceDecisionsOperations
• 添加了操作组 ScopeAccessReviewInstanceOperations
• 添加了操作组 ScopeAccessReviewInstancesOperations
• 添加了操作组 ScopeAccessReviewScheduleDefinitionsOperations
• 添加了操作组 TenantLevelAccessReviewInstanceContactedReviewersOperations
• 模型 AccessReviewDecision 有一个新参数 insights
• 模型 AccessReviewDecision 有一个新参数 membership_types
• 模型 AccessReviewDecisionProperties 有一个新参数 insights
• 模型 AccessReviewDecisionProperties 有一个新参数 membership_types
• 模型 AccessReviewDefaultSettings 新增参数 recommendation_look_back_duration
• 模型 AccessReviewInstance 新增参数 backup_reviewers
• 模型 AccessReviewInstance 新增参数 reviewers
• 模型 AccessReviewInstance 新增参数 reviewers_type
• 模型 AccessReviewScheduleDefinition 新增参数 exclude_resource_id
• 模型 AccessReviewScheduleDefinition 新增参数 exclude_role_definition_id
• 模型 AccessReviewScheduleDefinition 新增参数 expand_nested_memberships
• 模型 AccessReviewScheduleDefinition 新增参数 include_access_below_resource
• 模型 AccessReviewScheduleDefinition 新增参数 include_inherited_access
• 模型 AccessReviewScheduleDefinition 新增参数 recommendation_look_back_duration
• 模型 AccessReviewScheduleDefinitionProperties 新增参数 exclude_resource_id
• 模型 AccessReviewScheduleDefinitionProperties 新增参数 exclude_role_definition_id
• 模型 AccessReviewScheduleDefinitionProperties 新增参数 expand_nested_memberships
• 模型 AccessReviewScheduleDefinitionProperties 新增参数 include_access_below_resource
• 模型 AccessReviewScheduleDefinitionProperties 新增参数 include_inherited_access
• 模型 AccessReviewScheduleDefinitionProperties 新增参数 recommendation_look_back_duration
• 模型 AccessReviewScheduleSettings 新增参数 recommendation_look_back_duration
• 模型 DenyAssignmentPermission 新增参数 condition
• 模型 DenyAssignmentPermission 新增参数 condition_version

破坏性更改

• 操作 RoleAssignmentsOperations.list_for_scope 新增参数 skip_token
• 移除操作 RoleAssignmentsOperations.validate
• 移除操作 RoleAssignmentsOperations.validate_by_id

2.0.0 (2021-09-26)

功能

• 模型 RoleAssignment 新增参数 created_on
• 模型 RoleAssignment 新增参数 delegated_managed_identity_resource_id
• 模型 RoleAssignment 新增参数 updated_by
• 模型 RoleAssignment 新增参数 condition
• 模型 RoleAssignment 新增参数 description
• 模型 RoleAssignment 新增参数 updated_on
• 模型 RoleAssignment 新增参数 condition_version
• 模型 RoleAssignment 新增参数 created_by
• 添加操作 RoleAssignmentsOperations.validate
• 添加操作 RoleAssignmentsOperations.list_for_subscription
• 添加操作 RoleAssignmentsOperations.validate_by_id
• 添加操作 RoleAssignmentsOperations.create_by_id
• 添加操作 RoleAssignmentsOperations.get_by_id
• 添加操作 RoleAssignmentsOperations.delete_by_id
• 添加操作组 AccessReviewInstancesAssignedForMyApprovalOperations
• 添加操作组 RoleManagementPolicyAssignmentsOperations
• 添加操作组 EligibleChildResourcesOperations
• 添加操作组 AccessReviewInstanceDecisionsOperations
• 添加操作组 RoleAssignmentSchedulesOperations
• 添加操作组 RoleEligibilityScheduleRequestsOperations
• 添加操作组 RoleEligibilitySchedulesOperations
• 添加操作组 RoleAssignmentScheduleInstancesOperations
• 添加操作组 AccessReviewInstanceMyDecisionsOperations
• 添加操作组 RoleAssignmentApprovalStepOperations
• 添加操作组 AccessReviewInstancesOperations
• 添加操作组 AccessReviewScheduleDefinitionsOperations
• 添加操作组 ScopeRoleAssignmentApprovalOperations
• 添加操作组 RoleAssignmentScheduleRequestsOperations
• 添加操作组 RoleAssignmentApprovalStepsOperations
• 添加操作组 RoleAssignmentApprovalOperations
• 添加操作组 ScopeRoleAssignmentApprovalStepsOperations
• 添加操作组 AccessReviewDefaultSettingsOperations
• 添加操作组 RoleEligibilityScheduleInstancesOperations
• 添加操作组 AccessReviewScheduleDefinitionsAssignedForMyApprovalOperations
• 添加操作组 ScopeRoleAssignmentApprovalStepOperations
• 添加操作组 RoleAssignmentMetricsOperations
• 添加操作组 RoleManagementPoliciesOperations
• 添加操作组 Operations
• 添加操作组 AccessReviewInstanceOperations

重大变更

• 操作 RoleAssignmentsOperations.list_for_resource 有新签名
• 操作 RoleAssignmentsOperations.delete 有新签名
• 操作 RoleAssignmentsOperations.get 有新签名
• 操作 RoleAssignmentsOperations.list_for_resource 有新签名
• 操作 RoleAssignmentsOperations.list_for_resource_group 有新签名
• 操作 RoleAssignmentsOperations.list_for_scope 有新签名
• 模型 RoleAssignmentFilter 不再具有参数 can_delegate
• 模型 RoleAssignment 不再具有参数 can_delegate
• 模型 Principal 有新签名
• 模型 RoleAssignmentCreateParameters 有了新的签名
• 移除了操作 RoleAssignmentsOperations.list

1.0.0 (2020-11-23)

1.0.0b1 (2020-10-13)

这是一个测试预览版本。

本版本使用新一代代码生成器，引入了重要的不兼容更改，但也引入了重要的新功能（如统一认证和异步编程）。

一般的不兼容更改

• 凭证系统已完全重做

  • 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 属性不再存在，配置应作为关键字参数传递。例如：MyClient(credential, subscription_id, enable_logging=True)。有关支持的所有选项的完整列表，请参阅[azure-core 初始化文档中接受的参数](https://github.com/Azure/azure-sdk-for-python/blob/main/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）。

• 大多数操作关键字参数都发生了变化。其中一些最明显的更改

  • raw 已被删除。等效功能可以通过使用 cls（一个将提供对内部 HTTP 响应的访问的回调）找到
  • 有关支持的所有选项的完整列表，请参阅[azure-core 请求文档中接受的参数](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)

一般的新功能

• 支持使用 typing 进行类型注解。SDKs 是 mypy 准备好的。
• 现在，该客户端具有稳定和官方的异步支持。检查您的包中的 aio 命名空间以查找异步客户端。
• 现在，客户端原生支持如 OpenCensus 或 OpenTelemetry 这样的跟踪库。查看这个[跟踪快速入门](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/core/azure-core-tracing-opentelemetry)以获取概述。

0.61.0 (2020-08-10)

功能

• 模型 RoleAssignmentCreateParameters 添加了新的参数 condition
• 模型 RoleAssignmentCreateParameters 添加了新的参数 description
• 模型 RoleAssignmentCreateParameters 添加了新的参数 condition_version
• 模型 RoleAssignment 新增参数 condition
• 模型 RoleAssignment 新增参数 description
• 模型 RoleAssignment 新增参数 condition_version

0.60.0 (2019-06-25)

重大变更

• 将 elevate_access.post 重命名为 global_administrator.elevate_access

一般的不兼容更改

本版本使用新一代代码生成器，可能引入不兼容更改，如果您是从 v20xx_yy_zz API 文件夹导入的。总的来说，一些模块被错误地可见/可导入，并且已被重命名。这修复了由于使用本来不应该使用的类而导致的一些问题。

• 无法从 azure.mgmt.authorization.v20xx_yy_zz.authorization_management_client 导入 AuthorizationManagementClient（从 azure.mgmt.authorization.v20xx_yy_zz 导入与之前一样工作）
• AuthorizationManagementClientConfiguration 的导入已从 azure.mgmt.authorization.v20xx_yy_zz.authorization_management_client 移动到 azure.mgmt.authorization.v20xx_yy_zz
• 无法使用 azure.mgmt.authorization.v20xx_yy_zz.models.my_class 从 "models" 子模块导入模型 MyClass（从 azure.mgmt.authorization.v20xx_yy_zz.models 导入与之前一样工作）
• 无法使用 azure.mgmt.authorization.v20xx_yy_zz.operations.my_class_operations 从 operations 子模块导入操作类 MyClassOperations（从 azure.mgmt.authorization.v20xx_yy_zz.operations 导入与之前一样工作）

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

0.52.0 (2019-05-23)

功能

• 添加 elevate_access API

0.51.1 (2018-11-27)

错误修复

• 角色分配类中缺少 principal_type #3802

0.51.0 (2018-11-12)

功能

• 模型 RoleAssignmentCreateParameters 添加了新的参数 principal_type

重大变更

• 模型 RoleAssignmentCreateParameters 的参数 role_definition_id 现在是必需的
• 模型RoleAssignmentCreateParameters的principal_id参数现在是必需的

角色分配API版本现在是2018-09-01-preview

0.50.0 (2018-05-29)

功能

• 支持Azure Stack（多API版本控制）
• 客户端类可以用作上下文管理器，以保持底层HTTP会话打开以提高性能

错误修复

• 与wheel 0.31.0的sdist兼容性

0.40.0 (2018-03-13)

重大变更

• 已将几个属性扁平化，“properties”属性不再需要（例如，properties.email_address => email_address）
• 某些方法签名已更改（例如，create_by_id）

功能

• 添加了data_actions / not_data_actions / is_data_actions属性

API版本现在是2018-01-01-preview

0.30.0 (2017-04-28)

• 初始发布
• 此wheel包使用azure wheel扩展构建