DigitalTwinsClient class

API Client per Azure IoT DigitalTwins.

Costruttori

DigitalTwinsClient(string, TokenCredential, DigitalTwinsClientOptions)

Crea un'istanza di AzureDigitalTwinsAPI.

Esempio di utilizzo:

const { DigitalTwinsClient, ServiceClientCredentials } = require("@azure/digital-twins-core");

const client = new DigitalTwinsClient(
  "<endpoint>",
  new DefaultAzureCredential();
);

Metodi

createModels(any[], OperationOptions)

Creare uno o più

decomissionModel(string, OperationOptions)

Rimuovere le autorizzazioni di un modello usando una patch JSON. Quando un modello viene rimosso, i nuovi gemelli digitali non saranno più in grado di essere definiti da questo modello. Tuttavia, i gemelli digitali esistenti possono continuare a usare questo modello. Una volta rimosso un modello, è possibile che non venga ricommissionato.

deleteDigitalTwin(string, DigitalTwinsDeleteOptionalParams)

Eliminare un gemello digitale

deleteEventRoute(string, OperationOptions)

Eliminare una route evento.

deleteModel(string, OperationOptions)

Eliminare un modello.

deleteRelationship(string, string, DigitalTwinsDeleteRelationshipOptionalParams)

Eliminare una relazione su un gemello digitale.

getComponent(string, string, OperationOptions)

Ottenere un componente in un gemello digitale.

getDigitalTwin(string, OperationOptions)

Ottenere un gemello digitale

getEventRoute(string, OperationOptions)

Ottenere una route di eventi.

getModel(string, boolean, OperationOptions)

Ottenere un modello, inclusi i metadati del modello e la definizione del modello.

getRelationship(string, string, OperationOptions)

Ottenere una relazione su un gemello digitale.

listEventRoutes(number, OperationOptions & PageSettings)

Elencare le route degli eventi in un'istanza di gemelli digitali.

listIncomingRelationships(string, OperationOptions & PageSettings)

Recuperare tutte le relazioni in ingresso per un gemello digitale.

listModels(string[], boolean, number, OperationOptions & PageSettings)

Ottenere l'elenco di modelli

listRelationships(string, OperationOptions & PageSettings)

Recuperare le relazioni per un gemello digitale.

publishComponentTelemetry(string, string, string, string, OperationOptions)

Pubblicare i dati di telemetria dal componente di un gemello digitale, che viene quindi utilizzato da uno o più endpoint di destinazione (sottoscrittori) definiti in .

publishTelemetry(string, any, string, OperationOptions)

Pubblicare i dati di telemetria da un gemello digitale, che viene quindi utilizzato da uno o più endpoint di destinazione (sottoscrittori) definiti in .

queryTwins(string, number, OperationOptions & PageSettings)

Eseguire una query per gemelli digitali.

updateComponent(string, string, any[], DigitalTwinsUpdateComponentOptionalParams)

Aggiornare le proprietà di un componente in un gemello digitale usando una patch JSON.

updateDigitalTwin(string, any, DigitalTwinsUpdateOptionalParams)

Aggiornare un gemello digitale usando una patch json.

updateRelationship(string, string, any[], DigitalTwinsUpdateRelationshipOptionalParams)

Aggiornamenti le proprietà di una relazione su un gemello digitale usando una patch JSON.

upsertDigitalTwin(string, string, DigitalTwinsAddOptionalParams)

Creare o aggiornare un gemello digitale

upsertEventRoute(string, string, string, OperationOptions)

Creare o aggiornare una route di eventi.

upsertRelationship(string, string, any, DigitalTwinsAddRelationshipOptionalParams)

Creare o aggiornare una relazione su un gemello digitale.

Dettagli costruttore

DigitalTwinsClient(string, TokenCredential, DigitalTwinsClientOptions)

Crea un'istanza di AzureDigitalTwinsAPI.

Esempio di utilizzo:

const { DigitalTwinsClient, ServiceClientCredentials } = require("@azure/digital-twins-core");

const client = new DigitalTwinsClient(
  "<endpoint>",
  new DefaultAzureCredential();
);
new DigitalTwinsClient(endpointUrl: string, credential: TokenCredential, options?: DigitalTwinsClientOptions)

