DigitalTwinsClient class

Balíček:

@azure/digital-twins-core

Klient pro rozhraní API Azure IoT DigitalTwins

Konstruktory

DigitalTwinsClient(string, TokenCredential, DigitalTwinsClientOptions)

Vytvoří instanci AzureDigitalTwinsAPI. Příklad použití: 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);

Metody

createModels(Record<string, unknown>[], OperationOptions)	Vytvoření jednoho nebo několika
decomissionModel(string, OperationOptions)	Vyřazení modelu z provozu pomocí opravy JSON Když se model vyřadí z provozu, nebudou už moci být novými digitálními dvojčaty definovány tímto modelem. Stávající digitální dvojčata však mohou tento model nadále používat. Jakmile se model vyřadí z provozu, nemusí se znovu překompisovat.
deleteDigitalTwin(string, DigitalTwinsDeleteOptionalParams)	Odstranění digitálního dvojčete
deleteEventRoute(string, OperationOptions)	Odstraňte trasu události.
deleteModel(string, OperationOptions)	Odstraňte model.
deleteRelationship(string, string, DigitalTwinsDeleteRelationshipOptionalParams)	Odstranění relace u digitálního dvojčete
getComponent(string, string, OperationOptions)	Získejte součást digitálního dvojčete.
getDigitalTwin(string, OperationOptions)	Získání digitálního dvojčete
getEventRoute(string, OperationOptions)	Získejte trasu události.
getModel(string, DigitalTwinModelsGetByIdOptionalParams)	Získejte model, včetně metadat modelu a definice modelu.
getRelationship(string, string, OperationOptions)	Získejte vztah k digitálnímu dvojčeti.
listEventRoutes(EventRoutesListOptionalParams)	Vypište trasy událostí v instanci digitálních dvojčat.
listIncomingRelationships(string, DigitalTwinsListIncomingRelationshipsOptionalParams)	Načtěte všechny příchozí relace pro digitální dvojče.
listModels(DigitalTwinModelsListOptionalParams)	Získání seznamu modelů
listRelationships(string, DigitalTwinsListRelationshipsOptionalParams)	Načtení relací pro digitální dvojče.
publishComponentTelemetry(string, string, Record<string, unknown>, string, OperationOptions)	Publikujte telemetrii ze komponenty digitálního dvojčete, která se pak spotřebovává jedním nebo mnoha cílovými koncovými body (odběrateli) definovanými v části.
publishTelemetry(string, Record<string, unknown>, string, OperationOptions)	Publikujte telemetrii z digitálního dvojčete, které pak využívá jeden nebo mnoho cílových koncových bodů (odběratelů) definovaných v rámci.
queryTwins(string, QueryQueryTwinsOptionalParams)	Dotaz na digitální dvojčata
updateComponent(string, string, Record<string, unknown>[], DigitalTwinsUpdateComponentOptionalParams)	Aktualizujte vlastnosti komponenty v digitálním dvojčeti pomocí opravy JSON.
updateDigitalTwin(string, Record<string, unknown>[], DigitalTwinsUpdateOptionalParams)	Aktualizujte digitální dvojče pomocí opravy JSON.
updateRelationship(string, string, Record<string, unknown>[], DigitalTwinsUpdateRelationshipOptionalParams)	Aktualizuje vlastnosti relace u digitálního dvojčete pomocí opravy JSON.
upsertDigitalTwin(string, string, DigitalTwinsAddOptionalParams)	Vytvoření nebo aktualizace digitálního dvojčete
upsertEventRoute(string, string, string, OperationOptions)	Vytvořte nebo aktualizujte trasu události.
upsertRelationship(string, string, Record<string, unknown>, DigitalTwinsAddRelationshipOptionalParams)	Vytvořte nebo aktualizujte relaci u digitálního dvojčete.

Podrobnosti konstruktoru

DigitalTwinsClient(string, TokenCredential, DigitalTwinsClientOptions)

Vytvoří instanci AzureDigitalTwinsAPI.

Příklad použití:

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)

Parametry

endpointUrl

string

Adresa URL koncového bodu služby.

credential

TokenCredential

Používá se k ověřování požadavků na službu.

options

DigitalTwinsClientOptions

Slouží ke konfiguraci klienta služby.

Podrobnosti metody

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

Vytvoření jednoho nebo několika

function createModels(dtdlModels: Record<string, unknown>[], options?: OperationOptions): Promise<DigitalTwinModelsAddResponse>

Parametry

dtdlModels

Record<string, unknown>[]

Sada modelů, které chcete vytvořit. Každý řetězec odpovídá přesně jednomu modelu.

