DigitalTwinsClient class
Cliente para azure IoT DigitalTwins API.
Constructores
| Digital |
Crea una instancia de AzureDigitalTwinsAPI. Uso de ejemplo:
|
Métodos
| create |
Crear uno o varios |
| decomission |
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. |
| delete |
Eliminación de un gemelo digital |
| delete |
Elimine una ruta de eventos. |
| delete |
Eliminar un modelo. |
| delete |
Elimina una relación en un gemelo digital. |
| get |
Obtenga un componente en un gemelo digital. |
| get |
Obtención de un gemelo digital |
| get |
Obtener una ruta de eventos. |
| get |
Obtenga un modelo, incluidos los metadatos del modelo y la definición del modelo. |
| get |
Obtener una relación en un gemelo digital. |
| list |
Enumere las rutas de eventos en una instancia de gemelos digitales. |
| list |
Recupere todas las relaciones entrantes de un gemelo digital. |
| list |
Obtener la lista de modelos |
| list |
Recupere las relaciones de un gemelo digital. |
| publish |
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. |
| publish |
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. |
| query |
Consulta de gemelos digitales. |
| update |
Actualice las propiedades de un componente de un gemelo digital mediante una revisión JSON. |
| update |
Actualice un gemelo digital mediante una revisión json. |
| update |
Actualiza las propiedades de una relación en un gemelo digital mediante una revisión JSON. |
| upsert |
Creación o actualización de un gemelo digital |
| upsert |
Cree o actualice una ruta de eventos. |
| upsert |
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
Promise<DigitalTwinModelsAddResponse>
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.
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
Promise<DigitalTwinsGetComponentResponse>
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
Promise<DigitalTwinsGetByIdResponse>
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
Promise<DigitalTwinsModelData>
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.
- options
- ListIncomingRelationshipsOptions
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.
- options
- ListRelationshipsOptions
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
PagedAsyncIterableIterator<Record<string, unknown>, QueryQueryTwinsResponse, PageSettings>
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.
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<DigitalTwinsUpdateComponentHeaders>
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
Promise<DigitalTwinsUpdateHeaders>
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.
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
Promise<DigitalTwinsAddResponse>
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.
Opciones de operación extendidas, como ifNoneMatch: realice solo la operación si la entidad aún no existe.
Devoluciones
Promise<DigitalTwinsAddRelationshipResponse>