Azure Digital Twins (プレビュー)

  • リファレンス

Azure Digital Twins は、実世界のモノ、場所、ビジネス プロセス、人々のデジタル表現を作成できるモノのインターネット (IoT) プラットフォームです。 このコネクタを使用すると、デジタル ツインとモデルに対して操作を実行したり、ADT クエリを実行したりできます。

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure China の地域
     -   米国国防総省 (DoD)
Power Automate Standard 以下を除くすべての Power Automate 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
Power Apps 標準 以下を除くすべての Power Apps 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
連絡先
件名 マイクロソフト
[URL] https://azure.microsoft.com/support/
Connector Metadata
発行者 Microsoft Corporation
Web サイト https://azure.microsoft.com/products/digital-twins/
プライバシー ポリシー https://privacy.microsoft.com
カテゴリー モノのインターネット

Azure Digital Twins は、実世界のモノ、場所、ビジネス プロセス、人々のデジタル表現を作成できるモノのインターネット (IoT) プラットフォームです。 より良い製品を推進し、運用とコストを最適化し、画期的なカスタマー エクスペリエンスを生み出すのに役立つ洞察を得ることができます。 このコネクタを使用すると、デジタル ツイン API と対話できます。 これにより、ツインの作成、管理、およびクエリが可能になります。

前提条件

続行するには、次のものが必要です。

  • カスタム コネクタ機能を備えた Microsoft Power Apps または Power Automate プラン
  • Azure サブスクリプション
  • Power Platform の CLI ツール
  • Azure Digital Twin インスタンス

資格情報の入手方法

Digital twins のエンドポイントにアクセスするための Microsoft Entra ID ユーザー ID とパスワードを使用します。

コネクタの使用を開始する

既知の問題と制限事項

  • ADT は動的なスキーマ応答を処理するためです。 アプリ開発者は、json を使用する前にモデルに解析する必要があります。 例: Set(jsonVal, AzureDigitalTwins.GetTwinById(TextInput1.Text).result); Set(parsedResp, ParseJSON(jsonVal)); Set( DtId, Text(parsedResp.'$dtId'));

一般的なエラーと解決策

  • JSON パーサー エラー:
    • モデルが解析された json と一致しない場合は、json パーサー エラーが発生します。 これを解決するには、応答 xml を確認し、それに応じて値にアクセスしてください。

よくあるご質問

  • コネクタを介して ADT インスタンスを作成できますか?

    • ADT インスタンスを作成および削除するには、Azure に移動する必要があります。

  • ページ付けはできますか?

    • ページ付けは、継続トークンを使用してアプリ開発内で行われます。

  • 1 つのアプリで複数の ADT インスタンスにアクセスできますか?

    • 複数の ADT インスタンスにアクセスするには、新しい接続を確立し、アプリケーション内で適切に使用する必要があります。

接続を作成する

このコネクタは、次の認証タイプをサポートしています:
既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ Description Required
ADT のインスタンス名: string ADT インスタンス URI を入力します True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 300 60 秒

アクション

ID でツインを取得する

デジタル ツインとそのデータを取得します。
ID でモデルを取得する

モデル メタデータと、オプションでモデル定義を取得します。
ID でリレーションシップを取得します

2 つのデジタル ツイン間のリレーションシップを取得します。
クエリ API

リレーションシップ のトラバースとプロパティ値によるフィルタリングを可能にするクエリを実行します。
コンポーネント テレメトリを送信する

デジタル ツイン内のコンポーネントに代わってテレメトリを送信します。
コンポーネントの取得

デジタル ツインからコンポーネントを取得します。
コンポーネントの更新

ツインのコンポーネントの整数プロパティを更新します。
ツインの削除

デジタルツインを削除します。 デジタル ツインを参照するすべての リレーションシップ は、既に削除されている必要があります。
ツインの更新

ツインのプロパティを更新します。
ツインの追加

デジタル ツインを追加または置換します。
テレメトリの送信

デジタル ツインに代わってテレメトリを送信します。
モデルのプロパティを更新

モデルのメタデータを更新します。
モデルの削除

モデルを削除します。 モデルは、他のモデルが参照していない場合にのみ削除できます。
モデルの追加

1 つ以上のモデルをアップロードします。 エラーが発生した場合、モデルはアップロードされません。
モデルをリストする

モデル メタデータと、オプションでモデル定義を取得します。
リレーションシップの更新

2 つのデジタル ツイン間の関係の整数プロパティを更新します。
リレーションシップを追加

