Partager via


az dt twin telemetry

Remarque

Cette référence fait partie de l’extension azure-iot pour Azure CLI (version 2.46.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande de télémétrie de jumeau az dt. En savoir plus sur les extensions.

Testez et validez les itinéraires d’événements et les points de terminaison d’une instance Digital Twins.

Commandes

Nom Description Type Statut
az dt twin telemetry send

Envoie des données de télémétrie pour le compte d’un jumeau numérique. Si le chemin du composant est fourni, la télémétrie émise est au nom du composant.

Extension GA

az dt twin telemetry send

Envoie des données de télémétrie pour le compte d’un jumeau numérique. Si le chemin du composant est fourni, la télémétrie émise est au nom du composant.

az dt twin telemetry send --dt-name
                          --twin-id
                          [--component]
                          [--dt-id]
                          [--resource-group]
                          [--telemetry]
                          [--telemetry-source-time]

Exemples

Envoyer des données de télémétrie de jumeau

az dt twin telemetry send -n {instance_or_hostname} --twin-id {twin_id}

Envoyer des données de télémétrie de jumeau avec un horodatage et un identificateur de message personnalisés de la source de télémétrie

az dt twin telemetry send -n {instance_or_hostname} --twin-id {twin_id} --tst {telemetry_source_timestamp} --dt-id {dt_id}

Paramètres obligatoires

--dt-name --dtn -n

Nom d’instance Digital Twins ou nom d’hôte. Si un nom d’instance est fourni, l’abonnement utilisateur est interrogé pour la première fois pour que l’instance cible récupère le nom d’hôte. Si un nom d’hôte est fourni, la requête d’abonnement est ignorée et la valeur fournie est utilisée pour une interaction ultérieure.

--twin-id -t

ID de jumeau numérique.

Paramètres facultatifs

--component

Chemin d’accès au composant DTDL. Si elle est définie, les données de télémétrie sont émises pour le compte du composant.

--dt-id

Identificateur de message unique (dans l’étendue de l’ID de jumeau numérique) couramment utilisé pour dépliquer les messages. Si aucune valeur n’est fournie, un GUID est généré automatiquement.

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--telemetry

Json de télémétrie inline ou chemin d’accès au fichier de télémétrie JSON. La charge utile par défaut est un objet vide : {}.

--telemetry-source-time --tst

Horodatage RFC 3339 qui identifie l’heure à laquelle les données de télémétrie ont été mesurées.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.