Digitale Zwillingsinstanzen aktualisieren

Aktualisieren Sie Adapter-ID, Modell-ID, Modellspezifikations-URI, Authentifizierungs-ID, externen Schlüssel, Beschreibung, Tags oder einen Anzeigenamen für Ihr Internet of Things (IoT) einer Digital Twin-Instanz.

Wenn Sie eine vorhandene Option aktualisieren, die auf eine Instanz mit digitalem Zwilling angewendet wird, ändern Sie nur den Wert, den Sie mit dieser Aktualisierungsoption der Instanz mit digitalem Zwilling keinen neuen Wert hinzufügen können. Wenn Sie den Parameter, den Sie beim Erstellen der digitalen Zwillingsinstanz aktualisieren möchten, nicht aufgenommen haben, können Sie den Wert nicht aktualisieren. Erstellen Sie stattdessen eine neue Instanz für digitale Zwillinge, um einen neuen Parameter hinzuzufügen.

Beispiel: Wenn Sie eine digitale Zwillingsinstanz ohne Authentifizierungsparameter zum Testen erstellen, müssen Sie eine neue digitale Zwillingsinstanz mit dem Authentifizierungsparameter erstellen, wenn Sie Daten von der digitalen Zwillingsinstanz senden oder empfangen möchten. Wenn die Instanz des digitalen Zwillings mit einer Authentifizierungs-ID erstellt wurde, können Sie die Authentifizierungs-ID aktualisieren.

  • Verwenden Sie die Aktualisierungsoption, um den Wert einer vorhandenen Instanzoption für einen digitalen IoT-Zwilling zu aktualisieren.
    1. Wählen Sie auf der Listenseite Domains die Domain, mit der Sie arbeiten möchten. Informationen zum Suchen der Listenseite für IoT-Domains oder einer IoT-Domain finden Sie unter IoT-Domains auflisten.
    2. Wählen Sie die Registerkarte Digital Twin Instances aus.
    3. Wählen Sie den Namen der digitalen Zwillingsinstanz aus. Wählen Sie die zu aktualisierende Bearbeiten aus:
      • Aktualisieren Sie den Namen, die Beschreibung oder den externen Schlüssel, und vermeiden Sie die Eingabe vertraulicher Informationen.
      • Bearbeiten 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, aktivieren Sie den Umschalter auf Adapter auswählen. Durch die Auswahl eines Adapters wird diese Instanz des digitalen Zwillings mit einem Transformationslayer mit einem eingehenden Envelope und eingehenden Routen verknüpft, um eingehende Geräte-Payloads in die DTDL-Spezifikationsstruktur des zugehörigen digitalen Zwillingsmodells zu konvertieren, die von der Instanz erwartet wird. Wenn kein Adapter zur Auswahl in der Liste angezeigt wird, erstellen Sie einen Adapter.

          Optional. Wenn das Gerät oder die Entity Daten sendet oder empfängt, müssen Sie eine Authentifizierungs-ID auswählen. Verwenden Sie ein Secret nur mit Basisauthentifizierung zum Testen, für sichere oder Produktionsumgebungen ein mTLS-Zertifikat. Sie können die Authentifizierungs-ID auswählen oder die Authentifizierungs-OCID einfügen.

        • Nicht verbunden: Mit dieser Option können Sie eine Nur-Simulations-Digitale Zwillingsinstanz ohne Datenaufnahme erstellen. Ein digitales Zwillingsmodell ist erforderlich und darf keine Telemetrie oder Eigenschaften enthalten. Wählen Sie das Modell aus der Liste aus, oder wählen Sie das Modell aus, indem Sie den DTMI eingeben. Nachdem Sie diese Instanz des digitalen Zwillings erstellt haben, können Sie digitalen Zwillingsbeziehungen hinzufügen, um Ihre IoT-Umgebung ohne die Komplexität der Datenaufnahme oder -authentifizierung zu simulieren.
      • Wählen Sie Aktualisieren aus.
    4. Daten: Wählen Sie diese Option aus, um die neuesten Snapshot-Daten für die Instanz des digitalen Zwillings anzuzeigen.

      Wählen Sie in der Liste Digitale Zwillingsinstanz das Menü Aktionen am Ende der Zeile zum Löschen, Verwalten von Tags oder Kopieren der OCID aus.
  • Wenn Sie den externen Schlüssel nicht einschließen, wird er generiert.

    Verwenden Sie den Befehl oci iot digital-twin-instance update und den erforderlichen Parameter, um den vorhandenen Parameter einer Instanz eines digitalen Zwillings zu aktualisieren.

    Beispiel: Verwenden Sie diesen Befehl, um den externen Schlüssel einer Instanz mit digitalem Zwilling zu aktualisieren. Vermeiden Sie das Angeben von Problemen, indem Sie keine Anführungszeichen mit einem externen Schlüsselwert verwenden. Sie können <your-device-id> durch eine Seriennummer, eine MAC-Adresse oder einen Gerätenamen als externen Schlüssel ersetzen, um das Gerät mit der digitalen Zwillingsinstanz zu verknüpfen:

    oci iot digital-twin-instance update --digital-twin-instance-id <digital-twin-instance-OCID> --external-key <your-device-id>

    Verwenden Sie diesen Befehl und den erforderlichen Parameter <digital-twin-instance-OCID>, um den optionalen Authentifizierungsparameter für eine digitale Zwillingsinstanz zu aktualisieren. Aktualisieren Sie den Wert mit der Secret- oder Zertifikats-OCID. Dies ist das Gerätekennwort, wenn Sie Daten senden an das Gerät:

    oci iot digital-twin-instance update --digital-twin-instance-id <digital-twin-instance-OCID> --auth "<updated-auth-ocid>"

    Eine vollständige Liste der Parameter für die Instanz des digitalen Zwillings finden Sie unter OCI iot digital-twin-instance update. Eine vollständige Liste aller OCI-CLI-Befehle finden Sie unter CLI-Befehlsreferenz.

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