Mise à jour d'une instance de jumeau numérique
Mettez à jour l'ID d'adaptateur, l'ID de modèle, l'URI de spécification de modèle, l'ID d'authentification, la clé externe, la description, les balises ou le nom d'affichage d'une instance de jumeau numérique pour votre Internet of Things (IoT).
Lorsque vous mettez à jour une option existante appliquée à une instance de jumeau numérique, vous ne pouvez modifier que la valeur que vous ne pouvez pas ajouter à l'instance de jumeau numérique à l'aide de cette option de mise à jour. Si vous n'avez pas inclus le paramètre à mettre à jour lors de la création de l'instance de jumeau numérique, vous ne pouvez pas mettre à jour la valeur. A la place, créez une nouvelle instance de jumeau numérique pour ajouter un nouveau paramètre.
Par exemple, si vous créez une instance de jumeau numérique sans paramètre d'authentification pour le test, vous devez créer une instance de jumeau numérique avec le paramètre d'authentification lorsque vous voulez envoyer ou recevoir des données de l'instance de jumeau numérique. Si l'instance de jumeau numérique a été créée avec un ID d'authentification, vous pouvez mettre à jour cet ID.
- Utilisez l'option de mise à jour pour mettre à jour la valeur d'une option d'instance de jumeau numérique IoT existante.
- 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.
- Sélectionnez l'onglet Instances de jumeaux numériques.
- Sélectionnez le nom d'instance de jumeau numérique. Sélectionnez l'option Modifier à mettre à jour :
- Mettez à jour le nom, la description ou la clé externe afin d'éviter de saisir des informations confidentielles.
- Modifiez le type :
- Connecté directement : connectez un appareil ou une entité directement au domaine IoT. Si le périphérique ou l'entité envoie des données structurées, activez la bascule pour Sélectionner un adaptateur. La sélection d'un adaptateur associe cette instance de jumeau numérique à une couche de transformation à l'aide d'une enveloppe entrante et de routages entrants afin de convertir les charges utiles d'appareil entrant en structure de spécification DTDL du modèle de jumeau numérique associé attendue par l'instance. Si vous ne voyez pas d'adaptateur à sélectionner dans la liste, créez un adaptateur.
Facultatif. Si le périphérique ou l'entité envoie ou reçoit des données, vous devez sélectionner un ID d'authentification. Utilisez un secret avec authentification de base uniquement pour les tests, pour les environnements sécurisés ou de production, utilisez un certificat mTLS. Vous pouvez sélectionner l'ID d'authentification ou coller l'OCID d'authentification.
- Non connecté : utilisez cette option pour créer une instance de jumeau numérique de simulation uniquement sans ingestion de données. Un modèle jumeau numérique est requis et ne doit pas contenir de télémétrie ou de propriétés. Sélectionnez le modèle dans la liste ou sélectionnez-le en saisissant le DTMI. Après avoir créé cette instance de jumeau numérique, vous pouvez ajouter des relations de jumeau numérique pour simuler votre environnement IoT sans la complexité de l'ingestion ou de l'authentification des données.
- Connecté directement : connectez un appareil ou une entité directement au domaine IoT. Si le périphérique ou l'entité envoie des données structurées, activez la bascule pour Sélectionner un adaptateur. La sélection d'un adaptateur associe cette instance de jumeau numérique à une couche de transformation à l'aide d'une enveloppe entrante et de routages entrants afin de convertir les charges utiles d'appareil entrant en structure de spécification DTDL du modèle de jumeau numérique associé attendue par l'instance. Si vous ne voyez pas d'adaptateur à sélectionner dans la liste, créez un adaptateur.
- Sélectionnez Mettre à jour.
- Données : sélectionnez cette option pour visualiser les dernières données de cliché pour l'instance de jumeau numérique.Dans la liste Instance de jumeau numérique, sélectionnez le menu Actions à la fin de la ligne pour supprimer, gérer les balises ou copier son OCID.
Si vous n'incluez pas la clé externe, elle est générée.
Utilisez la commande oci iot digital-twin-instance update et le paramètre requis pour mettre à jour le paramètre existant d'une instance de jumeau numérique.
Par exemple, utilisez cette commande pour mettre à jour la clé externe d'une instance de jumeau numérique. Evitez de citer des problèmes en n'utilisant pas de guillemets avec une valeur de clé externe. Vous pouvez remplacer
<your-device-id>par un numéro de série, une adresse MAC ou un nom de périphérique en tant que clé externe pour associer le périphérique à l'instance de jumeau numérique :oci iot digital-twin-instance update --digital-twin-instance-id <digital-twin-instance-OCID> --external-key <your-device-id>Utilisez cette commande et le paramètre
<digital-twin-instance-OCID>requis pour mettre à jour le paramètre d'authentification facultatif pour une instance de jumeau numérique. Mettez à jour la valeur avec la clé secrète ou l'OCID de certificat. Il s'agit du mot de passe de l'appareil lorsque vous envoyez des données à l'appareil :oci iot digital-twin-instance update --digital-twin-instance-id <digital-twin-instance-OCID> --auth "<updated-auth-ocid>"Pour obtenir la liste complète des paramètres d'instance de jumeau numérique, reportez-vous à OCI iot digital-twin-instance update et pour obtenir la liste complète de toutes les commandes de l'interface de ligne de commande OCI, reportez-vous à Référence des commandes de l'interface de ligne de commande.
Exécutez l'opération UpdateDigitalTwinInstance pour mettre à jour une instance de jumeau numérique.