Partager via


DigitalTwinsClient class

Client pour l’API Azure IoT DigitalTwins.

Constructeurs

DigitalTwinsClient(string, TokenCredential, DigitalTwinsClientOptions)

Crée une instance d’AzureDigitalTwinsAPI.

Exemple d’utilisation :

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éthodes

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

Créer un ou plusieurs

decomissionModel(string, OperationOptions)

Désaffectez un modèle à l’aide d’un correctif json. Lorsqu’un modèle est désactivé, de nouveaux jumeaux numériques ne pourront plus être définis par ce modèle. Toutefois, les jumeaux numériques existants peuvent continuer à utiliser ce modèle. Une fois qu’un modèle est désactivé, il se peut qu’il ne soit pas réaffecté.

deleteDigitalTwin(string, DigitalTwinsDeleteOptionalParams)

Supprimer un jumeau numérique

deleteEventRoute(string, OperationOptions)

Supprimez un itinéraire d’événement.

deleteModel(string, OperationOptions)

Supprimez un modèle.

deleteRelationship(string, string, DigitalTwinsDeleteRelationshipOptionalParams)

Supprimez une relation sur un jumeau numérique.

getComponent(string, string, OperationOptions)

Obtenir un composant sur un jumeau numérique.

getDigitalTwin(string, OperationOptions)

Obtenir un jumeau numérique

getEventRoute(string, OperationOptions)

Obtenir un itinéraire d’événement.

getModel(string, DigitalTwinModelsGetByIdOptionalParams)

Obtenez un modèle, y compris les métadonnées du modèle et la définition du modèle.

getRelationship(string, string, OperationOptions)

Obtenir une relation sur un jumeau numérique.

listEventRoutes(EventRoutesListOptionalParams)

Répertoriez les itinéraires d’événements dans une instance de jumeaux numériques.

listIncomingRelationships(string, DigitalTwinsListIncomingRelationshipsOptionalParams)

Récupérez toutes les relations entrantes pour un jumeau numérique.

listModels(DigitalTwinModelsListOptionalParams)

Obtenir la liste des modèles

listRelationships(string, DigitalTwinsListRelationshipsOptionalParams)

Récupérer des relations pour un jumeau numérique.

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

Publiez les données de télémétrie à partir du composant d’un jumeau numérique, qui est ensuite consommé par un ou plusieurs points de terminaison de destination (abonnés) définis sous.

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

Publiez les données de télémétrie à partir d’un jumeau numérique, qui est ensuite consommée par un ou plusieurs points de terminaison de destination (abonnés) définis sous.

queryTwins(string, QueryQueryTwinsOptionalParams)

Rechercher des jumeaux numériques.

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

Mettez à jour les propriétés d’un composant sur un jumeau numérique à l’aide d’un correctif JSON.

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

Mettez à jour un jumeau numérique à l’aide d’un correctif json.

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

Met à jour les propriétés d’une relation sur un jumeau numérique à l’aide d’un correctif JSON.

upsertDigitalTwin(string, string, DigitalTwinsAddOptionalParams)

Créer ou mettre à jour un jumeau numérique

upsertEventRoute(string, string, string, OperationOptions)

Créez ou mettez à jour un itinéraire d’événement.

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

Créez ou mettez à jour une relation sur un jumeau numérique.

Détails du constructeur

DigitalTwinsClient(string, TokenCredential, DigitalTwinsClientOptions)

Crée une instance d’AzureDigitalTwinsAPI.

Exemple d’utilisation :

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)

Paramètres

endpointUrl

string

URL du point de terminaison du service.

credential
TokenCredential

Utilisé pour authentifier les demandes auprès du service.

options
DigitalTwinsClientOptions

Utilisé pour configurer le client de service.

Détails de la méthode

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

Créer un ou plusieurs

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

Paramètres

dtdlModels

Record<string, unknown>[]

L’ensemble des modèles à créer. Chaque corde correspond exactement à un modèle.

options
OperationOptions

Options d’opération

Retours

Les modèles application/json créés.

decomissionModel(string, OperationOptions)

Désaffectez un modèle à l’aide d’un correctif json. Lorsqu’un modèle est désactivé, de nouveaux jumeaux numériques ne pourront plus être définis par ce modèle. Toutefois, les jumeaux numériques existants peuvent continuer à utiliser ce modèle. Une fois qu’un modèle est désactivé, il se peut qu’il ne soit pas réaffecté.

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