Parametri

endpointUrl

string

URL dell'endpoint del servizio.

credential
TokenCredential

Usato per autenticare le richieste al servizio.

options
DigitalTwinsClientOptions

Usato per configurare il client del servizio.

Dettagli metodo

createModels(any[], OperationOptions)

Creare uno o più

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

Parametri

dtdlModels

any[]

options
OperationOptions

Opzioni dell'operazione

Restituisce

I modelli di applicazione/json creati e la risposta HTTP.

decomissionModel(string, OperationOptions)

Rimuovere le autorizzazioni di un modello usando una patch JSON. Quando un modello viene rimosso, i nuovi gemelli digitali non saranno più in grado di essere definiti da questo modello. Tuttavia, i gemelli digitali esistenti possono continuare a usare questo modello. Una volta rimosso un modello, è possibile che non venga ricommissionato.

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

Parametri

modelId

string

ID del modello da rimuovere. la proprietà può essere sostituita.

options
OperationOptions

Opzioni dell'operazione

Restituisce

Promise<RestResponse>

Risposta HTTP.

deleteDigitalTwin(string, DigitalTwinsDeleteOptionalParams)

Eliminare un gemello digitale

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

Parametri

digitalTwinId

string

ID del gemello digitale da eliminare.

options
DigitalTwinsDeleteOptionalParams

Opzioni dell'operazione estesa, tra cui ifMatch: eseguire l'operazione solo se l'etag dell'entità corrisponde a uno degli etag forniti o * .

Restituisce

Promise<RestResponse>

Risposta HTTP.

deleteEventRoute(string, OperationOptions)

Eliminare una route evento.

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

Parametri

eventRouteId

string

ID dell'eventoRoute da eliminare.

options
OperationOptions

Opzioni dell'operazione

Restituisce

Promise<RestResponse>

Risposta HTTP.

deleteModel(string, OperationOptions)

Eliminare un modello.

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

Parametri

modelId

string

ID del modello da eliminare.

options
OperationOptions

Opzioni dell'operazione

Restituisce

Promise<RestResponse>

Risposta HTTP.

deleteRelationship(string, string, DigitalTwinsDeleteRelationshipOptionalParams)

Eliminare una relazione su un gemello digitale.

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

Parametri

digitalTwinId

string

ID del gemello digitale di origine.

relationshipId

string

ID della relazione da eliminare.

options
DigitalTwinsDeleteRelationshipOptionalParams

Opzioni dell'operazione ifMatch: eseguire l'operazione solo se l'etag dell'entità corrisponde a uno degli etag forniti o * è

Restituisce

Promise<RestResponse>

Risposta HTTP.

getComponent(string, string, OperationOptions)

Ottenere un componente in un gemello digitale.

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

Parametri

digitalTwinId

string

ID del gemello digitale.

componentName

string

Componente recuperato.

options
OperationOptions

Opzioni dell'operazione

Restituisce

Rappresentazione di stringa JSON del componente corrispondente al componentName fornito e alla risposta HTTP.

getDigitalTwin(string, OperationOptions)

Ottenere un gemello digitale

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

Parametri

digitalTwinId

string

ID del gemello digitale.

options
OperationOptions

Opzioni di operazione

Restituisce

Il gemello digitale application/json e la risposta http.

getEventRoute(string, OperationOptions)

Ottenere una route di eventi.

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

Parametri

eventRouteId

string

options
OperationOptions

Opzioni di operazione

Restituisce

Route dell'evento application/json e della risposta http.

getModel(string, boolean, OperationOptions)

Ottenere un modello, inclusi i metadati del modello e la definizione del modello.

function getModel(modelId: string, includeModelDefinition?: boolean, options?: OperationOptions): Promise<DigitalTwinModelsGetByIdResponse>

Parametri

modelId

string

ID del modello.

includeModelDefinition

boolean

options
OperationOptions

Opzioni di operazione estese, tra cui includeModelDefinition: quando viene restituita la definizione del modello come parte del risultato. Valore predefinito: false.

Restituisce

Modello application/json e risposta http.

getRelationship(string, string, OperationOptions)

Ottenere una relazione su un gemello digitale.

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

Parametri

digitalTwinId

