通过

Azure 数字孪生（预览版）

Azure 数字孪生是物联网（IoT）平台，可用于创建真实事物、地点、业务流程和人员的数字表示形式。 通过此连接器，你可以对数字孪生和模型执行作，以及运行 ADT 查询。

此连接器在以下产品和区域中可用：

服务 Class 区域
Copilot Studio 标准 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 标准 除以下各项外的所有 Power Apps 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 标准 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人​​
Name Microsoft
URL https://azure.microsoft.com/support/
连接器元数据
发布者 Microsoft Corporation
网站 https://azure.microsoft.com/products/digital-twins/
隐私策略 https://privacy.microsoft.com
类别 物联网

Azure 数字孪生是物联网（IoT）平台，可用于创建真实事物、地点、业务流程和人员的数字表示形式。 获取见解，帮助你推动更好的产品、优化运营和成本，并创造突破性的客户体验。 此连接器允许与数字孪生 API 进行交互。 它允许你创建、管理和查询孪生体。

先决条件

需要满足以下条件才能继续作：

  • 具有自定义连接器功能的Microsoft Power Apps 或 Power Automate 计划
  • Azure 订阅服务
  • Power Platform CLI 工具
  • Azure 数字孪生体实例

如何获取凭据

使用授予访问数字孪生终结点的权限的 Microsoft Entra ID 用户 ID 和密码。

连接器入门

已知问题和限制

  • 由于 ADT 处理动态架构响应。 应用开发人员在使用它之前应将其分析为其模型。例如：Set（jsonVal， AzureDigitalTwins.GetTwinById（TextInput1.Text）。result;Set（parsedResp，ParseJSON（jsonVal））：Set（DtId，Text（parsedResp.'$dtId'）;

常见错误和补救措施

  • Json 分析器错误：
    • 如果模型与分析的 json 不匹配，则会收到 json 分析器错误。 若要解决此问题，请检查响应 xml 并相应地访问值。

FAQ

  • 能否通过连接器创建 ADT 实例？

    • 应转到 Azure 以创建和删除 ADT 实例。

  • 分页是否可用？

    • Pagenation 通过使用延续令牌在应用开发中完成。

  • 是否可以在一个应用中访问多个 ADT 实例？

    • 若要访问多个 ADT 实例，必须在应用程序中建立并适当地使用新连接。

创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
ADT 实例名称： 字符串 输入 ADT 实例 URI True

限制

名称 调用 续订期
每个连接的 API 调用数 300 60 秒

操作

列出传入关系

检索数字孪生体的所有传入关系。
列出模型

检索模型元数据，以及（可选）模型定义。
列表关系

从数字孪生体检索所有传出关系。
删除关系

删除两个数字孪生体之间的关系。
删除孪生体

删除数字孪生体。 必须删除引用数字孪生体的所有关系。
删除模型

删除模型。 仅当没有其他模型引用模型时，才能删除该模型。
发送组件遥测

代表数字孪生中的组件发送遥测数据。
发送遥测

代表数字孪生发送遥测数据。
按 ID 获取关系

检索两个数字孪生体之间的关系。
按 ID 获取孪生

检索数字孪生体及其数据。
按 ID 获取模型

检索模型元数据，还可以选择模型定义。
更新关系

更新两个数字孪生之间的关系上的整数属性。
更新孪生

更新孪生体的属性。
更新模型的属性

更新模型的元数据。
更新组件

更新孪生组件的整数属性。
查询 API

执行允许遍历关系和按属性值进行筛选的查询。
添加关系

添加两个数字孪生体之间的关系。
添加孪生体

添加或替换数字孪生体。
添加模型

上传一个或多个模型。 发生任何错误时，不会上传任何模型。
获取组件

从数字孪生体检索组件。

列出传入关系

操作 ID:
ListIncomingRelationships

检索数字孪生体的所有传入关系。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。
继续标记
 continuationToken string

用于检索上一个查询的下一组结果的令牌。

返回

名称 路径 类型 说明
value
 value array of IncomingRelationship

传入关系的集合。
continuationToken
 continuationToken string

继续标记孪生关系的下一页。
nextLink
 nextLink string

用于获取传入关系的下一页的 URL。

列出模型

操作 ID:
ListModels

