Partilhar via


DigitalTwinsClient class

Cliente para a API do Azure IoT DigitalTwins.

Construtores

DigitalTwinsClient(string, TokenCredential, DigitalTwinsClientOptions)

Cria uma instância de AzureDigitalTwinsAPI.

Exemplo de uso:

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)

Criar um ou vários

decomissionModel(string, OperationOptions)

Descomissione um modelo usando um patch json. Quando um modelo é desativado, novos gêmeos digitais não poderão mais ser definidos por esse modelo. No entanto, os gémeos digitais existentes podem continuar a utilizar este modelo. Uma vez que um modelo é desativado, ele não pode ser recomissionado.

deleteDigitalTwin(string, DigitalTwinsDeleteOptionalParams)

Excluir um gêmeo digital

deleteEventRoute(string, OperationOptions)

Exclua uma rota de evento.

deleteModel(string, OperationOptions)

Exclua um modelo.

deleteRelationship(string, string, DigitalTwinsDeleteRelationshipOptionalParams)

Excluir um relacionamento em um gêmeo digital.

getComponent(string, string, OperationOptions)

Obtenha um componente em um gêmeo digital.

getDigitalTwin(string, OperationOptions)

Obtenha um gémeo digital

getEventRoute(string, OperationOptions)

Obtenha uma rota para o evento.

getModel(string, DigitalTwinModelsGetByIdOptionalParams)

Obtenha um modelo, incluindo os metadados do modelo e a definição do modelo.

getRelationship(string, string, OperationOptions)

Tenha um relacionamento em um gêmeo digital.

listEventRoutes(EventRoutesListOptionalParams)

Liste as rotas de evento em uma instância de gêmeos digitais.

listIncomingRelationships(string, DigitalTwinsListIncomingRelationshipsOptionalParams)

Recupere todos os relacionamentos de entrada para um gêmeo digital.

listModels(DigitalTwinModelsListOptionalParams)

Obter a lista de modelos

listRelationships(string, DigitalTwinsListRelationshipsOptionalParams)

Recupere relacionamentos para um gêmeo digital.

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

Publique a telemetria do componente de um gêmeo digital, que é consumida por um ou vários pontos de extremidade de destino (assinantes) definidos em.

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

Publique a telemetria de um gêmeo digital, que é consumida por um ou vários pontos de extremidade de destino (assinantes) definidos em.

queryTwins(string, QueryQueryTwinsOptionalParams)

Consulta de gêmeos digitais.

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

Atualize as propriedades de um componente em um gêmeo digital usando um patch JSON.

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

Atualize um gêmeo digital usando um patch json.

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

Atualiza as propriedades de um relacionamento em um gêmeo digital usando um patch JSON.

upsertDigitalTwin(string, string, DigitalTwinsAddOptionalParams)

Criar ou atualizar um gêmeo digital

upsertEventRoute(string, string, string, OperationOptions)

Crie ou atualize uma rota de evento.

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

Crie ou atualize um relacionamento em um gêmeo digital.

Detalhes do Construtor

DigitalTwinsClient(string, TokenCredential, DigitalTwinsClientOptions)

Cria uma instância de AzureDigitalTwinsAPI.

Exemplo de uso:

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

A URL do ponto de extremidade do serviço.

credential
TokenCredential

Usado para autenticar solicitações para o serviço.

options
DigitalTwinsClientOptions

Usado para configurar o cliente de serviço.

Detalhes de Método

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

Criar um ou vários

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

Parâmetros

dtdlModels

Record<string, unknown>[]

O conjunto de modelos a criar. Cada string corresponde exatamente a um modelo.

options
OperationOptions

As opções de operação

Devoluções

Os modelos application/json criados.

decomissionModel(string, OperationOptions)

Descomissione um modelo usando um patch json. Quando um modelo é desativado, novos gêmeos digitais não poderão mais ser definidos por esse modelo. No entanto, os gémeos digitais existentes podem continuar a utilizar este modelo. Uma vez que um modelo é desativado, ele não pode ser recomissionado.

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