string

ID del gemello digitale di origine.

relationshipId

string

ID della relazione da recuperare.

options
OperationOptions

Opzioni di operazione

Restituisce

Elenco paginabile delle relazioni application/json appartenenti al gemello digitale specificato e alla risposta http.

listEventRoutes(number, OperationOptions & PageSettings)

Elencare le route degli eventi in un'istanza di gemelli digitali.

function listEventRoutes(resultsPerPage?: number, options?: OperationOptions & PageSettings): PagedAsyncIterableIterator<EventRoute, EventRoutesListNextResponse, PageSettings>

Parametri

resultsPerPage

number

Numero massimo di elementi da recuperare per richiesta. Il server può scegliere di restituire meno del massimo richiesto.

Restituisce

Route dell'evento application/json e della risposta http.

listIncomingRelationships(string, OperationOptions & PageSettings)

Recuperare tutte le relazioni in ingresso per un gemello digitale.

function listIncomingRelationships(digitalTwinId: string, options?: OperationOptions & PageSettings): PagedAsyncIterableIterator<IncomingRelationship, DigitalTwinsListIncomingRelationshipsResponse, PageSettings>

Parametri

digitalTwinId

string

ID del gemello digitale.

Restituisce

listModels(string[], boolean, number, OperationOptions & PageSettings)

Ottenere l'elenco di modelli

function listModels(dependeciesFor?: string[], includeModelDefinition?: boolean, resultsPerPage?: number, options?: OperationOptions & PageSettings): PagedAsyncIterableIterator<DigitalTwinsModelData, DigitalTwinModelsListResponse, PageSettings>

Parametri

dependeciesFor

string[]

ID modello per avere le dipendenze recuperate. Se omesso, tutti i modelli vengono recuperati.

includeModelDefinition

boolean

Se includere la definizione del modello nel risultato. Se false, verranno restituiti solo i metadati del modello.

resultsPerPage

number

Numero massimo di elementi da recuperare per richiesta. Il server può scegliere di restituire meno del massimo richiesto.

Restituisce

Set di modelli application/json paginabili e risposta http.

listRelationships(string, OperationOptions & PageSettings)

Recuperare le relazioni per un gemello digitale.

function listRelationships(digitalTwinId: string, options?: OperationOptions & PageSettings): PagedAsyncIterableIterator<any, DigitalTwinsListRelationshipsResponse, PageSettings>

Parametri

digitalTwinId

string

ID del gemello digitale.

Restituisce

publishComponentTelemetry(string, string, string, string, OperationOptions)

Pubblicare i dati di telemetria dal componente di un gemello digitale, che viene quindi utilizzato da uno o più endpoint di destinazione (sottoscrittori) definiti in .

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

Parametri

digitalTwinId

string

ID del gemello digitale da eliminare.

componentName

string

Nome del componente DTDL.

payload

string

Payload di telemetria application/json da inviare.

messageId

string

ID messaggio.

options
OperationOptions

Opzioni di operazione

Restituisce

Promise<RestResponse>

Risposta HTTP.

publishTelemetry(string, any, string, OperationOptions)

Pubblicare i dati di telemetria da un gemello digitale, che viene quindi utilizzato da uno o più endpoint di destinazione (sottoscrittori) definiti in .

function publishTelemetry(digitalTwinId: string, payload: any, messageId: string, options?: OperationOptions): Promise<RestResponse>

Parametri

digitalTwinId

string

ID del gemello digitale da eliminare.

payload

any

Payload di telemetria application/json da inviare.

messageId

string

ID messaggio.

options
OperationOptions

Opzioni di operazione

Restituisce

Promise<RestResponse>

Risposta HTTP.

queryTwins(string, number, OperationOptions & PageSettings)

Eseguire una query per gemelli digitali.

function queryTwins(query: string, resultsPerPage?: number, options?: OperationOptions & PageSettings): PagedAsyncIterableIterator<any, QueryQueryTwinsResponse, PageSettings>

Parametri

query

string

Stringa di query, nella sintassi simile a SQL.

resultsPerPage

number

Numero massimo di elementi da recuperare per richiesta. Il server può scegliere di restituire meno del massimo richiesto.

Restituisce

Elenco paginabile dei risultati della query.

