次の方法で共有


DigitalTwinsClient class

Azure IoT DigitalTwins API 用のクライアント。

コンストラクター

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);

メソッド

createModels(Record<string, unknown>[], OperationOptions)

1 つまたは複数を作成する

decomissionModel(string, OperationOptions)

json パッチを使用してモデルの使用を停止します。 モデルが使用停止になると、新しいデジタル ツインはこのモデルで定義できなくなります。 ただし、既存のデジタル ツインでは、このモデルを引き続き使用できます。 一度使用を停止したモデルは、再使用を停止することはできません。

deleteDigitalTwin(string, DigitalTwinsDeleteOptionalParams)

デジタル ツインを削除する

deleteEventRoute(string, OperationOptions)

イベント ルートを削除します。

deleteModel(string, OperationOptions)

モデルを削除します。

deleteRelationship(string, string, DigitalTwinsDeleteRelationshipOptionalParams)

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

getComponent(string, string, OperationOptions)

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

getDigitalTwin(string, OperationOptions)

デジタル ツインを取得する

getEventRoute(string, OperationOptions)

イベント ルートを取得します。

getModel(string, DigitalTwinModelsGetByIdOptionalParams)

モデル メタデータとモデル定義を含むモデルを取得します。

getRelationship(string, string, OperationOptions)

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

listEventRoutes(EventRoutesListOptionalParams)

デジタル ツイン インスタンス内のイベント ルートを一覧表示します。

listIncomingRelationships(string, DigitalTwinsListIncomingRelationshipsOptionalParams)

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

listModels(DigitalTwinModelsListOptionalParams)

モデルの一覧を取得する

listRelationships(string, DigitalTwinsListRelationshipsOptionalParams)

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

publishComponentTelemetry(string, string, Record<string, unknown>, string, OperationOptions)

デジタル ツインのコンポーネントからテレメトリを発行します。これは、次に定義されている 1 つまたは複数の宛先エンドポイント (サブスクライバー) によって使用されます。

publishTelemetry(string, Record<string, unknown>, string, OperationOptions)

デジタル ツインからテレメトリを発行します。このテレメトリは、定義された 1 つまたは複数の宛先エンドポイント (サブスクライバー) によって使用されます。

queryTwins(string, QueryQueryTwinsOptionalParams)

デジタル ツインのクエリ。

updateComponent(string, string, Record<string, unknown>[], DigitalTwinsUpdateComponentOptionalParams)

JSON パッチを使用して、デジタル ツイン上のコンポーネントのプロパティを更新します。

updateDigitalTwin(string, Record<string, unknown>[], DigitalTwinsUpdateOptionalParams)

json パッチを使用してデジタル ツインを更新します。

updateRelationship(string, string, Record<string, unknown>[], DigitalTwinsUpdateRelationshipOptionalParams)

JSON パッチを使用して、デジタル ツインのリレーションシップのプロパティを更新します。

upsertDigitalTwin(string, string, DigitalTwinsAddOptionalParams)

デジタル ツインを作成または更新する

upsertEventRoute(string, string, string, OperationOptions)

イベント ルートを作成または更新します。

upsertRelationship(string, string, Record<string, unknown>, DigitalTwinsAddRelationshipOptionalParams)

デジタル ツインのリレーションシップを作成または更新します。

コンストラクターの詳細

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

操作オプション

戻り値

作成された 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。

options
DigitalTwinsDeleteRelationshipOptionalParams

操作オプション 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

操作オプション

戻り値

指定された componentName に対応するコンポーネントの JSON 文字列表現。

getDigitalTwin(string, OperationOptions)

デジタル ツインを取得する

function getDigitalTwin(digitalTwinId: string, options?: OperationOptions): Promise<DigitalTwinsGetByIdResponse>

パラメーター

digitalTwinId

string

デジタル ツインの ID。

options
OperationOptions

操作オプション

戻り値

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

この操作のオプション

戻り値

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。

戻り値

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。

戻り値

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

クエリ操作のオプション。

戻り値

クエリ結果のページング可能な一覧。

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 操作。

options
DigitalTwinsUpdateComponentOptionalParams

ifMatch を含む拡張操作オプション: エンティティの etag が指定された etag のいずれかに一致する場合、または * が指定されている場合にのみ操作を実行します。

戻り値

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 のいずれかに一致する場合、または * が指定されている場合にのみ操作を実行します。

戻り値

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 操作。

options
DigitalTwinsUpdateRelationshipOptionalParams

拡張操作オプション 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 を含む拡張操作オプション: エンティティがまだ存在しない場合にのみ操作を実行します。

戻り値

作成された 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 リレーションシップ。

options
DigitalTwinsAddRelationshipOptionalParams

ifNoneMatch を含む拡張操作オプション: エンティティがまだ存在しない場合にのみ操作を実行します。

戻り値