Documentation Oracle Cloud Infrastructure

Création d'une instance de jumeau numérique

Créez une instance de jumeau numérique pour un appareil ou simulez une connexion d'appareil qui est une représentation numérique d'une entité physique.

Pour les administrateurs, reportez-vous à Prérequis pour plus d'informations sur les stratégies pour les ressources, certificats et clés secrètes IoT. Pour obtenir des exemples spécifiques de configuration d'instances de jumeaux numériques, reportez-vous à Scénarios.

Tenez compte des options suivantes lorsque vous créez une instance de jumeau numérique :
  • Pour les données structurées, créez une instance de jumeau numérique avec un adaptateur et un modèle : si vous recevez des données structurées à partir d'un appareil, vous devez créer et associer un modèle de jumeau numérique et un adaptateur de jumeau numérique à l'instance de jumeau numérique.
  • Pour les données non structurées, créer une instance de jumeau numérique sans adaptateur ni modèle : si vous recevez des données non structurées à partir d'un appareil, votre instance de jumeau numérique ne nécessite pas d'adaptateur ou de modèle de jumeau numérique.
  • Authentification : (facultatif)
    • Avec authentification : si l'instance de jumeau numérique est configurée pour recevoir des données d'appareil ou est associée à un adaptateur de jumeau numérique, vous devez utiliser le paramètre d'ID d'authentification avec une clé secrète de coffre ou un OCID de certificat afin que le jumeau numérique puisse s'authentifier. Pour cela, créez une clé secrète ou un certificat.
    • Sans authentification : si vous voulez créer une instance de jumeau numérique sans données ingérables à partir d'un appareil, vous pouvez créer une instance de jumeau numérique sans adaptateur de jumeau numérique et sans le paramètre d'ID d'authentification, --auth-id. Le modèle jumeau numérique associé est requis et ne doit pas contenir de télémétrie ou de propriétés. Après avoir créé une instance de jumeau numérique, vous pouvez créer une relation de jumeau numérique pour simuler votre environnement IoT à des fins de test sans la complexité des données ni de l'authentification.
  • Clé externe : (facultatif)
    • Utilisation d'une clé externe avec un ID d'authentification de certificat mTLS : lorsque vous créez une instance de jumeau numérique, le paramètre --external-key est facultatif. Si vous incluez une clé externe et que l'ID d'authentification est spécifié en tant qu'OCID de certificat mTLS, vous devez utiliser le nom commun du certificat comme valeur de clé externe.
    • Utilisation d'un ID d'authentification de clé secrète de coffre : lorsque vous créez une instance de jumeau numérique, si vous utilisez le paramètre --auth-id avec une clé secrète de coffre pour authentifier un appareil lorsque vous envoyez des données, vous devez utiliser la valeur de clé secrète en texte brut comme mot de passe d'appareil lorsque vous envoyez des données.
    • Utilisation d'un ID de périphérique comme clé externe : la clé externe peut être le nom d'un périphérique, ou vous pouvez utiliser un ID de périphérique spécifique, par exemple une adresse MAC ou un numéro de série.
    • Sans clé externe : si vous n'incluez pas d'élément --external-key lorsque vous créez une instance de jumeau numérique, la clé externe est générée automatiquement. Une fois l'instance de jumeau numérique créée, utilisez la commande mettre à jour l'instance de jumeau numérique pour modifier la clé externe.
    1. Dans la page de liste Domaines IoT, sélectionnez le domaine IoT avec lequel vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste des domaines IoT, reportez-vous à Liste des domaines IoT.
    2. Sélectionnez l'onglet Instances de jumeaux numériques, puis sélectionnez Créer.
    3. Entrez un nom et éventuellement une description. Evitez de saisir des informations confidentielles.
    4. Facultatif. Entrez une clé externe qui est un identificateur unique. Si vous n'indiquez pas de clé externe, elle est générée lorsque vous enregistrez cette instance de jumeau numérique. Utilisez la clé externe comme nom d'utilisateur du périphérique lorsque vous connectez ou envoyez des données au périphérique.
    5. Sélectionnez 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, sélectionnez un adaptateur. La sélection d'un adaptateur associe cette instance de jumeau numérique à une couche de transformation qui convertit les charges utiles de l'appareil entrant en structure DTDL du modèle de jumeau numérique associé attendue par l'instance.
      • Non connecté : utilisez cette option pour les instances de jumeau numérique qui ne sont pas soutenues par un appareil IoT. Par conséquent, ces instances ne peuvent pas recevoir de télémétrie et ne peuvent pas envoyer ou recevoir de commandes. Les modèles de jumeaux numériques associés à ces instances peuvent définir des relations de jumeaux numériques, mais ne peuvent pas inclure de télémétrie ou de propriétés. Vous pouvez utiliser cette option pour simuler votre environnement IoT sans la complexité de l'authentification des données ou des appareils.
      • ID d'authentification : si le périphérique ou l'entité envoie ou reçoit des données, vous devez indiquer un ID d'authentification. Pour tester l'ID d'authentification de création d'une clé secrète de coffre et pour la production, créez un certificat MTLS pour l'ID d'authentification de l'instance de jumeau numérique.
        • Sélectionner un ID d'authentification : sélectionnez l'option de clé secrète ou de certificat. Pour une clé secrète, sélectionnez le compartiment de coffre, le coffre et la clé secrète. Pour un certificat, sélectionnez le compartiment de certificat, puis le certificat.
        • Coller l'OCID d'authentification : collez l'OCID du certificat ou de la clé secrète.
      • Balises : (facultatif) ajoutez des balises à l'adaptateur jumeau numérique. Si vous êtes autorisé à créer une ressource, vous disposez également des droits d'accès nécessaires pour lui appliquer des balises à format libre. Pour appliquer une balise définie, vous devez disposer de droits d'accès permettant d'utiliser l'espace de noms de balise. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas certain d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
    6. Choisissez Créer.

  • Pour les données non structurées :

    Utilisez la commande oci iot digital-twin-instance create et les paramètres requis pour créer une instance de jumeau numérique pour un domaine IoT associé.

    Remplacez <iot-domain-OCID> par l'OCID du domaine IoT à associer à cette instance de jumeau numérique et remplacez <certificate-or-secret-OCID> par votre certificat ou clé secrète :

    oci iot digital-twin-instance create --auth-id <certificate-or-secret-OCID> --iot-domain-id <iot-domain-OCID>

    Pour les données structurées :

    Utilisez la commande oci iot digital-twin-instance create et les paramètres requis. Les données structurées nécessitent la création d'une instance de jumeau numérique avec un ID d'authentification et un adaptateur de jumeau numérique.

    Remplacez <iot-domain-OCID> par l'OCID du domaine IoT à associer à cette instance de jumeau numérique et remplacez <certificate-or-secret-OCID> par votre certificat ou clé secrète.

    Remplacez <digital-twin-adapter-OCID> par l'OCID de l'adaptateur jumeau numérique associé : 
    oci iot digital-twin-instance create --iot-domain-id <iot-domain-OCID> --auth-id <certificate-or-secret-OCID> --digital-twin-adapter-id <digital-twin-adapter-OCID>
    Pour plus d'informations, reportez-vous à Création d'un adaptateur jumeau numérique.
    Remarque

    N'utilisez pas de guillemets avec une valeur de clé externe. Certaines applications ou certains éditeurs de code peuvent ajouter des guillemets indésirables à vos valeurs, ce qui peut entraîner une erreur. Lorsque vous utilisez des clés externes, il est recommandé de supprimer les guillemets. Cela s'applique également aux clés externes dans les commandes curl. Cette commande d'interface de ligne de commande affiche le paramètre --external-key et la valeur correspondante qui ne contient pas de guillemets :

    --external-key 01-23-45-67-89-ab

    Sans ID d'authentification, modèle de jumeau numérique ou adaptateur de jumeau numérique :

    Cet exemple de commande montre comment créer une instance de jumeau numérique sans adaptateur de jumeau numérique, modèle de jumeau numérique ou ID d'authentification et inclut le paramètre de clé externe facultatif.

    Remplacez la clé externe par une clé externe pour le périphérique. La clé externe doit être unique et peut être une valeur de texte descriptif ou vous pouvez utiliser l'adresse MAC ou le numéro de série du périphérique.

    Dans cet exemple, la valeur --external-key ne contient pas de guillemets : 01-23-45-67-89-ab
    oci iot digital-twin-instance create --iot-domain-id <iot-domain-OCID> --external-key 01-23-45-67-89-ab

    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 CreateDigitalTwinInstance pour créer une instance de jumeau numérique.