options

OperationOptions

Možnosti operace

Návraty

Promise<DigitalTwinModelsAddResponse>

Vytvořené aplikace/json modely.

decomissionModel(string, OperationOptions)

Vyřazení modelu z provozu pomocí opravy JSON Když se model vyřadí z provozu, nebudou už moci být novými digitálními dvojčaty definovány tímto modelem. Stávající digitální dvojčata však mohou tento model nadále používat. Jakmile se model vyřadí z provozu, nemusí se znovu překompisovat.

function decomissionModel(modelId: string, options?: OperationOptions): Promise<void>

Parametry

modelId

string

ID modelu, který se má vyřadit z provozu. vlastnost lze nahradit.

options

OperationOptions

Možnosti operace

Návraty

Promise<void>

deleteDigitalTwin(string, DigitalTwinsDeleteOptionalParams)

Odstranění digitálního dvojčete

function deleteDigitalTwin(digitalTwinId: string, options?: DigitalTwinsDeleteOptionalParams): Promise<void>

Parametry

digitalTwinId

string

ID digitálního dvojčete, které chcete odstranit.

options

DigitalTwinsDeleteOptionalParams

Rozšířené možnosti operace, včetně ifMatch: Proveďte operaci pouze v případě, že etag entity odpovídá některé ze zadaných značek nebo * je k dispozici.

Návraty

Promise<void>

deleteEventRoute(string, OperationOptions)

Odstraňte trasu události.

function deleteEventRoute(eventRouteId: string, options?: OperationOptions): Promise<void>

Parametry

eventRouteId

string

ID událostiRoute, která se má odstranit.

options

OperationOptions

Možnosti operace

Návraty

Promise<void>

deleteModel(string, OperationOptions)

Odstraňte model.

function deleteModel(modelId: string, options?: OperationOptions): Promise<void>

Parametry

modelId

string

ID modelu, který chcete odstranit.

options

OperationOptions

Možnosti operace

Návraty

Promise<void>

deleteRelationship(string, string, DigitalTwinsDeleteRelationshipOptionalParams)

Odstranění relace u digitálního dvojčete

function deleteRelationship(digitalTwinId: string, relationshipId: string, options?: DigitalTwinsDeleteRelationshipOptionalParams): Promise<void>

Parametry

digitalTwinId

string

ID zdrojového digitálního dvojčete.

relationshipId

string

ID relace, která se má odstranit.

options

DigitalTwinsDeleteRelationshipOptionalParams

Možnosti operace ifMatch: Proveďte operaci pouze v případě, že etag entity odpovídá některé ze zadaných značek nebo * je

Návraty

Promise<void>

getComponent(string, string, OperationOptions)

Získejte součást digitálního dvojčete.

function getComponent(digitalTwinId: string, componentName: string, options?: OperationOptions): Promise<DigitalTwinsGetComponentResponse>

Parametry

digitalTwinId

string

ID digitálního dvojčete.

componentName

string

Načítá se komponenta.

options

OperationOptions

Možnosti operace

Návraty

Promise<DigitalTwinsGetComponentResponse>

Řetězcová reprezentace JSON komponenty odpovídající zadanému komponentnímu objektu.

getDigitalTwin(string, OperationOptions)

Získání digitálního dvojčete

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

Parametry

digitalTwinId

string

ID digitálního dvojčete.

options

OperationOptions

Možnosti operace

Návraty

Promise<DigitalTwinsGetByIdResponse>

Digitální dvojče application/json.

getEventRoute(string, OperationOptions)

Získejte trasu události.

function getEventRoute(eventRouteId: string, options?: OperationOptions): Promise<EventRoute>

Parametry

eventRouteId

string

options

OperationOptions

Možnosti operace

Návraty

Promise<EventRoute>

Trasa události application/json.

getModel(string, DigitalTwinModelsGetByIdOptionalParams)

Získejte model, včetně metadat modelu a definice modelu.

function getModel(modelId: string, options?: DigitalTwinModelsGetByIdOptionalParams): Promise<DigitalTwinsModelData>

Parametry

modelId

string

ID modelu.

options

GetModelOptions

Možnosti pro tuto operaci

Návraty

Promise<DigitalTwinsModelData>

Model application/json.

getRelationship(string, string, OperationOptions)

Získejte vztah k digitálnímu dvojčeti.

function getRelationship(digitalTwinId: string, relationshipId: string, options?: OperationOptions): Promise<DigitalTwinsGetRelationshipByIdResponse>

Parametry

digitalTwinId

string

ID zdrojového digitálního dvojčete.

relationshipId

string

ID relace, která se má načíst.

