DigitalTwinsClient class
Cliente para a API do Azure IoT DigitalTwins.
Construtores
| Digital |
Cria uma instância de AzureDigitalTwinsAPI. Exemplo de uso:
|
Métodos
| create |
Criar um ou vários |
| decomission |
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. |
| delete |
Excluir um gêmeo digital |
| delete |
Exclua uma rota de evento. |
| delete |
Exclua um modelo. |
| delete |
Excluir um relacionamento em um gêmeo digital. |
| get |
Obtenha um componente em um gêmeo digital. |
| get |
Obtenha um gémeo digital |
| get |
Obtenha uma rota para o evento. |
| get |
Obtenha um modelo, incluindo os metadados do modelo e a definição do modelo. |
| get |
Tenha um relacionamento em um gêmeo digital. |
| list |
Liste as rotas de evento em uma instância de gêmeos digitais. |
| list |
Recupere todos os relacionamentos de entrada para um gêmeo digital. |
| list |
Obter a lista de modelos |
| list |
Recupere relacionamentos para um gêmeo digital. |
| publish |
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. |
| publish |
Publique a telemetria de um gêmeo digital, que é consumida por um ou vários pontos de extremidade de destino (assinantes) definidos em. |
| query |
Consulta de gêmeos digitais. |
| update |
Atualize as propriedades de um componente em um gêmeo digital usando um patch JSON. |
| update |
Atualize um gêmeo digital usando um patch json. |
| update |
Atualiza as propriedades de um relacionamento em um gêmeo digital usando um patch JSON. |
| upsert |
Criar ou atualizar um gêmeo digital |
| upsert |
Crie ou atualize uma rota de evento. |
| upsert |
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
Promise<DigitalTwinModelsAddResponse>
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.
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
Promise<DigitalTwinsGetComponentResponse>
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
Promise<DigitalTwinsGetByIdResponse>
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
Promise<DigitalTwinsModelData>
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.
- options
- ListIncomingRelationshipsOptions
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.
- options
- ListRelationshipsOptions
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
PagedAsyncIterableIterator<Record<string, unknown>, QueryQueryTwinsResponse, PageSettings>
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.
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<DigitalTwinsUpdateComponentHeaders>
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
Promise<DigitalTwinsUpdateHeaders>
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.
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
Promise<DigitalTwinsAddResponse>
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.
Opções de operação estendida, incluindo ifNoneMatch: execute a operação somente se a entidade ainda não existir.
Devoluções
Promise<DigitalTwinsAddRelationshipResponse>