Compartir a través de


DigitalTwinsClient class

Cliente para azure IoT DigitalTwins API.

Constructores

DigitalTwinsClient(string, TokenCredential, DigitalTwinsClientOptions)

Crea una instancia de AzureDigitalTwinsAPI.

Uso de ejemplo:

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

Métodos

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

Crear uno o varios

decomissionModel(string, OperationOptions)

Retirar un modelo mediante una revisión json. Cuando se retira un modelo, este modelo ya no podrá definir nuevos gemelos digitales. Sin embargo, los gemelos digitales existentes pueden seguir usando este modelo. Una vez que se retira un modelo, es posible que no se vuelva a retirar.

deleteDigitalTwin(string, DigitalTwinsDeleteOptionalParams)

Eliminación de un gemelo digital

deleteEventRoute(string, OperationOptions)

Elimine una ruta de eventos.

deleteModel(string, OperationOptions)

Eliminar un modelo.

deleteRelationship(string, string, DigitalTwinsDeleteRelationshipOptionalParams)

Elimina una relación en un gemelo digital.

getComponent(string, string, OperationOptions)

Obtenga un componente en un gemelo digital.

getDigitalTwin(string, OperationOptions)

Obtención de un gemelo digital

getEventRoute(string, OperationOptions)

Obtener una ruta de eventos.

getModel(string, DigitalTwinModelsGetByIdOptionalParams)

Obtenga un modelo, incluidos los metadatos del modelo y la definición del modelo.

getRelationship(string, string, OperationOptions)

Obtener una relación en un gemelo digital.

listEventRoutes(EventRoutesListOptionalParams)

Enumere las rutas de eventos en una instancia de gemelos digitales.

listIncomingRelationships(string, DigitalTwinsListIncomingRelationshipsOptionalParams)

Recupere todas las relaciones entrantes de un gemelo digital.

listModels(DigitalTwinModelsListOptionalParams)

Obtener la lista de modelos

listRelationships(string, DigitalTwinsListRelationshipsOptionalParams)

Recupere las relaciones de un gemelo digital.

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

Publique la telemetría desde el componente de un gemelo digital, que luego se consume en uno o varios puntos de conexión de destino (suscriptores) definidos en.

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

Publique la telemetría desde un gemelo digital, que luego se consume en uno o varios puntos de conexión de destino (suscriptores) definidos en.

queryTwins(string, QueryQueryTwinsOptionalParams)

Consulta de gemelos digitales.

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

Actualice las propiedades de un componente de un gemelo digital mediante una revisión JSON.

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

Actualice un gemelo digital mediante una revisión json.

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

Actualiza las propiedades de una relación en un gemelo digital mediante una revisión JSON.

upsertDigitalTwin(string, string, DigitalTwinsAddOptionalParams)

Creación o actualización de un gemelo digital

upsertEventRoute(string, string, string, OperationOptions)

Cree o actualice una ruta de eventos.

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

Cree o actualice una relación en un gemelo digital.

Detalles del constructor

DigitalTwinsClient(string, TokenCredential, DigitalTwinsClientOptions)

Crea una instancia de AzureDigitalTwinsAPI.

Uso de ejemplo:

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)

Parámetros

endpointUrl

string

Dirección URL del punto de conexión del servicio.

credential
TokenCredential

Se usa para autenticar las solicitudes en el servicio.

options
DigitalTwinsClientOptions

Se usa para configurar el cliente de servicio.

Detalles del método

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

Crear uno o varios

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

Parámetros

dtdlModels

Record<string, unknown>[]

El conjunto de modelos que se van a crear. Cada cadena corresponde exactamente a un modelo.

options
OperationOptions

Opciones de operación

Devoluciones

Los modelos application/json creados.

decomissionModel(string, OperationOptions)

Retirar un modelo mediante una revisión json. Cuando se retira un modelo, este modelo ya no podrá definir nuevos gemelos digitales. Sin embargo, los gemelos digitales existentes pueden seguir usando este modelo. Una vez que se retira un modelo, es posible que no se vuelva a retirar.

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

