Documentation sur Oracle Cloud Infrastructure

Mise à jour d'un adaptateur 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. Si vous voulez ajouter une nouvelle valeur, vous devez créer un nouvel adaptateur jumeau numérique et associer l'OCID du nouvel adaptateur jumeau numérique à l'instance avec laquelle vous voulez travailler, vous pouvez le faire lorsque vous créez une instance de jumeau numérique ou mettez à jour une instance de jumeau numérique.

Pour des scénarios particuliers avec adaptateurs jumeaux numériques, voir :

Options d'adaptateur Digital Twin

  • Lors de la mise à jour ou de la recréation d'un adaptateur jumeau numérique : Utilisez la mise à jour pour les métadonnées, notamment display-name, description, tags si ces options ont été incluses initialement lors de la création de l'adaptateur jumeau numérique. Pour les modifications de logique de mappage dans envelope-mapping ou inbound-routes, créez un nouvel 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 de l'adaptateur : Il peut être null ou vide.
  • Les routes entrantes doivent avoir un format JSON valide : Les valeurs ${...} non indiqué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 des routes entrantes : Le nombre maximal de routes entrantes est de 128.
  • Citation de l'interface de ligne de commande sous Windows : Selon le système d'exploitation ou l'application avec lequel vous travaillez, les paramètres de chaîne, les guillemets et les espaces peuvent causer des problèmes. Évitez d'utiliser des guillemets qui entraînent des arguments supplémentaires inattendus et évitez également d'utiliser des espaces. Par exemple, pour entrer des paramètres d'interface de ligne de commande OCI, utilisez ce qui suit :

    --description your-description

Note

L'interface de ligne de commande OCI utilise des mots séparés par des tirets pour les définitions d'adaptateur jumeau numérique. L'API utilise la notation camelCase. Par exemple, lors de l'utilisation des commandes oci cli envelope-mapping utilisées pour l'interface de ligne de commande OCI devient envelopeMapping lors de l'utilisation de la trousse SDK Python IoT ou de l'API IoT.
  • Utilisez l'option de mise à jour pour mettre à jour la valeur d'une option d'adaptateur jumeau numérique IoT existante.
    1. Dans la page de liste Domaines, sélectionnez le domaine avec lequel vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste des domaines IoT ou un domaine IoT, voir Liste des domaines IoT.
    2. Sélectionnez l'onglet Adaptateurs jumeaux numériques.
    3. Sélectionnez le nom de l'adaptateur jumeau numérique. Sélectionnez Modifier pour mettre à jour le nom, la description ou pour modifier ou charger un nouveau fichier .json avec le contenu de l'enveloppe entrante ou des conditions de routage entrant pour cet adaptateur.
    4. Sélectionnez Non spécifié pour supprimer l'enveloppe entrante de l'adaptateur jumeau numérique ou la spécification de route entrante.
    5. Sélectionnez Mettre à jour.

      Dans la liste Adaptateur jumeau numérique, sélectionnez le menu Actions à la fin de la rangée, pour supprimer, gérer les marqueurs 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 marqueurs à structure libre, les marqueurs définis 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 les utilisations Mac ou Linux : file:///inbound-routes.json pour plus d'informations, voir

    Pour mettre à jour les routes entrantes d'un adaptateur 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'enveloppe entrante d'un adaptateur 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 marqueurs à structure libre d'un adaptateur jumeau numérique, vous pouvez définir des paires clé-valeur comme dans cet exemple, ou un chemin vers un fichier tel que tags.json comme dans l'exemple suivant ci-dessous : 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --freeform-tags '{"<key>": "<value>"}'
    Pour plus d'informations, voir Présentation des marqueurs à structure libre.
    Pour mettre à jour les marqueurs définis d'un adaptateur jumeau numérique, utilisez un fichier .json pour définir les marqueurs 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, voir Utilisation des marqueurs définis.
    Pour mettre à jour le nom d'affichage d'un adaptateur jumeau numérique : 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --display-name "<updated-display-name>"

    Pour la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commande, voir Informations de référence sur les commandes de l'interface de ligne de commande.

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