options

OperationOptions

Možnosti operace

Návraty

Promise<DigitalTwinsGetRelationshipByIdResponse>

Stránkovatelný seznam vztahů application/json patřících do zadaného digitálního dvojčete.

listEventRoutes(EventRoutesListOptionalParams)

Vypište trasy událostí v instanci digitálních dvojčat.

function listEventRoutes(options?: EventRoutesListOptionalParams): PagedAsyncIterableIterator<EventRoute, EventRoute[], PageSettings>

Parametry

options

ListEventRoutesOptions

Možnosti pro listEventRoutes.

Návraty

PagedAsyncIterableIterator<EventRoute, EventRoute[], PageSettings>

Trasa události application/json.

listIncomingRelationships(string, DigitalTwinsListIncomingRelationshipsOptionalParams)

Načtěte všechny příchozí relace pro digitální dvojče.

function listIncomingRelationships(digitalTwinId: string, options?: DigitalTwinsListIncomingRelationshipsOptionalParams): PagedAsyncIterableIterator<IncomingRelationship, IncomingRelationship[], PageSettings>

Parametry

digitalTwinId

string

ID digitálního dvojčete.

options

ListIncomingRelationshipsOptions

Návraty

PagedAsyncIterableIterator<IncomingRelationship, IncomingRelationship[], PageSettings>

listModels(DigitalTwinModelsListOptionalParams)

Získání seznamu modelů

function listModels(options?: DigitalTwinModelsListOptionalParams): PagedAsyncIterableIterator<DigitalTwinsModelData, DigitalTwinsModelData[], PageSettings>

Parametry

options

ListModelsOptions

Možnosti výpisu modelů

Návraty

PagedAsyncIterableIterator<DigitalTwinsModelData, DigitalTwinsModelData[], PageSettings>

Stránkovatelná sada modelů application/json.

listRelationships(string, DigitalTwinsListRelationshipsOptionalParams)

Načtení relací pro digitální dvojče.

function listRelationships(digitalTwinId: string, options?: DigitalTwinsListRelationshipsOptionalParams): PagedAsyncIterableIterator<Record<string, unknown>, Record<string, unknown>[], PageSettings>

Parametry

digitalTwinId

string

ID digitálního dvojčete.

options

ListRelationshipsOptions

Návraty

PagedAsyncIterableIterator<Record<string, unknown>, Record<string, unknown>[], PageSettings>

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

Publikujte telemetrii ze komponenty digitálního dvojčete, která se pak spotřebovává jedním nebo mnoha cílovými koncovými body (odběrateli) definovanými v části.

function publishComponentTelemetry(digitalTwinId: string, componentName: string, payload: Record<string, unknown>, messageId: string, options?: OperationOptions): Promise<void>

Parametry

digitalTwinId

string

ID digitálního dvojčete, které chcete odstranit.

componentName

string

Název komponenty DTDL.

payload

Record<string, unknown>

Datová část telemetrie application/json, která se má odeslat.

messageId

string

ID zprávy.

options

OperationOptions

Možnosti operace

Návraty

Promise<void>

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

Publikujte telemetrii z digitálního dvojčete, které pak využívá jeden nebo mnoho cílových koncových bodů (odběratelů) definovaných v rámci.

function publishTelemetry(digitalTwinId: string, payload: Record<string, unknown>, messageId: string, options?: OperationOptions): Promise<void>

Parametry

digitalTwinId

string

ID digitálního dvojčete, které chcete odstranit.

payload

Record<string, unknown>

Datová část telemetrie application/json, která se má odeslat.

messageId

string

ID zprávy.

options

OperationOptions

Možnosti operace

Návraty

Promise<void>

queryTwins(string, QueryQueryTwinsOptionalParams)

Dotaz na digitální dvojčata

function queryTwins(query: string, options?: QueryQueryTwinsOptionalParams): PagedAsyncIterableIterator<Record<string, unknown>, QueryQueryTwinsResponse, PageSettings>

Parametry

query

string

Řetězec dotazu v syntaxi podobné JAZYKu SQL.

options

QueryTwinsOptions

Možnosti pro operaci dotazu.

Návraty

PagedAsyncIterableIterator<Record<string, unknown>, QueryQueryTwinsResponse, PageSettings>

Stránkovatelný seznam výsledků dotazu.

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

Aktualizujte vlastnosti komponenty v digitálním dvojčeti pomocí opravy JSON.

function updateComponent(digitalTwinId: string, componentName: string, jsonPatch: Record<string, unknown>[], options?: DigitalTwinsUpdateComponentOptionalParams): Promise<DigitalTwinsUpdateComponentHeaders>

