DigitalTwinsClient class
API Client per Azure IoT DigitalTwins.
Costruttori
Digital |
Crea un'istanza di AzureDigitalTwinsAPI. Esempio di utilizzo:
|
Metodi
create |
Creare uno o più |
decomission |
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. |
delete |
Eliminare un gemello digitale |
delete |
Eliminare una route evento. |
delete |
Eliminare un modello. |
delete |
Eliminare una relazione su un gemello digitale. |
get |
Ottenere un componente in un gemello digitale. |
get |
Ottenere un gemello digitale |
get |
Ottenere una route di eventi. |
get |
Ottenere un modello, inclusi i metadati del modello e la definizione del modello. |
get |
Ottenere una relazione su un gemello digitale. |
list |
Elencare le route degli eventi in un'istanza di gemelli digitali. |
list |
Recuperare tutte le relazioni in ingresso per un gemello digitale. |
list |
Ottenere l'elenco di modelli |
list |
Recuperare le relazioni per un gemello digitale. |
publish |
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 . |
publish |
Pubblicare i dati di telemetria da un gemello digitale, che viene quindi utilizzato da uno o più endpoint di destinazione (sottoscrittori) definiti in . |
query |
Eseguire una query per gemelli digitali. |
update |
Aggiornare le proprietà di un componente in un gemello digitale usando una patch JSON. |
update |
Aggiornare un gemello digitale usando una patch json. |
update |
Aggiornamenti le proprietà di una relazione su un gemello digitale usando una patch JSON. |
upsert |
Creare o aggiornare un gemello digitale |
upsert |
Creare o aggiornare una route di eventi. |
upsert |
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
Promise<DigitalTwinModelsAddResponse>
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.
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
Promise<DigitalTwinsGetComponentResponse>
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
Promise<DigitalTwinsGetByIdResponse>
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
Promise<EventRoutesGetByIdResponse>
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
Promise<DigitalTwinModelsGetByIdResponse>
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.
- options
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.
- options
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.
- options
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.
- options
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.
- options
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.
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
Promise<DigitalTwinsUpdateComponentResponse>
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
Promise<DigitalTwinsUpdateResponse>
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.
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
Promise<DigitalTwinsAddResponse>
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.
Opzioni di operazione estese, tra cui ifNoneMatch: eseguire l'operazione solo se l'entità non esiste già.
Restituisce
Promise<DigitalTwinsAddRelationshipResponse>