Mise à jour d'une instance de jumeau numérique
Mettez à jour l'ID adaptateur, l'ID modèle, l'URI de spécification de modèle, l'ID authentification, la clé externe, la description, les marqueurs ou un nom d'affichage pour votre Internet of Things (IoT).
Lorsque vous mettez à jour une option existante appliquée à une instance de jumeau numérique, vous modifiez uniquement la valeur que vous ne pouvez pas ajouter de nouvelle valeur à 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. À 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 à des fins de test, vous devez créer une nouvelle 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 authentification, vous pouvez mettre à jour l'ID authentification.
- Utilisez l'option de mise à jour pour mettre à jour la valeur d'une instance de jumeau numérique IdO existante.
- 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.
- Sélectionnez l'onglet Instances jumeaux numériques.
- Sélectionnez le nom de l'instance du jumeau numérique. Sélectionnez Modifier à mettre à jour :
- Mettez à jour le nom, la description ou la clé externe pour éviter d'entrer des informations confidentielles.
- Modifiez le type :
- Connexion directe : Connectez un appareil ou une entité directement au domaine IdO. Si l'appareil ou l'entité envoie des données structurées, activez l'option 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 routes entrantes pour convertir les données utiles de l'appareil entrant dans la 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.
Facultative. Si l'appareil ou l'entité envoie ou reçoit des données, vous devez sélectionner un ID authentification. Utilisez une clé secrète avec l'authentification de base uniquement à des fins de test, pour les environnements sécurisés ou de production, utilisez un certificat mTLS. Vous pouvez sélectionner l'ID authentification ou coller l'OCID de l'authentification.
- Non connecté : Utilisez cette option pour créer une instance de jumeau numérique réservée à la simulation 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 entrant DTMI. Après avoir créé cette instance de jumeau numérique, vous pouvez ajouter des relations de jumeau numérique pour simuler votre environnement IdO sans la complexité de l'ingestion ou de l'authentification de données.
- Connexion directe : Connectez un appareil ou une entité directement au domaine IdO. Si l'appareil ou l'entité envoie des données structurées, activez l'option 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 routes entrantes pour convertir les données utiles de l'appareil entrant dans la 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 voir les données d'instantané les plus récentes de l'instance de jumeau numérique.Dans la liste Instance jumeau numérique, sélectionnez le menu Actions à la fin de la rangée pour supprimer, gérer les marqueurs 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 numérique jumelée.
Par exemple, utilisez cette commande pour mettre à jour la clé externe d'une instance de jumeau numérique. Évitez les soumissions en n'utilisant pas de soumissions 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 du 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, voir 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, voir Informations de référence sur les commandes de l'interface de ligne de commande.
Exécutez l'opération UpdateDigitalTwinInstance pour mettre à jour une instance de jumeau numérique.