2 つのデジタル ツイン間の関係を追加します。
リレーションシップ一覧を表示

デジタル ツインからの発信リレーションシップ をすべて取得します。
受信リレーションシップをリストする

デジタル ツインの受信 リレーションシップ をすべて取得します。
関連付けの削除

2 つのデジタル ツイン間のリレーションシップを削除します。

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
 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 でリレーションシップを取得します

操作 ID:
GetRelationshipById

2 つのデジタル ツイン間のリレーションシップを取得します。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
リレーションシップ ID
 relationshipId True string

リレーションシップの ID。 ID はデータツイン内で一意であり、大文字と小文字が区別されます。

戻り値

Body
TwinRelationship

クエリ API

操作 ID:
QueryTwins

リレーションシップ のトラバースとプロパティ値によるフィルタリングを可能にするクエリを実行します。

パラメーター

名前 キー 必須 型 説明
query
 query string

ツインをクエリします。
continuationToken
 continuationToken string

結果の次のページを取得するためのリンク。

戻り値

Body
QueryResult

コンポーネント テレメトリを送信する

操作 ID:
SendComponentTelemetry

デジタル ツイン内のコンポーネントに代わってテレメトリを送信します。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
DTDL コンポーネント
 componentPath True string

DTDL コンポーネントの名前。
メッセージ ID
 Message-Id True string

メッセージの重複除去に一般的に使用される一意のメッセージ識別子 (デジタル ツイン ID の範囲内)。
Timestamp
 Telemetry-Source-Time string

テレメトリが測定された時間を識別する RFC 3339 タイムスタンプ。
コンポーネント テレメトリ要求
 value string

コンポーネント テレメトリ入力を送信します。

コンポーネントの取得

操作 ID:
GetComponent

デジタル ツインからコンポーネントを取得します。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
DTDL コンポーネント
 componentPath True string

DTDL コンポーネントの名前。

戻り値

Body
GetComponentResult

コンポーネントの更新

操作 ID:
UpdateComponent

ツインのコンポーネントの整数プロパティを更新します。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
DTDL コンポーネント
 componentPath True string

DTDL コンポーネントの名前。
Request
 value string

API のリクエスト。

ツインの削除

操作 ID:
DeleteTwin

デジタルツインを削除します。 デジタル ツインを参照するすべての リレーションシップ は、既に削除されている必要があります。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。

ツインの更新

操作 ID:
UpdateTwin

ツインのプロパティを更新します。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
Request
 value string

API のリクエスト。

ツインの追加

操作 ID:
AddTwin

デジタル ツインを追加または置換します。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
Request
 value string

API のリクエスト。

戻り値

Body
TwinResult

テレメトリの送信

操作 ID:
SendTelemetry

デジタル ツインに代わってテレメトリを送信します。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
メッセージ ID
 Message-Id True string

メッセージの重複除去に一般的に使用される一意のメッセージ識別子 (デジタル ツイン ID の範囲内)。
Timestamp
 Telemetry-Source-Time string

テレメトリが測定された時間を識別する RFC 3339 タイムスタンプ。
テレメトリ要求
 value string

テレメトリ入力を送信します。

モデルのプロパティを更新

操作 ID:
UpdateModel

モデルのメタデータを更新します。

パラメーター

名前 キー 必須 型 説明
モデル ID
 modelid True string

モデルの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
Request
 value string

API のリクエスト。

モデルの削除

操作 ID:
DeleteModel

モデルを削除します。 モデルは、他のモデルが参照していない場合にのみ削除できます。

パラメーター

名前 キー 必須 型 説明
モデル ID
 modelid True string

モデルの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。

モデルの追加

操作 ID:
AddModels

1 つ以上のモデルをアップロードします。 エラーが発生した場合、モデルはアップロードされません。

パラメーター

名前 キー 必須 型 説明
@id
 @id string

モデル定義で指定したモデルの ID。
@type
 @type string

インターフェイスの種類。
displayName
 displayName string

モデル定義で指定されたローカライズされた表示名を含む言語マップ。
@type
 @type string

プロパティの種類。
名称
 name string

プロパティの名前。
displayName
 displayName string

プロパティ名。
スキーマ
 schema string

プロパティのスキーマ。
@context
 @context string

メタデータのコンテキスト。

戻り値

名前 パス 型 説明
array of object
id
 id string

モデル定義で指定したモデルの ID。
additionalProperties
 displayName.additionalProperties string