Parâmetros

modelId

string

O Id do modelo a descomissionar. propriedade pode ser substituída.

options
OperationOptions

As opções de operação

Devoluções

Promise<void>

deleteDigitalTwin(string, DigitalTwinsDeleteOptionalParams)

Excluir um gêmeo digital

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital a ser excluído.

options
DigitalTwinsDeleteOptionalParams

Opções de operação estendidas, incluindo ifMatch: Execute a operação somente se o etag da entidade corresponder a um dos etags fornecidos ou se * for fornecido.

Devoluções

Promise<void>

deleteEventRoute(string, OperationOptions)

Exclua uma rota de evento.

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

Parâmetros

eventRouteId

string

O Id do eventRoute a ser excluído.

options
OperationOptions

As opções de operação

Devoluções

Promise<void>

deleteModel(string, OperationOptions)

Exclua um modelo.

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

Parâmetros

modelId

string

O Id do modelo a ser excluído.

options
OperationOptions

As opções de operação

Devoluções

Promise<void>

deleteRelationship(string, string, DigitalTwinsDeleteRelationshipOptionalParams)

Excluir um relacionamento em um gêmeo digital.

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital de origem.

relationshipId

string

O Id da relação a ser excluída.

options
DigitalTwinsDeleteRelationshipOptionalParams

As opções de operação ifMatch: Só execute a operação se o etag da entidade corresponder a um dos etags fornecidos ou se * for

Devoluções

Promise<void>

getComponent(string, string, OperationOptions)

Obtenha um componente em um gêmeo digital.

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital.

componentName

string

O componente que está sendo recuperado.

options
OperationOptions

As opções de operação

Devoluções

Representação da cadeia de caracteres Json do componente correspondente ao componentName fornecido.

getDigitalTwin(string, OperationOptions)

Obtenha um gémeo digital

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital.

options
OperationOptions

As opções de operação

Devoluções

O gêmeo digital application/json.

getEventRoute(string, OperationOptions)

Obtenha uma rota para o evento.

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

Parâmetros

eventRouteId

string

options
OperationOptions

As opções de operação

Devoluções

Promise<EventRoute>

A rota do evento application/json.

getModel(string, DigitalTwinModelsGetByIdOptionalParams)

Obtenha um modelo, incluindo os metadados do modelo e a definição do modelo.

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

Parâmetros

modelId

string

O Id do modelo.

options
GetModelOptions

Opções para esta operação

Devoluções

O modelo application/json.

getRelationship(string, string, OperationOptions)

Tenha um relacionamento em um gêmeo digital.

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital de origem.

relationshipId

string

O Id da relação a ser recuperada.

options
OperationOptions

As opções de operação

Devoluções

A lista paginável de relações application/json pertencentes ao gêmeo digital especificado.

listEventRoutes(EventRoutesListOptionalParams)

Liste as rotas de evento em uma instância de gêmeos digitais.

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

Parâmetros

options
ListEventRoutesOptions

Opções para listEventRoutes.

Devoluções

A rota do evento application/json.

listIncomingRelationships(string, DigitalTwinsListIncomingRelationshipsOptionalParams)

Recupere todos os relacionamentos de entrada para um gêmeo digital.

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital.

Devoluções

listModels(DigitalTwinModelsListOptionalParams)

Obter a lista de modelos

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

Parâmetros

options
ListModelsOptions

Opções para listar modelos.

Devoluções

Um conjunto paginável de modelos application/json.

listRelationships(string, DigitalTwinsListRelationshipsOptionalParams)

Recupere relacionamentos para um gêmeo digital.

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital.

Devoluções

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

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

Publique a telemetria do componente de um gêmeo digital, que é consumida por um ou vários pontos de extremidade de destino (assinantes) definidos em.

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital a ser excluído.

