Oracle Cloud Infrastructure-Dokumentation

Digitale Zwillingsinstanzen erstellen

Erstellen Sie eine digitale Zwillingsinstanz für ein Gerät oder simulieren Sie eine Geräteverbindung, die eine digitale Darstellung einer physischen Einheit ist.

Informationen zu Policys für IoT-Ressourcen, -Zertifikate und -Secrets finden Sie unter Voraussetzungen. Spezifische Beispiele zum Einrichten von digitalen Zwillingsinstanzen finden Sie unter Szenarios.

Beachten Sie die folgenden Optionen, wenn Sie eine Instanz mit digitalem Zwilling erstellen:
  • Für strukturierte Daten eine digitale Zwillingsinstanz mit einem Adapter und einem Modell erstellen: Wenn Sie strukturierte Daten von einem Gerät erhalten, müssen Sie ein digitales Zwillingsmodell und einen digitalen Zwillingsadapter erstellen und der digitalen Zwillingsinstanz zuordnen.
  • Für unstrukturierte Daten erstellen Sie eine digitale Zwillingsinstanz ohne Adapter oder Modell: Wenn Sie unstrukturierte Daten von einem Gerät erhalten, ist für Ihre digitale Zwillingsinstanz kein digitaler Zwillingsadapter oder -modell erforderlich.
  • Authentifizierung: (Optional)
    • Mit Authentifizierung: Wenn die digitale Zwillingsinstanz für den Empfang von Gerätedaten eingerichtet oder mit einem digitalen Zwillingsadapter verknüpft ist, müssen Sie den Parameter "Authentifizierungs-ID" mit einem Vault Secret oder einer Zertifikats-OCID verwenden, damit sich der digitale Zwilling authentifizieren kann. Erstellen Sie dazu ein Secret, oder erstellen Sie ein Zertifikat.
    • Ohne Authentifizierung: Wenn Sie eine digitale Zwillingsinstanz ohne aufnehmbare Daten von einem Gerät erstellen möchten, können Sie eine digitale Zwillingsinstanz ohne einen digitalen Zwillingsadapter und ohne den Authentifizierungs-ID-Parameter --auth-id erstellen. Das zugehörige digitale Zwillingsmodell ist erforderlich und darf keine Telemetrie oder Eigenschaften enthalten. Nachdem Sie eine Instanz für digitale Zwillinge erstellt haben, können Sie eine Beziehung für digitale Zwillinge erstellen, um Ihre IoT-Umgebung zum Testen ohne die Komplexität von Daten oder Authentifizierung zu simulieren.
  • Externer Schlüssel: (Optional)
    • Externen Schlüssel mit einer mTLS-Zertifikatsauthentifizierungs-ID verwenden: Wenn Sie eine digitale Zwillingsinstanz erstellen, ist der Parameter --external-key optional. Wenn Sie einen externen Schlüssel einschließen und die Authentifizierungs-ID als mTLS-Zertifikats-OCID angegeben ist, müssen Sie den allgemeinen Namen des Zertifikats als externen Schlüsselwert verwenden.
    • Vault Secret-Authentifizierungs-ID verwenden: Wenn Sie eine digitale Zwillingsinstanz erstellen, wenn Sie den Parameter --auth-id mit einem Vault Secret verwenden, um ein Gerät zu authentifizieren, wenn Sie Daten senden, müssen Sie den Secret-Wert im Klartext als Gerätekennwort verwenden, wenn Sie Daten senden.
    • Verwenden einer Geräte-ID als externen Schlüssel: Der externe Schlüssel kann ein Name für ein Gerät sein, oder Sie können eine bestimmte Geräte-ID verwenden, z.B. eine MAC-Adresse oder eine Seriennummer.
    • Ohne externen Schlüssel: Wenn Sie beim Erstellen einer Instanz mit digitalem Zwilling keine --external-key angeben, wird der externe Schlüssel automatisch generiert. Nachdem die Instanz des digitalen Zwillings erstellt wurde, ändern Sie den externen Schlüssel mit dem Befehl Instanz des digitalen Zwillings aktualisieren.
    1. Wählen Sie auf der Listenseite IoT-Domains die IoT-Domain aus, mit der Sie arbeiten möchten. Wenn Sie Hilfe beim Suchen der Listenseite für IoT-Domains benötigen, finden Sie weitere Informationen unter IoT-Domains auflisten.
    2. Wählen Sie die Registerkarte Digitale Zwillingsinstanzen und dann Erstellen aus.
    3. Geben Sie einen Namen und optional eine Beschreibung ein. Geben Sie keine vertraulichen Informationen ein.
    4. Optional. Geben Sie einen externen Schlüssel ein, der eine eindeutige ID ist. Wenn Sie keinen externen Schlüssel angeben, wird dieser beim Speichern dieser Instanz des digitalen Zwillings generiert. Verwenden Sie den externen Schlüssel als Gerätenutzernamen, wenn Sie eine Verbindung zum Gerät herstellen oder Daten an dieses senden.
    5. Wählen Sie den Typ:
      • Direkt verbunden: Verbinden Sie ein Gerät oder eine Entity direkt mit der IoT-Domain. Wenn das Gerät oder die Entity strukturierte Daten sendet, wählen Sie einen Adapter aus. Durch Auswahl eines Adapters wird diese Instanz des digitalen Zwillings mit einer Transformationsschicht verknüpft, die eingehende Geräte-Payloads in die DTDL-Struktur des zugehörigen digitalen Zwillingsmodells konvertiert, die von der Instanz erwartet wird.
      • Nicht verbunden: Verwenden Sie diese Option für Instanzen von digitalen Zwillingen, die nicht von einem IoT-Gerät unterstützt werden. Daher können diese Instanzen keine Telemetrie empfangen und keine Befehle senden oder empfangen. Mit diesen Instanzen verknüpfte Digitale Zwillingsmodelle können Digitale Zwillingsbeziehungen definieren, jedoch keine Telemetrie oder Eigenschaften enthalten. Mit dieser Option können Sie Ihre IoT-Umgebung ohne die Komplexität der Daten- oder Geräteauthentifizierung simulieren.
      • Authentifizierungs-ID: Wenn das Gerät oder die Entity Daten sendet oder empfängt, müssen Sie eine Authentifizierungs-ID angeben. Zum Testen erstellen Sie eine Vault-Secret-Authentifizierungs-ID und für die Produktion erstellen Sie ein mTLS-Zertifikat für die Authentifizierungs-ID der Digital Twin-Instanz.
        • Authentifizierungs-ID auswählen: Wählen Sie die Secret- oder Zertifikatoption aus. Wählen Sie für ein Secret das Vault Compartment, den Vault und das Secret aus. Wählen Sie für ein Zertifikat das Zertifikat-Compartment aus, und wählen Sie das Zertifikat aus.
        • Authentifizierungs-OCID einfügen: Fügen Sie die OCID des Zertifikats oder Secrets ein.
      • Tags: (Optional) Fügen Sie dem digitalen Zwillingsadapter ein oder mehrere Tags hinzu. Wenn Sie über Berechtigungen zum Erstellen einer Ressource verfügen, sind Sie auch berechtigt, Freiformtags auf diese Ressource anzuwenden. Um ein definiertes Tag zuzuweisen, benötigen Sie die Berechtigungen zum Verwenden des Tag-Namespace. Weitere Informationen zum Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Tags angewendet werden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
    6. Wählen Sie Erstellen.

  • Für unstrukturierte Daten:

    Verwenden Sie den Befehl oci iot digital-twin-instance create und die erforderlichen Parameter, um eine digitale Zwillingsinstanz für eine verknüpfte IoT-Domain zu erstellen.

    Ersetzen Sie <iot-domain-OCID> durch die OCID der IoT-Domain, die Sie mit dieser digitalen Zwillingsinstanz verknüpfen möchten, und ersetzen Sie <certificate-or-secret-OCID> durch Ihr Zertifikat oder Secret:

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

    Für strukturierte Daten:

    Verwenden Sie den Befehl oci iot digital-twin-instance create und die erforderlichen Parameter. Strukturierte Daten erfordern die Erstellung einer digitalen Zwillingsinstanz mit einer Authentifizierungs-ID und einem digitalen Zwillingsadapter.

    Ersetzen Sie <iot-domain-OCID> durch die OCID der IoT-Domain, die Sie mit dieser digitalen Zwillingsinstanz verknüpfen möchten, und ersetzen Sie <certificate-or-secret-OCID> durch Ihr Zertifikat oder Secret.

    Ersetzen Sie <digital-twin-adapter-OCID> durch die zugehörige OCID des Digital Twin Adapter: 
    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>
    Weitere Informationen finden Sie unter Digital Twin Adapter erstellen.
    Hinweis

    Verwenden Sie keine Anführungszeichen mit einem externen Schlüsselwert. Einige Anwendungen oder Code-Editoren können Ihren Werten unerwünschte Anführungszeichen hinzufügen. Dies kann zu einem Fehler führen. Bei der Arbeit mit externen Schlüsseln empfiehlt es sich, Anführungszeichen zu entfernen. Dies gilt auch für externe Schlüssel in curl-Befehlen. Dieser CLI-Befehl zeigt den Parameter --external-key und den entsprechenden Wert an, der keine Anführungszeichen enthält:

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

    Ohne Authentifizierungs-ID, digitales Zwillingsmodell oder digitalen Zwillingsadapter:

    Dieser Beispielbefehl zeigt, wie eine digitale Zwillingsinstanz ohne einen digitalen Zwillingsadapter, ein digitales Zwillingsmodell oder eine Authentifizierungs-ID erstellt wird. Er enthält den optionalen externen Schlüsselparameter.

    Ersetzen Sie den externen Schlüssel durch einen externen Schlüssel für das Gerät. Der externe Schlüssel muss eindeutig sein und kann ein beschreibender Textwert sein, oder Sie können die MAC-Adresse oder Seriennummer des Geräts verwenden.

    In diesem Beispiel enthält der Wert --external-key keine Anführungszeichen: 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

    Eine vollständige Liste der Parameter und Werte für CLI-Befehle finden Sie in CLI-Befehlsreferenz.

  • Führen Sie den Vorgang CreateDigitalTwinInstance aus, um eine Instanz mit digitalem Zwilling zu erstellen.