Microsoft Azure SDK for Python

这是Microsoft Azure Msi Management Client Library。此包已与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-msi
pip install azure-identity

身份验证

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

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

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

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

from azure.identity import DefaultAzureCredential
from azure.mgmt.msi import ManagedServiceIdentityClient
import os

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

示例

该包的代码示例可以在 docs.microsoft.com 的 Msi Management 和 Samples Repo 找到

故障排除

下一步操作

提供反馈

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

发行历史

7.0.0 (2023-02-02)

新增功能

• Model FederatedIdentityCredential 添加了新的参数 system_data
• Model Identity 添加了新的参数 system_data
• Model IdentityUpdate 添加了新的参数 system_data
• Model ProxyResource 添加了新的参数 system_data
• Model Resource 添加了新的参数 system_data
• Model SystemAssignedIdentity 添加了新的参数 system_data
• Model TrackedResource 添加了新的参数 system_data

重大变更

• 删除了操作 UserAssignedIdentitiesOperations.list_associated_resources

6.1.0 (2022-06-29)

功能

• 添加了操作组 FederatedIdentityCredentialsOperations

6.0.1 (2022-05-05)

其他更改

• 将内部文件夹名称从 v2019_09_01_preview 更改为 v2021_09_30_preview

6.0.0 (2022-03-29)

重大变更

• 从单个 API 包更改为多个 API 包，允许用户在客户端传递不同的 API 版本。

6.0.0b2 (2022-03-24)

功能

• 添加了操作 UserAssignedIdentitiesOperations.list_associated_resources

6.0.0b1 (2021-05-19)

这是 beta 预览版本。

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

一般性重大变更

• 凭据系统已完全重造

  • 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/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》已删除）。

• 大多数操作 kwarg 都已更改。一些最显著的更改

  • 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 进行类型注解。SDK 已为 mypy 准备就绪。
• 此客户端现在提供稳定和官方的异步支持。检查您包的 aio 命名空间以找到异步客户端。
• 此客户端现在原生支持 OpenCensus 或 OpenTelemetry 等跟踪库。请参阅此 [跟踪快速入门](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/core/azure-core-tracing-opentelemetry) 以了解概述。

1.0.0 (2019-05-16)

注意

本包使用稳定的API版本2018-11-30，与0.2.0版本相比不暴露任何API更改。

0.2.0 (2018-05-25)

功能

• 客户端类可以作为上下文管理器使用，以保持底层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将不再引发异常，而是立即执行回调。

错误修复

• 与wheel 0.31.0的sdist兼容性

0.1.0 (2017-12-13)

• 初始发布