Paramètres

modelId

string

ID du modèle à désactiver. la propriété peut être remplacée.

options
OperationOptions

Options d’opération

Retours

Promise<void>

deleteDigitalTwin(string, DigitalTwinsDeleteOptionalParams)

Supprimer un jumeau numérique

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

Paramètres

digitalTwinId

string

ID du jumeau numérique à supprimer.

options
DigitalTwinsDeleteOptionalParams

Options d’opération étendues, notamment ifMatch : effectuez uniquement l’opération si l’etag de l’entité correspond à l’un des etags fournis ou * est fourni.

Retours

Promise<void>

deleteEventRoute(string, OperationOptions)

Supprimez un itinéraire d’événement.

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

Paramètres

eventRouteId

string

ID de l’eventRoute à supprimer.

options
OperationOptions

Options d’opération

Retours

Promise<void>

deleteModel(string, OperationOptions)

Supprimez un modèle.

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

Paramètres

modelId

string

ID du modèle à supprimer.

options
OperationOptions

Options d’opération

Retours

Promise<void>

deleteRelationship(string, string, DigitalTwinsDeleteRelationshipOptionalParams)

Supprimez une relation sur un jumeau numérique.

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

Paramètres

digitalTwinId

string

ID du jumeau numérique source.

relationshipId

string

ID de la relation à supprimer.

options
DigitalTwinsDeleteRelationshipOptionalParams

Options d’opération ifMatch : effectuez uniquement l’opération si l’etag de l’entité correspond à l’un des etags fournis ou * est

Retours

Promise<void>

getComponent(string, string, OperationOptions)

Obtenir un composant sur un jumeau numérique.

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

Paramètres

digitalTwinId

string

ID du jumeau numérique.

componentName

string

Composant récupéré.

options
OperationOptions

Options d’opération

Retours

Représentation sous forme de chaîne JSON du composant correspondant au componentName fourni.

getDigitalTwin(string, OperationOptions)

Obtenir un jumeau numérique

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

Paramètres

digitalTwinId

string

ID du jumeau numérique.

options
OperationOptions

Options d’opération

Retours

Le jumeau numérique application/json.

getEventRoute(string, OperationOptions)

Obtenir un itinéraire d’événement.

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

Paramètres

eventRouteId

string

options
OperationOptions

Options d’opération

Retours

Promise<EventRoute>

L’itinéraire de l’événement application/json.

getModel(string, DigitalTwinModelsGetByIdOptionalParams)

Obtenez un modèle, y compris les métadonnées du modèle et la définition du modèle.

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

Paramètres

modelId

string

ID du modèle.

options
GetModelOptions

Options pour cette opération

Retours

Le modèle application/json.

getRelationship(string, string, OperationOptions)

Obtenir une relation sur un jumeau numérique.

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

Paramètres

digitalTwinId

string

ID du jumeau numérique source.

relationshipId

string

ID de la relation à récupérer.

options
OperationOptions

Options d’opération

Retours

Liste paginable des relations application/json appartenant au jumeau numérique spécifié.

listEventRoutes(EventRoutesListOptionalParams)

Répertoriez les itinéraires d’événements dans une instance de jumeaux numériques.

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

Paramètres

options
ListEventRoutesOptions

Options pour listEventRoutes.

Retours

L’itinéraire de l’événement application/json.

listIncomingRelationships(string, DigitalTwinsListIncomingRelationshipsOptionalParams)

Récupérez toutes les relations entrantes pour un jumeau numérique.

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

Paramètres

digitalTwinId

string

ID du jumeau numérique.

Retours

listModels(DigitalTwinModelsListOptionalParams)

Obtenir la liste des modèles

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

Paramètres

options
ListModelsOptions

Options de référencement des modèles.

Retours

Un ensemble paginable de modèles application/json.

listRelationships(string, DigitalTwinsListRelationshipsOptionalParams)

Récupérer des relations pour un jumeau numérique.

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

Paramètres

digitalTwinId

string

ID du jumeau numérique.

Retours

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

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

Publiez les données de télémétrie à partir du composant d’un jumeau numérique, qui est ensuite consommé par un ou plusieurs points de terminaison de destination (abonnés) définis sous.

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

Paramètres

digitalTwinId

string