检索模型元数据，以及（可选）模型定义。

参数

名称 密钥 必需 类型 说明
模型依赖项
 dependenciesFor string

将检索其依赖项的模型集。 如果省略，将检索所有模型。
包括模型定义
 includeModelDefinition string

如果为 true，模型定义将作为结果的一部分返回。
继续标记
 continuationToken string

用于检索上一个查询的下一组结果的令牌。

返回

名称 路径 类型 说明
value
 value array of object

数组值。
id
 value.id string

模型定义的 ID。
uploadTime
 value.uploadTime string

模型上传到服务的时间。
退役
 value.decommissioned boolean

指示模型是否已解除授权。 新创建的数字孪生无法引用已解除授权的模型。
@id
 value.model.@id string

模型定义的 ID。
@type
 value.model.@type string

接口类型。
内容
 value.model.contents array of object

响应内容。
@type
 value.model.contents.@type string

属性类型。
姓名
 value.model.contents.name string

属性名称。
displayName
 value.model.contents.displayName string

属性 displayName。
架构
 value.model.contents.schema string

属性的架构。
@context
 value.model.@context string

元数据上下文。
displayName
 value.model.displayName string

Model displayName。
additionalProperties
 value.displayName.additionalProperties string

属性值。
continuationToken
 continuationToken string

继续标记孪生关系的下一页。
nextLink
 nextLink string

用于获取模型的下一页的 URL。

列表关系

操作 ID:
ListRelationships

从数字孪生体检索所有传出关系。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。
继续标记
 continuationToken string

用于检索上一个查询的下一组结果的令牌。

返回

名称 路径 类型 说明
value
 value array of TwinRelationship

孪生关系的集合。
continuationToken
 continuationToken string

继续标记孪生关系的下一页。
nextLink
 nextLink string

用于获取孪生关系的下一页的 URL。

删除关系

操作 ID:
DeleteRelationship

删除两个数字孪生体之间的关系。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。
关系 ID
 relationshipId True string

关系的 ID。 ID 在数字孪生体中是唯一的，区分大小写。

删除孪生体

操作 ID:
DeleteTwin

删除数字孪生体。 必须删除引用数字孪生体的所有关系。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。

删除模型

操作 ID:
DeleteModel

删除模型。 仅当没有其他模型引用模型时，才能删除该模型。

参数

名称 密钥 必需 类型 说明
模型 ID
 modelid True string

模型的 ID。 ID 在服务中是唯一的，区分大小写。

发送组件遥测

操作 ID:
SendComponentTelemetry

代表数字孪生中的组件发送遥测数据。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。
DTDL 组件
 componentPath True string

DTDL 组件的名称。
消息 ID
 Message-Id True string

用于取消复制消息的唯一消息标识符（在数字孪生 ID 的范围内）。
时间戳
 Telemetry-Source-Time string

一个 RFC 3339 时间戳，用于标识遥测测量的时间。
组件遥测请求
 value string

发送组件遥测输入。

发送遥测

操作 ID:
SendTelemetry

代表数字孪生发送遥测数据。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。
消息 ID
 Message-Id True string

用于取消复制消息的唯一消息标识符（在数字孪生 ID 的范围内）。
时间戳
 Telemetry-Source-Time string

一个 RFC 3339 时间戳，用于标识遥测测量的时间。
遥测请求
 value string

发送遥测输入。

按 ID 获取关系

操作 ID:
GetRelationshipById

检索两个数字孪生体之间的关系。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。
关系 ID
 relationshipId True string

关系的 ID。 ID 在数字孪生体中是唯一的，区分大小写。

返回

Body
TwinRelationship

按 ID 获取孪生

操作 ID:
GetTwinById

检索数字孪生体及其数据。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。

返回

Body
TwinResult

按 ID 获取模型

操作 ID:
GetModelById

检索模型元数据，还可以选择模型定义。

参数

名称 密钥 必需 类型 说明
模型 ID
 modelid True string

模型的 ID。 ID 在服务中是唯一的，区分大小写。
包括模型定义
 includeModelDefinition string

如果为 true，模型定义将作为结果的一部分返回。

返回

名称 路径 类型 说明
id
 id string

模型定义的 ID。
uploadTime
 uploadTime string

模型上传到服务的时间。
退役
 decommissioned boolean

