Microsoft Azure SDK for Python

这是Microsoft Azure Power BI Embedded 管理客户端库。此包已在Python 3.8+上进行了测试。要查看Azure库的更完整视图，请参阅azure sdk python release。

免责声明

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-powerbiembedded
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.powerbiembedded import PowerBIEmbeddedManagementClient
import os

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

示例

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

• 在 docs.microsoft.com 上搜索 Power BI Embedded Management
• Azure Python Mgmt SDK 示例存储库

故障排除

下一步

提供反馈

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

版本历史

3.0.0 (2024-06-24)

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

一般破坏性更改

• 凭证系统已被完全重写

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

新增功能

• 添加了 PowerBIEmbeddedManagementClientOperationsMixin 操作组

破坏性更改

• 操作 WorkspaceCollectionsOperations.check_name_availability 有一个新必需参数 body
• 操作 WorkspaceCollectionsOperations.check_name_availability 有一个新必需参数 kwargs
• 操作 WorkspaceCollectionsOperations.check_name_availability 已不再有参数 name
• 操作 WorkspaceCollectionsOperations.check_name_availability 已不再有参数 type
• 操作 WorkspaceCollectionsOperations.create 添加了一个新的必需参数 body
• 操作 WorkspaceCollectionsOperations.create 添加了一个新的必需参数 kwargs
• 操作 WorkspaceCollectionsOperations.create 已不再有参数 location
• 操作 WorkspaceCollectionsOperations.create 已不再有参数 tags
• 操作 WorkspaceCollectionsOperations.get_access_keys 添加了一个新的必需参数 kwargs
• 操作 WorkspaceCollectionsOperations.get_by_name 添加了一个新的必需参数 kwargs
• 操作 WorkspaceCollectionsOperations.list_by_resource_group 添加了一个新的必需参数 kwargs
• 操作 WorkspaceCollectionsOperations.list_by_subscription 添加了一个新的必需参数 kwargs
• 操作 WorkspaceCollectionsOperations.migrate 添加了一个新的必需参数 body
• 操作 WorkspaceCollectionsOperations.migrate 添加了一个新的必需参数 kwargs
• 操作 WorkspaceCollectionsOperations.migrate 已不再有参数 resources
• 操作 WorkspaceCollectionsOperations.migrate 已不再有参数 target_resource_group
• 操作 WorkspaceCollectionsOperations.regenerate_key 添加了一个新的必需参数 body
• 操作 WorkspaceCollectionsOperations.regenerate_key 添加了一个新的必需参数 kwargs
• 操作 WorkspaceCollectionsOperations.regenerate_key 已不再有参数 key_name
• 操作 WorkspaceCollectionsOperations.update 添加了一个新的必需参数 body
• 操作 WorkspaceCollectionsOperations.update 添加了一个新的必需参数 kwargs
• 操作 WorkspaceCollectionsOperations.update 已不再有参数 tags
• 操作 WorkspacesOperations.list 添加了一个新的必需参数 kwargs
• 将操作 WorkspaceCollectionsOperations.delete 重命名为 WorkspaceCollectionsOperations.begin_delete

2.0.0 (2018-05-25)

特性

• 客户端类可以用作上下文管理器以保持底层 HTTP 会话开启以提高性能

一般破坏性更改

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

• 模型签名现在只使用关键字参数语法。所有位置参数必须重写为关键字参数。为了在大多数情况下保持自动完成，现在为 Python 2 和 Python 3 生成模型。Python 3 使用 "*" 语法进行关键字仅参数。
• 枚举类型现在使用 "str" 混合（class 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 在轮询完成后调用将不再引发错误，而是立即执行回调。

错误修复

• sdist 与 wheel 0.31.0 的兼容性

1.0.0 (2017-06-23)

• 初始稳定版本

此 wheel 软件包现在使用 azure wheel 扩展构建