DigitalTwinsClient class
Azure IoT DigitalTwins API 用のクライアント。
コンストラクター
| Digital |
AzureDigitalTwinsAPI のインスタンスを作成します。 使用例:
|
メソッド
コンストラクターの詳細
DigitalTwinsClient(string, TokenCredential, DigitalTwinsClientOptions)
AzureDigitalTwinsAPI のインスタンスを作成します。
使用例:
import { DefaultAzureCredential } from "@azure/identity";
import { DigitalTwinsClient } from "@azure/digital-twins-core";
const url = "<URL to Azure Digital Twins instance>";
const credential = new DefaultAzureCredential();
const serviceClient = new DigitalTwinsClient(url, credential);
new DigitalTwinsClient(endpointUrl: string, credential: TokenCredential, options?: DigitalTwinsClientOptions)
パラメーター
- endpointUrl
-
string
サービスのエンドポイント URL。
- credential
- TokenCredential
サービスへの要求を認証するために使用されます。
- options
- DigitalTwinsClientOptions
サービス クライアントの構成に使用されます。
メソッドの詳細
createModels(Record<string, unknown>[], OperationOptions)
1 つまたは複数を作成する
function createModels(dtdlModels: Record<string, unknown>[], options?: OperationOptions): Promise<DigitalTwinModelsAddResponse>
パラメーター
- dtdlModels
-
Record<string, unknown>[]
作成するモデルのセット。 各文字列は、1 つのモデルに正確に対応します。
- options
- OperationOptions
操作オプション
戻り値
Promise<DigitalTwinModelsAddResponse>
作成された application/json モデル。
decomissionModel(string, OperationOptions)
json パッチを使用してモデルの使用を停止します。 モデルが使用停止になると、新しいデジタル ツインはこのモデルで定義できなくなります。 ただし、既存のデジタル ツインでは、このモデルを引き続き使用できます。 一度使用を停止したモデルは、再使用を停止することはできません。
function decomissionModel(modelId: string, options?: OperationOptions): Promise<void>
パラメーター
- modelId
-
string
使用停止するモデルの ID。 プロパティを置き換えることができます。
- options
- OperationOptions
操作オプション
戻り値
Promise<void>
deleteDigitalTwin(string, DigitalTwinsDeleteOptionalParams)
デジタル ツインを削除する
function deleteDigitalTwin(digitalTwinId: string, options?: DigitalTwinsDeleteOptionalParams): Promise<void>
パラメーター
- digitalTwinId
-
string
削除するデジタル ツインの ID。
- options
- DigitalTwinsDeleteOptionalParams
ifMatch を含む拡張操作オプション: エンティティの etag が指定された etag のいずれかに一致する場合、または * が指定されている場合にのみ操作を実行します。
戻り値
Promise<void>
deleteEventRoute(string, OperationOptions)
イベント ルートを削除します。
function deleteEventRoute(eventRouteId: string, options?: OperationOptions): Promise<void>
パラメーター
- eventRouteId
-
string
削除する eventRoute の ID。
- options
- OperationOptions
操作オプション
戻り値
Promise<void>
deleteModel(string, OperationOptions)
モデルを削除します。
function deleteModel(modelId: string, options?: OperationOptions): Promise<void>
パラメーター
- modelId
-
string
削除するモデルの ID。
- options
- OperationOptions
操作オプション
戻り値
Promise<void>
deleteRelationship(string, string, DigitalTwinsDeleteRelationshipOptionalParams)
デジタル ツインのリレーションシップを削除します。
function deleteRelationship(digitalTwinId: string, relationshipId: string, options?: DigitalTwinsDeleteRelationshipOptionalParams): Promise<void>
パラメーター
- digitalTwinId
-
string
ソース デジタル ツインの ID。
- relationshipId
-
string
削除するリレーションシップの ID。
操作オプション ifMatch: エンティティの etag が指定された etag のいずれかに一致する場合にのみ、操作を実行します。または*が
戻り値
Promise<void>
getComponent(string, string, OperationOptions)
デジタル ツインのコンポーネントを取得します。
function getComponent(digitalTwinId: string, componentName: string, options?: OperationOptions): Promise<DigitalTwinsGetComponentResponse>
パラメーター
- digitalTwinId
-
string
デジタル ツインの ID。
- componentName
-
string
取得するコンポーネント。
- options
- OperationOptions
操作オプション
戻り値
Promise<DigitalTwinsGetComponentResponse>
指定された componentName に対応するコンポーネントの JSON 文字列表現。
getDigitalTwin(string, OperationOptions)
デジタル ツインを取得する
function getDigitalTwin(digitalTwinId: string, options?: OperationOptions): Promise<DigitalTwinsGetByIdResponse>
パラメーター
- digitalTwinId
-
string
デジタル ツインの ID。
- options
- OperationOptions
操作オプション
戻り値
Promise<DigitalTwinsGetByIdResponse>
application/json デジタル ツイン。
getEventRoute(string, OperationOptions)
イベント ルートを取得します。
function getEventRoute(eventRouteId: string, options?: OperationOptions): Promise<EventRoute>
パラメーター
- eventRouteId
-
string
- options
- OperationOptions
操作オプション
戻り値
Promise<EventRoute>
application/json イベントルート。
getModel(string, DigitalTwinModelsGetByIdOptionalParams)
モデル メタデータとモデル定義を含むモデルを取得します。
function getModel(modelId: string, options?: DigitalTwinModelsGetByIdOptionalParams): Promise<DigitalTwinsModelData>
パラメーター
- modelId
-
string
モデルの ID。
- options
- GetModelOptions
この操作のオプション
戻り値
Promise<DigitalTwinsModelData>
application/json モデル。
getRelationship(string, string, OperationOptions)
デジタル ツインのリレーションシップを取得します。
function getRelationship(digitalTwinId: string, relationshipId: string, options?: OperationOptions): Promise<DigitalTwinsGetRelationshipByIdResponse>
パラメーター
- digitalTwinId
-
string
ソース デジタル ツインの ID。
- relationshipId
-
string
取得するリレーションシップの ID。
- options
- OperationOptions
操作オプション
戻り値
指定したデジタル ツインに属する application/json リレーションシップのページング可能なリスト。
listEventRoutes(EventRoutesListOptionalParams)
デジタル ツイン インスタンス内のイベント ルートを一覧表示します。
function listEventRoutes(options?: EventRoutesListOptionalParams): PagedAsyncIterableIterator<EventRoute, EventRoute[], PageSettings>
パラメーター
- options
- ListEventRoutesOptions
listEventRoutes のオプション。
戻り値
application/json イベントルート。
listIncomingRelationships(string, DigitalTwinsListIncomingRelationshipsOptionalParams)
デジタル ツインのすべての受信リレーションシップを取得します。
function listIncomingRelationships(digitalTwinId: string, options?: DigitalTwinsListIncomingRelationshipsOptionalParams): PagedAsyncIterableIterator<IncomingRelationship, IncomingRelationship[], PageSettings>
パラメーター
- digitalTwinId
-
string
デジタル ツインの ID。
- options
- ListIncomingRelationshipsOptions
戻り値
listModels(DigitalTwinModelsListOptionalParams)
モデルの一覧を取得する
function listModels(options?: DigitalTwinModelsListOptionalParams): PagedAsyncIterableIterator<DigitalTwinsModelData, DigitalTwinsModelData[], PageSettings>
パラメーター
- options
- ListModelsOptions
モデルを一覧表示するためのオプション。
戻り値
ページング可能な application/json モデルのセット。
listRelationships(string, DigitalTwinsListRelationshipsOptionalParams)
デジタル ツインのリレーションシップを取得します。
function listRelationships(digitalTwinId: string, options?: DigitalTwinsListRelationshipsOptionalParams): PagedAsyncIterableIterator<Record<string, unknown>, Record<string, unknown>[], PageSettings>
パラメーター
- digitalTwinId
-
string
デジタル ツインの ID。
- options
- ListRelationshipsOptions
戻り値
PagedAsyncIterableIterator<Record<string, unknown>, Record<string, unknown>[], PageSettings>
publishComponentTelemetry(string, string, Record<string, unknown>, string, OperationOptions)
デジタル ツインのコンポーネントからテレメトリを発行します。これは、次に定義されている 1 つまたは複数の宛先エンドポイント (サブスクライバー) によって使用されます。
function publishComponentTelemetry(digitalTwinId: string, componentName: string, payload: Record<string, unknown>, messageId: string, options?: OperationOptions): Promise<void>
パラメーター
- digitalTwinId
-
string
削除するデジタル ツインの ID。
- componentName
-
string
DTDL コンポーネントの名前。
- payload
-
Record<string, unknown>
送信されるアプリケーション/json テレメトリ ペイロード。
- messageId
-
string
メッセージ ID。
- options
- OperationOptions
操作オプション
戻り値
Promise<void>
publishTelemetry(string, Record<string, unknown>, string, OperationOptions)
デジタル ツインからテレメトリを発行します。このテレメトリは、定義された 1 つまたは複数の宛先エンドポイント (サブスクライバー) によって使用されます。
function publishTelemetry(digitalTwinId: string, payload: Record<string, unknown>, messageId: string, options?: OperationOptions): Promise<void>
パラメーター
- digitalTwinId
-
string
削除するデジタル ツインの ID。
- payload
-
Record<string, unknown>
送信されるアプリケーション/json テレメトリ ペイロード。
- messageId
-
string
メッセージ ID。
- options
- OperationOptions
操作オプション
戻り値
Promise<void>
queryTwins(string, QueryQueryTwinsOptionalParams)
デジタル ツインのクエリ。
function queryTwins(query: string, options?: QueryQueryTwinsOptionalParams): PagedAsyncIterableIterator<Record<string, unknown>, QueryQueryTwinsResponse, PageSettings>
パラメーター
- query
-
string
SQL に似た構文のクエリ文字列。
- options
- QueryTwinsOptions
クエリ操作のオプション。
戻り値
PagedAsyncIterableIterator<Record<string, unknown>, QueryQueryTwinsResponse, PageSettings>
クエリ結果のページング可能な一覧。
updateComponent(string, string, Record<string, unknown>[], DigitalTwinsUpdateComponentOptionalParams)
JSON パッチを使用して、デジタル ツイン上のコンポーネントのプロパティを更新します。
function updateComponent(digitalTwinId: string, componentName: string, jsonPatch: Record<string, unknown>[], options?: DigitalTwinsUpdateComponentOptionalParams): Promise<DigitalTwinsUpdateComponentHeaders>
パラメーター
- digitalTwinId
-
string
デジタル ツインの ID。
- componentName
-
string
更新されるコンポーネント。
- jsonPatch
-
Record<string, unknown>[]
指定したデジタル ツインのコンポーネントで実行される application/json-patch+json 操作。
ifMatch を含む拡張操作オプション: エンティティの etag が指定された etag のいずれかに一致する場合、または * が指定されている場合にのみ操作を実行します。
戻り値
Promise<DigitalTwinsUpdateComponentHeaders>
updateDigitalTwin(string, Record<string, unknown>[], DigitalTwinsUpdateOptionalParams)
json パッチを使用してデジタル ツインを更新します。
function updateDigitalTwin(digitalTwinId: string, jsonPatch: Record<string, unknown>[], options?: DigitalTwinsUpdateOptionalParams): Promise<DigitalTwinsUpdateHeaders>
パラメーター
- digitalTwinId
-
string
デジタル ツインの ID。
- jsonPatch
-
Record<string, unknown>[]
JSON Patch で説明されている更新プログラムの仕様。 プロパティ値と$model要素の更新は、同じ要求で行われる可能性があります。 操作は、追加、置換、および削除に限定されます。
- options
- DigitalTwinsUpdateOptionalParams
ifMatch を含む拡張操作オプション: エンティティの etag が指定された etag のいずれかに一致する場合、または * が指定されている場合にのみ操作を実行します。
戻り値
Promise<DigitalTwinsUpdateHeaders>
updateRelationship(string, string, Record<string, unknown>[], DigitalTwinsUpdateRelationshipOptionalParams)
JSON パッチを使用して、デジタル ツインのリレーションシップのプロパティを更新します。
function updateRelationship(digitalTwinId: string, relationshipId: string, jsonPatch: Record<string, unknown>[], options?: DigitalTwinsUpdateRelationshipOptionalParams): Promise<DigitalTwinsUpdateRelationshipHeaders>
パラメーター
- digitalTwinId
-
string
削除するデジタル ツインの ID。
- relationshipId
-
string
更新するリレーションシップの ID。
- jsonPatch
-
Record<string, unknown>[]
指定されたデジタル ツインのリレーションシップに対して実行される application/json-patch+json 操作。
拡張操作オプション ifMatch: エンティティの etag が指定された etag のいずれかに一致する場合、または * が指定されている場合にのみ、操作を実行します。
戻り値
upsertDigitalTwin(string, string, DigitalTwinsAddOptionalParams)
デジタル ツインを作成または更新する
function upsertDigitalTwin(digitalTwinId: string, digitalTwinJson: string, options?: DigitalTwinsAddOptionalParams): Promise<DigitalTwinsAddResponse>
パラメーター
- digitalTwinId
-
string
作成または更新するデジタル ツインの ID。
- digitalTwinJson
-
string
作成するアプリケーション/json デジタル ツイン。
- options
- DigitalTwinsAddOptionalParams
ifNoneMatch を含む拡張操作オプション: エンティティがまだ存在しない場合にのみ操作を実行します。
戻り値
Promise<DigitalTwinsAddResponse>
作成された application/json デジタル ツイン。
upsertEventRoute(string, string, string, OperationOptions)
イベント ルートを作成または更新します。
function upsertEventRoute(eventRouteId: string, endpointId: string, filter: string, options?: OperationOptions): Promise<void>
パラメーター
- eventRouteId
-
string
作成または更新するイベント ルートの ID。
- endpointId
-
string
このイベント ルートがバインドされているエンドポイントの ID。
- filter
-
string
エンドポイントにルーティングされるイベントを記述する式。
- options
- OperationOptions
操作オプション
戻り値
Promise<void>
upsertRelationship(string, string, Record<string, unknown>, DigitalTwinsAddRelationshipOptionalParams)
デジタル ツインのリレーションシップを作成または更新します。
function upsertRelationship(digitalTwinId: string, relationshipId: string, relationship: Record<string, unknown>, options?: DigitalTwinsAddRelationshipOptionalParams): Promise<DigitalTwinsAddRelationshipResponse>
パラメーター
- digitalTwinId
-
string
ソース デジタル ツインの ID。
- relationshipId
-
string
作成するリレーションシップの ID。
- relationship
-
Record<string, unknown>
作成するアプリケーション/json リレーションシップ。
ifNoneMatch を含む拡張操作オプション: エンティティがまだ存在しない場合にのみ操作を実行します。
戻り値
Promise<DigitalTwinsAddRelationshipResponse>