DigitalTwinsClient class
Client pour l’API Azure IoT DigitalTwins.
Constructeurs
| Digital |
Crée une instance d’AzureDigitalTwinsAPI. Exemple d’utilisation :
|
Méthodes
| create |
Créer un ou plusieurs |
| decomission |
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é. |
| delete |
Supprimer un jumeau numérique |
| delete |
Supprimez un itinéraire d’événement. |
| delete |
Supprimez un modèle. |
| delete |
Supprimez une relation sur un jumeau numérique. |
| get |
Obtenir un composant sur un jumeau numérique. |
| get |
Obtenir un jumeau numérique |
| get |
Obtenir un itinéraire d’événement. |
| get |
Obtenez un modèle, y compris les métadonnées du modèle et la définition du modèle. |
| get |
Obtenir une relation sur un jumeau numérique. |
| list |
Répertoriez les itinéraires d’événements dans une instance de jumeaux numériques. |
| list |
Récupérez toutes les relations entrantes pour un jumeau numérique. |
| list |
Obtenir la liste des modèles |
| list |
Récupérer des relations pour un jumeau numérique. |
| publish |
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. |
| publish |
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. |
| query |
Rechercher des jumeaux numériques. |
| update |
Mettez à jour les propriétés d’un composant sur un jumeau numérique à l’aide d’un correctif JSON. |
| update |
Mettez à jour un jumeau numérique à l’aide d’un correctif json. |
| update |
Met à jour les propriétés d’une relation sur un jumeau numérique à l’aide d’un correctif JSON. |
| upsert |
Créer ou mettre à jour un jumeau numérique |
| upsert |
Créez ou mettez à jour un itinéraire d’événement. |
| upsert |
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
Promise<DigitalTwinModelsAddResponse>
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 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
Promise<DigitalTwinsGetComponentResponse>
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
Promise<DigitalTwinsGetByIdResponse>
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
Promise<DigitalTwinsModelData>
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.
- options
- ListIncomingRelationshipsOptions
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.
- options
- ListRelationshipsOptions
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
PagedAsyncIterableIterator<Record<string, unknown>, QueryQueryTwinsResponse, PageSettings>
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 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<DigitalTwinsUpdateComponentHeaders>
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
Promise<DigitalTwinsUpdateHeaders>
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 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
Promise<DigitalTwinsAddResponse>
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 d’opération étendues, notamment ifNoneMatch : effectuez uniquement l’opération si l’entité n’existe pas déjà.
Retours
Promise<DigitalTwinsAddRelationshipResponse>