componentName

string

O nome do componente DTDL.

payload

Record<string, unknown>

A carga útil de telemetria application/json a ser enviada.

messageId

string

A mensagem Id.

options
OperationOptions

As opções de operação

Devoluções

Promise<void>

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

Publique a telemetria de um gêmeo digital, que é consumida por um ou vários pontos de extremidade de destino (assinantes) definidos em.

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital a ser excluído.

payload

Record<string, unknown>

A carga útil de telemetria application/json a ser enviada.

messageId

string

A mensagem Id.

options
OperationOptions

As opções de operação

Devoluções

Promise<void>

queryTwins(string, QueryQueryTwinsOptionalParams)

Consulta de gêmeos digitais.

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

Parâmetros

query

string

A cadeia de caracteres de consulta, em sintaxe semelhante a SQL.

options
QueryTwinsOptions

Opções para a operação de consulta.

Devoluções

A lista paginável de resultados da consulta.

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

Atualize as propriedades de um componente em um gêmeo digital usando um patch JSON.

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital.

componentName

string

O componente que está sendo atualizado.

jsonPatch

Record<string, unknown>[]

As operações application/json-patch+json a serem executadas no componente do gêmeo digital especificado.

options
DigitalTwinsUpdateComponentOptionalParams

Opções de operação estendidas, incluindo ifMatch: Execute a operação somente se o etag da entidade corresponder a um dos etags fornecidos ou se * for fornecido.

Devoluções

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

Atualize um gêmeo digital usando um patch json.

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital.

jsonPatch

Record<string, unknown>[]

Uma especificação de atualização descrita pelo JSON Patch. Atualizações de valores de propriedade e elementos $model podem ocorrer na mesma solicitação. As operações são limitadas para adicionar, substituir e remover.

options
DigitalTwinsUpdateOptionalParams

Opções de operação estendidas, incluindo ifMatch: Execute a operação somente se o etag da entidade corresponder a um dos etags fornecidos ou se * for fornecido.

Devoluções

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

Atualiza as propriedades de um relacionamento em um gêmeo digital usando um patch JSON.

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital a ser excluído.

relationshipId

string

O Id da relação a ser atualizada.

jsonPatch

Record<string, unknown>[]

As operações application/json-patch+json a serem executadas na relação do gêmeo digital especificado.

options
DigitalTwinsUpdateRelationshipOptionalParams

Opções de operação estendidas ifMatch: Execute a operação somente se o etag da entidade corresponder a um dos etags fornecidos ou se * for fornecido.

Devoluções

upsertDigitalTwin(string, string, DigitalTwinsAddOptionalParams)

Criar ou atualizar um gêmeo digital

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital a ser criado ou atualizado.

digitalTwinJson

string

O aplicativo/json gêmeo digital para criar.

options
DigitalTwinsAddOptionalParams

Opções de operação estendida, incluindo ifNoneMatch: execute a operação somente se a entidade ainda não existir.

Devoluções

O aplicativo criado/gêmeo digital json.

upsertEventRoute(string, string, string, OperationOptions)

Crie ou atualize uma rota de evento.

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

Parâmetros

eventRouteId

string

O Id da rota do evento a ser criado ou atualizado.

endpointId

string

A id do ponto de extremidade ao qual essa rota de evento está vinculada.

filter

string

Uma expressão que descreve os eventos que são roteados para o ponto de extremidade.

options
OperationOptions

As opções de operação

Devoluções

Promise<void>

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

Crie ou atualize um relacionamento em um gêmeo digital.

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

Parâmetros

digitalTwinId

string

O Id do gêmeo digital de origem.

relationshipId

string

O Id da relação a criar.

relationship

Record<string, unknown>

A relação application/json a ser criada.

options
DigitalTwinsAddRelationshipOptionalParams

Opções de operação estendida, incluindo ifNoneMatch: execute a operação somente se a entidade ainda não existir.

Devoluções