プロパティ値。
uploadTime
 uploadTime string

モデルがサービスにアップロードされた時間。
decommissioned
 decommissioned boolean

モデルが廃止されたかどうかを示します。 廃止されたモデルは、新しく作成されたデジタル ツインから参照できません。

モデルをリストする

操作 ID:
ListModels

モデル メタデータと、オプションでモデル定義を取得します。

パラメーター

名前 キー 必須 型 説明
モデルの依存関係
 dependenciesFor string

依存関係を取得するモデルのセット。 省略した場合、すべてのモデルが取得されます。
モデル定義を含める
 includeModelDefinition string

true の場合、モデル定義が結果の一部として返されます。
継続トークン
 continuationToken string

前のクエリから次の結果セットを取得するために使用されるトークン。

戻り値

名前 パス 型 説明
価値
 value array of object

配列値。
id
 value.id string

モデル定義で指定したモデルの ID。
uploadTime
 value.uploadTime string

モデルがサービスにアップロードされた時間。
decommissioned
 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

モデル displayName。
additionalProperties
 value.displayName.additionalProperties string

プロパティ値。
continuationToken
 continuationToken string

ツインリレーションシップの次のページへの継続トークン。
nextLink
 nextLink string

モデルの次のページを取得する URL。

リレーションシップの更新

操作 ID:
UpdateRelationship

2 つのデジタル ツイン間の関係の整数プロパティを更新します。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
リレーションシップ ID
 relationshipId True string

リレーションシップの ID。 ID はデータツイン内で一意であり、大文字と小文字が区別されます。
Request
 value string

API のリクエスト。

リレーションシップを追加

操作 ID:
AddRelationship

2 つのデジタル ツイン間の関係を追加します。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
リレーションシップ ID
 relationshipId True string

リレーションシップの ID。 ID はデータツイン内で一意であり、大文字と小文字が区別されます。
Request
 value string

API のリクエスト。

戻り値

Body
TwinRelationship

リレーションシップ一覧を表示

操作 ID:
ListRelationships

デジタル ツインからの発信リレーションシップ をすべて取得します。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
継続トークン
 continuationToken string

前のクエリから次の結果セットを取得するために使用されるトークン。

戻り値

名前 パス 型 説明
価値
 value array of TwinRelationship

ツイン リレーションシップのコレクション。
continuationToken
 continuationToken string

ツインリレーションシップの次のページへの継続トークン。
nextLink
 nextLink string

ツイン リレーションシップの次のページを取得する URL。

受信リレーションシップをリストする

操作 ID:
ListIncomingRelationships

デジタル ツインの受信 リレーションシップ をすべて取得します。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
継続トークン
 continuationToken string

前のクエリから次の結果セットを取得するために使用されるトークン。

戻り値

名前 パス 型 説明
価値
 value array of IncomingRelationship

着信リレーションシップのコレクション。
continuationToken
 continuationToken string

ツインリレーションシップの次のページへの継続トークン。
nextLink
 nextLink string

受信リレーションシップの次のページを取得する URL。

関連付けの削除

操作 ID:
DeleteRelationship

2 つのデジタル ツイン間のリレーションシップを削除します。

パラメーター

名前 キー 必須 型 説明
デジタル ツイン ID
 twinid True string

デジタルツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。
リレーションシップ ID
 relationshipId True string

リレーションシップの ID。 ID はデータツイン内で一意であり、大文字と小文字が区別されます。

定義

IncomingRelationship

名前 パス 型 説明
$sourceId
 $sourceId string

Source ID。
$relationshipId
 $relationshipId string

リレーションシップ ID。
$relationshipName
 $relationshipName string

リレーションシップ名。
$relationshipLink
 $relationshipLink string

リレーションシップ リンク。

TwinRelationship

名前 パス 型 説明
$sourceId
 $sourceId string

Source ID。
$relationshipId
 $relationshipId string

リレーションシップ ID。
$targetId
 $targetId string

ターゲット ID
$relationshipName
 $relationshipName string

リレーションシップ名。
$etag
 $etag string

E タグ リンク。
additionalProperties
 additionalProperties string

プロパティ値。

TwinResult

名前 パス 型 説明
Result
 result string

ツインからの結果。

GetComponentResult

名前 パス 型 説明
Result
 result string

ツインからの結果。

QueryResult

名前 パス 型 説明
価値
 value string

ツインからの結果。
継続トークン
 continuationToken string

結果の次のページを取得するためのリンク。