updateComponent(string, string, any[], DigitalTwinsUpdateComponentOptionalParams)

Aggiornare le proprietà di un componente in un gemello digitale usando una patch JSON.

function updateComponent(digitalTwinId: string, componentName: string, jsonPatch: any[], options?: DigitalTwinsUpdateComponentOptionalParams): Promise<DigitalTwinsUpdateComponentResponse>

Parametri

digitalTwinId

string

ID del gemello digitale.

componentName

string

Componente aggiornato.

jsonPatch

any[]

Le operazioni application/json-patch+json da eseguire nel componente del gemello digitale specificato.

options
DigitalTwinsUpdateComponentOptionalParams

Opzioni di operazione estese, tra cui ifMatch: eseguire l'operazione solo se l'etag dell'entità corrisponde a uno dei etag forniti o * viene fornito.

Restituisce

Risposta HTTP.

updateDigitalTwin(string, any, DigitalTwinsUpdateOptionalParams)

Aggiornare un gemello digitale usando una patch json.

function updateDigitalTwin(digitalTwinId: string, jsonPatch: any, options?: DigitalTwinsUpdateOptionalParams): Promise<DigitalTwinsUpdateResponse>

Parametri

digitalTwinId

string

ID del gemello digitale.

jsonPatch

any

Specifica di aggiornamento descritta da JSON Patch. Aggiornamenti ai valori delle proprietà e agli elementi $model possono verificarsi nella stessa richiesta. Le operazioni sono limitate a aggiungere, sostituire e rimuovere.

options
DigitalTwinsUpdateOptionalParams

Opzioni di operazione estese, tra cui ifMatch: eseguire l'operazione solo se l'etag dell'entità corrisponde a uno dei etag forniti o * viene fornito.

Restituisce

Risposta HTTP.

updateRelationship(string, string, any[], DigitalTwinsUpdateRelationshipOptionalParams)

Aggiornamenti le proprietà di una relazione su un gemello digitale usando una patch JSON.

function updateRelationship(digitalTwinId: string, relationshipId: string, jsonPatch: any[], options?: DigitalTwinsUpdateRelationshipOptionalParams): Promise<DigitalTwinsUpdateRelationshipResponse>

Parametri

digitalTwinId

string

ID del gemello digitale da eliminare.

relationshipId

string

ID della relazione da aggiornare.

jsonPatch

any[]

Le operazioni application/json-patch+json da eseguire nella relazione del gemello digitale specificato.

options
DigitalTwinsUpdateRelationshipOptionalParams

Opzioni di operazione estesa ifMatch: eseguire l'operazione solo se l'etag dell'entità corrisponde a uno dei etag forniti o * viene fornito.

Restituisce

upsertDigitalTwin(string, string, DigitalTwinsAddOptionalParams)

Creare o aggiornare un gemello digitale

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

Parametri

digitalTwinId

string

ID del gemello digitale da creare o aggiornare.

digitalTwinJson

string

Applicazione/json gemello digitale da creare.

options
DigitalTwinsAddOptionalParams

Opzioni di operazione estese, tra cui ifNoneMatch: eseguire l'operazione solo se l'entità non esiste già.

Restituisce

Il gemello digitale /json creato e la risposta http.

upsertEventRoute(string, string, string, OperationOptions)

Creare o aggiornare una route di eventi.

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

Parametri

eventRouteId

string

ID della route dell'evento da creare o aggiornare.

endpointId

string

L'ID dell'endpoint a cui è associata questa route evento.

filter

string

Espressione che descrive gli eventi indirizzati all'endpoint.

options
OperationOptions

Opzioni di operazione

Restituisce

Promise<RestResponse>

Risposta HTTP.

upsertRelationship(string, string, any, DigitalTwinsAddRelationshipOptionalParams)

Creare o aggiornare una relazione su un gemello digitale.

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

Parametri

digitalTwinId

string

ID del gemello digitale di origine.

relationshipId

string

ID della relazione da creare.

relationship

any

Relazione application/json da creare.

options
DigitalTwinsAddRelationshipOptionalParams

Opzioni di operazione estese, tra cui ifNoneMatch: eseguire l'operazione solo se l'entità non esiste già.

Restituisce