Documentation Oracle Cloud Infrastructure

Mise à jour d'un adaptateur de jumeau numérique

Mettez à jour l'adaptateur jumeau numérique pour votre Internet of Things (IoT).

Lorsque vous mettez à jour une option existante appliquée à un adaptateur jumeau numérique, vous modifiez uniquement la valeur que vous n'ajoutez pas de nouvelle valeur à l'adaptateur jumeau numérique à l'aide de cette option de mise à jour. Pour ajouter une valeur, vous devez créer un nouvel adaptateur de jumeau numérique et associer l'OCID du nouvel adaptateur de jumeau numérique à l'instance de jumeau numérique avec laquelle vous voulez travailler, vous pouvez le faire lorsque vous créez une instance de jumeau numérique ou que vous mettez à jour une instance de jumeau numérique.

Pour des scénarios spécifiques avec des adaptateurs jumeaux numériques, reportez-vous aux sections suivantes :

Options d'adaptateur de jumeau numérique

  • Quand mettre à jour ou recréer un adaptateur jumeau numérique : utilisez la mise à jour pour les métadonnées, notamment display-name, description et tags si ces options ont été incluses initialement lors de la création de l'adaptateur jumeau numérique. Pour mettre en correspondance les modifications de logique dans un élément envelope-mapping ou inbound-routes, créez un adaptateur.
  • Meilleures pratiques pour les mises à jour d'adaptateur : appliquez les mises à jour dans un nouvel adaptateur, associez-les à votre instance de jumeau numérique de test, postez un exemple de télémétrie, vérifiez les réponses 202 et les valeurs en aval, puis associez l'instance de jumeau numérique de production au nouvel adaptateur.
  • Valeurs d'adaptateur : null ou vide.
  • Inbound-routes doit être un format JSON valide : les valeurs ${...} non citées ne sont pas prises en charge et seront rejetées. Les expressions JQ doivent se trouver dans des chaînes entre guillemets, par exemple, "${(.velocity_kph / 1.609) | floor}"
  • Limites sur les routes entrantes : le nombre maximal de routes entrantes est de 128.
  • Création de devis à l'aide de la CLI sous Windows : selon le système d'exploitation ou l'application que vous utilisez, les paramètres de chaîne, les guillemets et les espaces peuvent entraîner des problèmes. Evitez d'utiliser des guillemets qui entraînent des arguments supplémentaires inattendus et évitez également d'utiliser des espaces. Par exemple, pour entrer les paramètres de l'interface de ligne de commande OCI, utilisez ce qui suit :

    --description your-description

Remarque

L'interface de ligne de commande OCI utilise des mots séparés par des traits d'union pour les définitions d'adaptateur jumeau numérique. L'API utilise la notation camelCase. Par exemple, lorsque vous utilisez les commandes oci cli, envelope-mapping utilisées pour l'interface de ligne de commande OCI devient envelopeMapping lorsque vous utilisez le kit SDK IoT Python ou l'API IoT.
  • Utilisez l'option de mise à jour pour mettre à jour la valeur d'une option d'adaptateur de jumeau numérique IoT existante.
    1. Sur la page de liste Domaines, sélectionnez le domaine avec lequel vous souhaitez travailler. Si vous avez besoin d'aide pour trouver la page de liste des domaines IoT ou un domaine IoT, reportez-vous à Liste des domaines IoT.
    2. Sélectionnez l'onglet Digital Twin Adapter.
    3. Sélectionnez le nom du jumeau numérique. Sélectionnez Modifier pour mettre à jour le nom, la description, ou pour modifier ou télécharger un nouveau fichier .json avec le contenu de l'enveloppe entrante ou des conditions de routage entrantes pour cet adaptateur.
    4. Sélectionnez Non spécifié pour supprimer l'enveloppe entrante ou la spécification d'itinéraire entrant de l'adaptateur jumeau numérique.
    5. Sélectionnez Mettre à jour.

      Dans la liste Digital Twin Adapter, sélectionnez le menu Actions à la fin de la ligne, pour supprimer, gérer les balises ou copier son OCID.

  • Utilisez la commande oci iot digital-twin-adapter update et les paramètres requis pour mettre à jour un adaptateur jumeau numérique. Vous pouvez mettre à jour la description, les balises à format libre, les balises définies ou le nom d'affichage d'un adaptateur jumeau numérique. Selon votre système d'exploitation, vous pouvez avoir besoin d'un nombre différent de barres obliques, par exemple sur Mac ou Linux utilise : file:///inbound-routes.json pour plus d'informations, voir

    Pour mettre à jour les routes entrantes d'un jumeau numérique : 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --inbound-routes file://inbound-routes.json
    Pour mettre à jour le mappage d'enveloppes entrantes d'un jumeau numérique : 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --inbound-envelop file://inbound-envelop.json
    Pour mettre à jour la description d'un adaptateur jumeau numérique : 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --description "<updated-description>"
    Pour mettre à jour les balises de format libre d'un adaptateur jumeau numérique, vous pouvez définir des paires de valeurs de clé comme dans cet exemple, ou un chemin vers un fichier tel que tags.json, comme dans l'exemple suivant : 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --freeform-tags '{"<key>": "<value>"}'
    Pour plus d'informations, reportez-vous à Présentation des balises à format libre.
    Pour mettre à jour les balises définies d'un adaptateur jumeau numérique, utilisez un fichier .json pour définir les balises et incluez un chemin tel que le fichier tags.json comme dans l'exemple :
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --defined-tags file://tags.json
    Pour plus d'informations, reportez-vous à Utilisation des balises définies.
    Pour mettre à jour le nom d'affichage d'un jumeau numérique : 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --display-name "<updated-display-name>"

    Pour obtenir la liste complète des paramètres et des valeurs des commandes de la CLI, reportez-vous à Référence des commandes de la CLI.

  • Exécutez l'opération UpdateDigitalTwinAdapter pour mettre à jour l'adaptateur jumeau numérique.