Parametry

digitalTwinId

string

ID digitálního dvojčete.

componentName

string

Komponenta, která se aktualizuje.

jsonPatch

Record<string, unknown>[]

Operace application/json-patch+json, které se mají provést u zadané komponenty digitálního dvojčete.

options

DigitalTwinsUpdateComponentOptionalParams

Rozšířené možnosti operace, včetně ifMatch: Proveďte operaci pouze v případě, že etag entity odpovídá některé ze zadaných značek nebo * je k dispozici.

Návraty

Promise<DigitalTwinsUpdateComponentHeaders>

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

Aktualizujte digitální dvojče pomocí opravy JSON.

function updateDigitalTwin(digitalTwinId: string, jsonPatch: Record<string, unknown>[], options?: DigitalTwinsUpdateOptionalParams): Promise<DigitalTwinsUpdateHeaders>

Parametry

digitalTwinId

string

ID digitálního dvojčete.

jsonPatch

Record<string, unknown>[]

Specifikace aktualizace popsaná opravou JSON. Aktualizace hodnot vlastností a $model elementů můžou nastat ve stejném požadavku. Operace jsou omezené na přidání, nahrazení a odebrání.

options

DigitalTwinsUpdateOptionalParams

Rozšířené možnosti operace, včetně ifMatch: Proveďte operaci pouze v případě, že etag entity odpovídá některé ze zadaných značek nebo * je k dispozici.

Návraty

Promise<DigitalTwinsUpdateHeaders>

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

Aktualizuje vlastnosti relace u digitálního dvojčete pomocí opravy JSON.

function updateRelationship(digitalTwinId: string, relationshipId: string, jsonPatch: Record<string, unknown>[], options?: DigitalTwinsUpdateRelationshipOptionalParams): Promise<DigitalTwinsUpdateRelationshipHeaders>

Parametry

digitalTwinId

string

ID digitálního dvojčete, které chcete odstranit.

relationshipId

string

ID relace, která se má aktualizovat.

jsonPatch

Record<string, unknown>[]

Operace application/json-patch+json, které se mají provést u zadané relace digitálního dvojčete.

options

DigitalTwinsUpdateRelationshipOptionalParams

Rozšířené možnosti operace ifMatch: Proveďte operaci pouze v případě, že etag entity odpovídá některé ze zadaných značek nebo * je k dispozici.

Návraty

Promise<DigitalTwinsUpdateRelationshipHeaders>

upsertDigitalTwin(string, string, DigitalTwinsAddOptionalParams)

Vytvoření nebo aktualizace digitálního dvojčete

function upsertDigitalTwin(digitalTwinId: string, digitalTwinJson: string, options?: DigitalTwinsAddOptionalParams): Promise<DigitalTwinsAddResponse>

Parametry

digitalTwinId

string

ID digitálního dvojčete, které se má vytvořit nebo aktualizovat.

digitalTwinJson

string

Vytvoření digitálního dvojčete application/json

options

DigitalTwinsAddOptionalParams

Rozšířené možnosti operace, včetně ifNoneMatch: Proveďte operaci pouze v případě, že entita ještě neexistuje.

Návraty

Promise<DigitalTwinsAddResponse>

Vytvořené digitální dvojče aplikace/json.

upsertEventRoute(string, string, string, OperationOptions)

Vytvořte nebo aktualizujte trasu události.

function upsertEventRoute(eventRouteId: string, endpointId: string, filter: string, options?: OperationOptions): Promise<void>

Parametry

eventRouteId

string

ID trasy události, která se má vytvořit nebo aktualizovat.

endpointId

string

ID koncového bodu, ke které je tato trasa události vázána.

filter

string

Výraz, který popisuje události směrované do koncového bodu.

options

OperationOptions

Možnosti operace

Návraty

Promise<void>

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

Vytvořte nebo aktualizujte relaci u digitálního dvojčete.

function upsertRelationship(digitalTwinId: string, relationshipId: string, relationship: Record<string, unknown>, options?: DigitalTwinsAddRelationshipOptionalParams): Promise<DigitalTwinsAddRelationshipResponse>

Parametry

digitalTwinId

string

ID zdrojového digitálního dvojčete.

relationshipId

string

ID relace, která se má vytvořit.

relationship

Record<string, unknown>

Relace application/json, která se má vytvořit.

options

DigitalTwinsAddRelationshipOptionalParams

Rozšířené možnosti operace, včetně ifNoneMatch: Proveďte operaci pouze v případě, že entita ještě neexistuje.

Návraty

Promise<DigitalTwinsAddRelationshipResponse>