指示模型是否已解除授权。 新创建的数字孪生无法引用已解除授权的模型。
@id
 model.@id string

模型定义的 ID。
@type
 model.@type string

接口类型。
内容
 model.contents array of object

响应内容。
@type
 model.contents.@type string

属性类型。
姓名
 model.contents.name string

属性名称。
displayName
 model.contents.displayName string

属性 displayName。
架构
 model.contents.schema string

属性的架构。
@context
 model.@context string

元数据上下文。

更新关系

操作 ID:
UpdateRelationship

更新两个数字孪生之间的关系上的整数属性。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。
关系 ID
 relationshipId True string

关系的 ID。 ID 在数字孪生体中是唯一的，区分大小写。
请求
 value string

请求 API。

更新孪生

操作 ID:
UpdateTwin

更新孪生体的属性。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。
请求
 value string

请求 API。

更新模型的属性

操作 ID:
UpdateModel

更新模型的元数据。

参数

名称 密钥 必需 类型 说明
模型 ID
 modelid True string

模型的 ID。 ID 在服务中是唯一的，区分大小写。
请求
 value string

请求 API。

更新组件

操作 ID:
UpdateComponent

更新孪生组件的整数属性。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。
DTDL 组件
 componentPath True string

DTDL 组件的名称。
请求
 value string

请求 API。

查询 API

操作 ID:
QueryTwins

执行允许遍历关系和按属性值进行筛选的查询。

参数

名称 密钥 必需 类型 说明
查询
 query string

查询孪生体。
continuationToken
 continuationToken string

用于获取下一组项的链接。

返回

Body
QueryResult

添加关系

操作 ID:
AddRelationship

添加两个数字孪生体之间的关系。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。
关系 ID
 relationshipId True string

关系的 ID。 ID 在数字孪生体中是唯一的，区分大小写。
请求
 value string

请求 API。

返回

Body
TwinRelationship

添加孪生体

操作 ID:
AddTwin

添加或替换数字孪生体。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。
请求
 value string

请求 API。

返回

Body
TwinResult

添加模型

操作 ID:
AddModels

上传一个或多个模型。 发生任何错误时，不会上传任何模型。

参数

名称 密钥 必需 类型 说明
@id
 @id string

模型定义的 ID。
@type
 @type string

接口类型。
displayName
 displayName string

包含模型定义中指定的本地化显示名称的语言映射。
@type
 @type string

属性类型。
姓名
 name string

属性的名称。
displayName
 displayName string

属性名称。
架构
 schema string

proerty 的架构。
@context
 @context string

元数据上下文。

返回

名称 路径 类型 说明
array of object
id
 id string

模型定义的 ID。
additionalProperties
 displayName.additionalProperties string

属性值。
uploadTime
 uploadTime string

模型上传到服务的时间。
退役
 decommissioned boolean

指示模型是否已解除授权。 新创建的数字孪生无法引用已解除授权的模型。

获取组件

操作 ID:
GetComponent

从数字孪生体检索组件。

参数

名称 密钥 必需 类型 说明
数字孪生 ID
 twinid True string

数字孪生体的 ID。 ID 在服务中是唯一的，区分大小写。
DTDL 组件
 componentPath True string

DTDL 组件的名称。

返回

Body
GetComponentResult

定义

IncomingRelationship

名称 路径 类型 说明
$sourceId
 $sourceId string

源 ID。
$relationshipId
 $relationshipId string

关系 ID。
$relationshipName
 $relationshipName string

关系名称。
$relationshipLink
 $relationshipLink string

关系链接。

TwinRelationship

名称 路径 类型 说明
$sourceId
 $sourceId string

源 ID。
$relationshipId
 $relationshipId string

关系 ID。
$targetId
 $targetId string

目标 ID。
$relationshipName
 $relationshipName string

关系名称。
$etag
 $etag string

E 标记链接。
additionalProperties
 additionalProperties string

属性值。

TwinResult

名称 路径 类型 说明
结果
 result string

孪生体的结果。

GetComponentResult

名称 路径 类型 说明
结果
 result string

孪生体的结果。

QueryResult

名称 路径 类型 说明
价值
 value string

孪生体的结果。
继续标记
 continuationToken string

用于获取下一组项的链接。