Parámetros

modelId

string

Identificador del modelo que se va a retirar. se puede reemplazar la propiedad .

options
OperationOptions

Opciones de operación

Devoluciones

Promise<void>

deleteDigitalTwin(string, DigitalTwinsDeleteOptionalParams)

Eliminación de un gemelo digital

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital que se va a eliminar.

options
DigitalTwinsDeleteOptionalParams

Opciones de operación extendidas, incluidas ifMatch: solo realice la operación si la etiqueta electrónica de la entidad coincide con una de las etag proporcionadas o *.

Devoluciones

Promise<void>

deleteEventRoute(string, OperationOptions)

Elimine una ruta de eventos.

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

Parámetros

eventRouteId

string

Identificador del eventRoute que se va a eliminar.

options
OperationOptions

Opciones de operación

Devoluciones

Promise<void>

deleteModel(string, OperationOptions)

Eliminar un modelo.

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

Parámetros

modelId

string

Identificador del modelo que se va a eliminar.

options
OperationOptions

Opciones de operación

Devoluciones

Promise<void>

deleteRelationship(string, string, DigitalTwinsDeleteRelationshipOptionalParams)

Elimina una relación en un gemelo digital.

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital de origen.

relationshipId

string

Identificador de la relación que se va a eliminar.

options
DigitalTwinsDeleteRelationshipOptionalParams

Las opciones de operación ifMatch: solo realizan la operación si la etag de la entidad coincide con una de las etag proporcionadas o *

Devoluciones

Promise<void>

getComponent(string, string, OperationOptions)

Obtenga un componente en un gemelo digital.

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital.

componentName

string

Componente que se está recuperando.

options
OperationOptions

Opciones de operación

Devoluciones

Representación de cadena JSON del componente correspondiente al componentName proporcionado.

getDigitalTwin(string, OperationOptions)

Obtención de un gemelo digital

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital.

options
OperationOptions

Opciones de operación

Devoluciones

El gemelo digital application/json.

getEventRoute(string, OperationOptions)

Obtener una ruta de eventos.

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

Parámetros

eventRouteId

string

options
OperationOptions

Opciones de operación

Devoluciones

Promise<EventRoute>

La ruta del evento application/json.

getModel(string, DigitalTwinModelsGetByIdOptionalParams)

Obtenga un modelo, incluidos los metadatos del modelo y la definición del modelo.

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

Parámetros

modelId

string

Identificador del modelo.

options
GetModelOptions

Opciones para esta operación

Devoluciones

El modelo application/json.

getRelationship(string, string, OperationOptions)

Obtener una relación en un gemelo digital.

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital de origen.

relationshipId

string

Identificador de la relación que se va a recuperar.

options
OperationOptions

Opciones de operación

Devoluciones

La lista paginable de relaciones application/json que pertenecen al gemelo digital especificado.

listEventRoutes(EventRoutesListOptionalParams)

Enumere las rutas de eventos en una instancia de gemelos digitales.

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

Parámetros

options
ListEventRoutesOptions

Opciones para listEventRoutes.

Devoluciones

La ruta del evento application/json.

listIncomingRelationships(string, DigitalTwinsListIncomingRelationshipsOptionalParams)

Recupere todas las relaciones entrantes de un gemelo digital.

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital.

Devoluciones

listModels(DigitalTwinModelsListOptionalParams)

Obtener la lista de modelos

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

Parámetros

options
ListModelsOptions

Opciones para enumerar modelos.

Devoluciones

Un conjunto paginable de modelos application/json.

listRelationships(string, DigitalTwinsListRelationshipsOptionalParams)

Recupere las relaciones de un gemelo digital.

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital.

Devoluciones

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

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

Publique la telemetría desde el componente de un gemelo digital, que luego se consume en uno o varios puntos de conexión de destino (suscriptores) definidos en.

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital que se va a eliminar.