ID du jumeau numérique à supprimer.

componentName

string

Nom du composant DTDL.

payload

Record<string, unknown>

Charge utile de télémétrie application/json à envoyer.

messageId

string

ID du message.

options
OperationOptions

Options d’opération

Retours

Promise<void>

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

Publiez les données de télémétrie à partir d’un jumeau numérique, qui est ensuite consommée par un ou plusieurs points de terminaison de destination (abonnés) définis sous.

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

Paramètres

digitalTwinId

string

ID du jumeau numérique à supprimer.

payload

Record<string, unknown>

Charge utile de télémétrie application/json à envoyer.

messageId

string

ID du message.

options
OperationOptions

Options d’opération

Retours

Promise<void>

queryTwins(string, QueryQueryTwinsOptionalParams)

Rechercher des jumeaux numériques.

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

Paramètres

query

string

Chaîne de requête, dans la syntaxe de type SQL.

options
QueryTwinsOptions

Options pour l’opération de requête.

Retours

Liste paginable des résultats de la requête.

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

Mettez à jour les propriétés d’un composant sur un jumeau numérique à l’aide d’un correctif JSON.

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

Paramètres

digitalTwinId

string

ID du jumeau numérique.

componentName

string

Composant mis à jour.

jsonPatch

Record<string, unknown>[]

Opérations application/json-patch+json à effectuer sur le composant du jumeau numérique spécifié.

options
DigitalTwinsUpdateComponentOptionalParams

Options d’opération étendues, notamment ifMatch : effectuez uniquement l’opération si l’etag de l’entité correspond à l’un des etags fournis ou * est fourni.

Retours

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

Mettez à jour un jumeau numérique à l’aide d’un correctif json.

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

Paramètres

digitalTwinId

string

ID du jumeau numérique.

jsonPatch

Record<string, unknown>[]

Spécification de mise à jour décrite par JSON Patch. Les mises à jour apportées aux valeurs de propriété et $model éléments peuvent se produire dans la même requête. Les opérations sont limitées à l’ajout, au remplacement et à la suppression.

options
DigitalTwinsUpdateOptionalParams

Options d’opération étendues, notamment ifMatch : effectuez uniquement l’opération si l’etag de l’entité correspond à l’un des etags fournis ou * est fourni.

Retours

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

Met à jour les propriétés d’une relation sur un jumeau numérique à l’aide d’un correctif JSON.

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

Paramètres

digitalTwinId

string

ID du jumeau numérique à supprimer.

relationshipId

string

ID de la relation à mettre à jour.

jsonPatch

Record<string, unknown>[]

Opérations application/json-patch+json à effectuer sur la relation du jumeau numérique spécifié.

options
DigitalTwinsUpdateRelationshipOptionalParams

Options d’opération étendues ifMatch : effectuez uniquement l’opération si l’etag de l’entité correspond à l’un des etags fournis ou * est fourni.

Retours

upsertDigitalTwin(string, string, DigitalTwinsAddOptionalParams)

Créer ou mettre à jour un jumeau numérique

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

Paramètres

digitalTwinId

string

ID du jumeau numérique à créer ou à mettre à jour.

digitalTwinJson

string

Jumeau numérique application/json à créer.

options
DigitalTwinsAddOptionalParams

Options d’opération étendues, notamment ifNoneMatch : effectuez uniquement l’opération si l’entité n’existe pas déjà.

Retours

L’application/jumeau numérique json créé.

upsertEventRoute(string, string, string, OperationOptions)

Créez ou mettez à jour un itinéraire d’événement.

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

Paramètres

eventRouteId

string

ID de l’itinéraire d’événement à créer ou à mettre à jour.

endpointId

string

L’ID du point de terminaison à lequel cet itinéraire d’événements est lié.

filter

string

Expression qui décrit les événements qui sont routés vers le point de terminaison.

options
OperationOptions

Options d’opération

Retours

Promise<void>

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

Créez ou mettez à jour une relation sur un jumeau numérique.

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

Paramètres

digitalTwinId

string

ID du jumeau numérique source.

relationshipId

string

ID de la relation à créer.

relationship

Record<string, unknown>

Relation application/json à créer.

options
DigitalTwinsAddRelationshipOptionalParams

Options d’opération étendues, notamment ifNoneMatch : effectuez uniquement l’opération si l’entité n’existe pas déjà.

Retours