Documentation sur Oracle Cloud Infrastructure

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

Créer une instance de jumeau numérique pour un appareil ou simuler une connexion de périphérique qui est une représentation numérique d'une entité physique.

Pour les administrateurs, voir Préalables pour plus d'informations sur les politiques relatives aux ressources, certificats et clés secrètes IoT. Pour des exemples spécifiques de configuration d'instances de jumeau numérique, voir 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 un modèle de jumeau numérique et un adaptateur jumeau numérique et l'associer à l'instance de jumeau numérique.
  • Pour les données non structurées, créez une instance de jumeau numérique sans adaptateur ou modèle : Si vous recevez des données non structurées à partir d'un appareil, celui-ci 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 jumeau numérique, vous devez utiliser le paramètre d'ID authentification avec une clé secrète de chambre forte ou un OCID de certificat afin que le jumeau numérique puisse s'authentifier. Pour ce faire, créez une clé secrète ou créez 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 jumeau numérique et sans le paramètre ID 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 ou de l'authentification.
  • Clé externe : (Facultatif)
    • Utilisation d'une clé externe avec un ID 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 authentification est spécifié en tant qu'OCID du certificat MTLS, vous devez utiliser le nom commun du certificat en tant que valeur de clé externe.
    • Utilisation d'un ID authentification de clé secrète de chambre forte : Lorsque vous créez une instance de jumeau numérique si vous utilisez le paramètre --auth-id avec une clé secrète de chambre forte 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 de l'appareil lorsque vous envoyez des données.
    • Utilisation d'un ID appareil comme clé externe : La clé externe peut être un nom pour un appareil ou vous pouvez utiliser un ID appareil spécifique, par exemple une adresse MAC ou un numéro de série.
    • Sans clé externe : Si vous n'incluez pas --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 IdO, sélectionnez le domaine IdO avec lequel vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste des domaines IoT, voir Liste des domaines IoT.
    2. Sélectionnez l'onglet Instances jumeaux numériques, puis sélectionnez Créer.
    3. Entrez un nom et facultativement une description. Évitez d'entrer des informations confidentielles.
    4. Facultative. Entrez une clé externe qui est un identificateur unique. Si vous ne spécifiez pas de clé externe, elle est générée lors de l'enregistrement de cette instance de jumeau numérique. Utilisez la clé externe comme nom d'utilisateur de l'appareil lorsque vous connectez ou envoyez des données à l'appareil.
    5. Sélectionnez le type :
      • Connexion directe : Connectez un appareil ou une entité directement au domaine IdO. 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 données utiles de périphérique entrant dans la 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 IdO. 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 jumeau numérique associés à ces instances peuvent définir des relations de jumeau numérique, mais ne peuvent pas inclure la télémétrie ou les propriétés. Vous pouvez utiliser cette option pour simuler votre environnement IoT sans la complexité de l'authentification des données ou de l'appareil.
      • ID authentification : Si l'appareil ou l'entité envoie ou reçoit des données, vous devez spécifier un ID authentification. Pour tester l'ID authentification de la clé secrète de la chambre forte et pour le service de production, créez un certificat mTLS pour l'ID authentification de l'instance de jumeau numérique.
        • Sélectionner l'ID authentification : Sélectionnez l'option de clé secrète ou de certificat. Pour une clé secrète, sélectionnez le compartiment de la chambre forte, la chambre forte et la clé secrète. Pour un certificat, sélectionnez le compartiment du certificat, puis le certificat.
        • Coller l'OCID de l'authentification : Collez l'OCID du certificat ou de la clé secrète.
      • Marqueurs : (Facultatif) Ajoutez un ou plusieurs marqueurs à l'adaptateur jumeau numérique. Si vous êtes autorisé à créer une ressource, vous disposez également des autorisations nécessaires pour appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
    6. Sélectionnez 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 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, voir Création d'un adaptateur de jumeau numérique.
    Note

    N'utilisez pas de guillemets avec une valeur de clé externe. Certaines applications ou éditeurs de code peuvent ajouter des devis 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 jumeau numérique :

    Cet exemple de commande montre comment créer une instance de jumeau numérique sans un adaptateur de jumeau numérique, un modèle de jumeau numérique ou un 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 de l'appareil.

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