componentName

string

Nombre del componente DTDL.

payload

Record<string, unknown>

Carga de telemetría de application/json que se va a enviar.

messageId

string

Identificador del mensaje.

options
OperationOptions

Opciones de operación

Devoluciones

Promise<void>

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

Publique la telemetría desde un gemelo digital, que luego se consume en uno o varios puntos de conexión de destino (suscriptores) definidos en.

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital que se va a eliminar.

payload

Record<string, unknown>

Carga de telemetría de application/json que se va a enviar.

messageId

string

Identificador del mensaje.

options
OperationOptions

Opciones de operación

Devoluciones

Promise<void>

queryTwins(string, QueryQueryTwinsOptionalParams)

Consulta de gemelos digitales.

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

Parámetros

query

string

Cadena de consulta, en sintaxis similar a SQL.

options
QueryTwinsOptions

Opciones para la operación de consulta.

Devoluciones

Lista paginable de resultados de la consulta.

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

Actualice las propiedades de un componente de un gemelo digital mediante una revisión JSON.

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital.

componentName

string

Componente que se está actualizando.

jsonPatch

Record<string, unknown>[]

Las operaciones application/json-patch+json que se realizarán en el componente del gemelo digital especificado.

options
DigitalTwinsUpdateComponentOptionalParams

Opciones de operación extendidas, incluidas ifMatch: solo realice la operación si la etiqueta electrónica de la entidad coincide con una de las etag proporcionadas o *.

Devoluciones

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

Actualice un gemelo digital mediante una revisión json.

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital.

jsonPatch

Record<string, unknown>[]

Especificación de actualización descrita por revisión JSON. Las actualizaciones de los valores de propiedad y los elementos $model pueden producirse en la misma solicitud. Las operaciones se limitan a agregar, reemplazar y quitar.

options
DigitalTwinsUpdateOptionalParams

Opciones de operación extendidas, incluidas ifMatch: solo realice la operación si la etiqueta electrónica de la entidad coincide con una de las etag proporcionadas o *.

Devoluciones

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

Actualiza las propiedades de una relación en un gemelo digital mediante una revisión JSON.

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital que se va a eliminar.

relationshipId

string

Identificador de la relación que se va a actualizar.

jsonPatch

Record<string, unknown>[]

Las operaciones application/json-patch+json que se realizarán en la relación del gemelo digital especificado.

options
DigitalTwinsUpdateRelationshipOptionalParams

Opciones de operación extendidas ifMatch: realice solo la operación si la etag de la entidad coincide con una de las etag proporcionadas o * .

Devoluciones

upsertDigitalTwin(string, string, DigitalTwinsAddOptionalParams)

Creación o actualización de un gemelo digital

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital que se va a crear o actualizar.

digitalTwinJson

string

El gemelo digital application/json que se va a crear.

options
DigitalTwinsAddOptionalParams

Opciones de operación extendidas, como ifNoneMatch: realice solo la operación si la entidad aún no existe.

Devoluciones

La aplicación creada/gemelo digital json.

upsertEventRoute(string, string, string, OperationOptions)

Cree o actualice una ruta de eventos.

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

Parámetros

eventRouteId

string

Identificador de la ruta de eventos para crear o actualizar.

endpointId

string

El identificador del punto de conexión al que está enlazada esta ruta de evento.

filter

string

Expresión que describe los eventos que se enrutan al punto de conexión.

options
OperationOptions

Opciones de operación

Devoluciones

Promise<void>

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

Cree o actualice una relación en un gemelo digital.

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

Parámetros

digitalTwinId

string

Identificador del gemelo digital de origen.

relationshipId

string

Identificador de la relación que se va a crear.

relationship

Record<string, unknown>

Relación application/json que se va a crear.

options
DigitalTwinsAddRelationshipOptionalParams

Opciones de operación extendidas, como ifNoneMatch: realice solo la operación si la entidad aún no existe.

Devoluciones