Microsoft Azure SDK for Python

这是Microsoft Azure Digital Twins Management客户端库。此包已在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-digitaltwins
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.digitaltwins import AzureDigitalTwinsManagementClient
import os

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

示例

本包的代码示例可以在 docs.microsoft.com 上的 数字孪生管理 和 示例仓库 中找到。

故障排除

下一步操作

提供反馈

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

发行历史

6.4.0 (2023-03-20)

新增功能

• 模型 AzureDataExplorerConnectionProperties 新增参数 adx_relationship_lifecycle_events_table_name
• 模型 AzureDataExplorerConnectionProperties 新增参数 adx_twin_lifecycle_events_table_name
• 模型 AzureDataExplorerConnectionProperties 新增参数 record_property_and_item_removals
• 操作 TimeSeriesDatabaseConnectionsOperations.begin_delete 新增可选参数 cleanup_connection_artifacts

6.4.0b1 (2023-02-16)

其他更改

• 在 GitHub 仓库中添加了生成的示例
• 不再支持 python<3.7.0

6.3.0 (2022-12-15)

新增功能

• 模型 AzureDataExplorerConnectionProperties 新增参数 identity
• 模型 DigitalTwinsEndpointResourceProperties 新增参数 identity
• 模型 DigitalTwinsIdentity 新增参数 user_assigned_identities
• 模型 EventGrid 新增参数 identity
• 模型 EventHub 新增参数 identity
• 模型 ServiceBus 新增参数 identity
• 模型 TimeSeriesDatabaseConnectionProperties 新增参数 identity

6.2.0 (2022-06-28)

功能

• 模型 DigitalTwinsEndpointResourceProperties.provisioning_state 新增状态 Updating

6.1.0 (2022-03-21)

功能

• 添加了 TimeSeriesDatabaseConnectionsOperations 操作组
• 模型 DigitalTwinsDescription 新增参数 system_data
• 模型 DigitalTwinsEndpointResource 新增参数 system_data
• 模型 DigitalTwinsResource 新增参数 system_data
• 模型 ExternalResource 新增参数 system_data
• 模型 Operation 新增参数 properties
• 模型 PrivateEndpointConnection 新增参数 system_data

6.0.0 (2021-05-18)

• GA 版本

6.0.0b2 (2021-02-26)

• 修复版本问题。

6.0.0b1 (2021-01-07)

这是 beta 预览版本。有关详细变更日志，请参阅等效的稳定版本 1.0.0 (https://pypi.ac.cn/project/azure-mgmt-digitaltwins/1.0.0/)

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

一般破坏性更改

• 凭证系统已完全重写

  • 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 初始化文档中的参数接受

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

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

• 异常树已被简化，大多数异常现在都是 azure.core.exceptions.HttpResponseError（已删除 CloudError）。

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

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

一般新功能

• 类型注解支持使用 typing。SDK 已准备好使用 mypy。
• 该客户端现在提供稳定且官方的异步支持。检查您包中的 aio 命名空间以找到异步客户端。
• 该客户端现在原生支持 OpenCensus 或 OpenTelemetry 等跟踪库。查看此 跟踪快速入门 以获取概述。

1.0.0 (2020-09-24)

• 作为多 API 包发布。

0.1.0 (2020-05-31)

• 初始发布