Oracle Cloud Infrastructure-Dokumentation

Digital Twin Adapter aktualisieren

Aktualisieren Sie den digitalen Zwillingsadapter für Ihr Internet of Things (IoT).

Wenn Sie eine vorhandene Option aktualisieren, die auf einen digitalen Zwillingsadapter angewendet wird, ändern Sie nur den Wert, den Sie dem digitalen Zwillingsadapter nicht mit dieser Aktualisierungsoption hinzufügen. Wenn Sie einen neuen Wert hinzufügen möchten, müssen Sie einen neuen digitalen Zwillingsadapter erstellen und die neue OCID des digitalen Zwillingsadapters mit der digitalen Zwillingsinstanz verknüpfen, mit der Sie arbeiten möchten, können Sie dies tun, wenn Sie eine digitale Zwillingsinstanz erstellen oder eine digitale Zwillingsinstanz aktualisieren.

Spezifische Szenarios mit digitalen Zwillingsadaptern finden Sie unter:

Digital Twin Adapter Optionen

  • Zeitpunkt zum Aktualisieren oder erneuten Erstellen eines digitalen Zwillingsadapters: Verwenden Sie das Update für Metadaten, einschließlich display-name, description und tags, wenn diese Optionen beim Erstellen des digitalen Zwillingsadapters anfänglich enthalten waren. Um Logikänderungen in einer envelope-mapping oder inbound-routes zuzuordnen, erstellen Sie einen neuen Adapter.
  • Best Practices für Adapterupdates: Wenden Sie Updates in einem neuen Adapter an, verknüpfen Sie sie mit Ihrer Testinstanz für digitale Zwillinge, stellen Sie Beispieltelemetrie nach, prüfen Sie 202-Antworten und nachgelagerte Werte, und ordnen Sie die digitale Zwillingsinstanz der Produktion dem neuen Adapter zu.
  • Adapterwerte: Kann null sein oder leer.
  • Eingehende Routen müssen gültige JSON sein: Nicht mit Anführungszeichen versehene ${...}-Werte werden nicht unterstützt und abgelehnt. JQ-Ausdrücke müssen sich innerhalb von Zeichenfolgen in Anführungszeichen befinden. Beispiel: "${(.velocity_kph / 1.609) | floor}"
  • Limits für eingehende Routen: Die maximale Anzahl eingehender Routen beträgt 128 eingehende Routen.
  • CLI-Angebotserstellung unter Windows: Abhängig von Ihrem Betriebssystem oder Ihrer Anwendung, mit der Sie arbeiten, können Zeichenfolgenparameter, Anführungszeichen und Leerzeichen Probleme verursachen. Vermeiden Sie Anführungszeichen, die zu unerwarteten zusätzlichen Argumenten führen. Vermeiden Sie außerdem Leerzeichen. Beispiel: Um OCI-CLI-Parameter einzugeben, verwenden Sie Folgendes:

    --description your-description

Hinweis

Die OCI-CLI verwendet für die Adapterdefinitionen für digitale Zwillinge durch Bindestriche getrennte Wörter. Die API verwendet die Notation camelCase. Beispiel: Wenn Sie die oci cli-Befehle envelope-mapping verwenden, die für die OCI-CLI verwendet werden, wird envelopeMapping, wenn Sie das Python-IoT-SDK oder die IoT-API verwenden.
  • Verwenden Sie die Aktualisierungsoption, um den Wert einer vorhandenen Adapteroption für digitale IoT-Doppelsysteme 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 Adapter aus.
    3. Wählen Sie den Digital Twin Adapter-Namen aus. Wählen Sie Bearbeiten aus, um den Namen, die Beschreibung zu aktualisieren oder um eine neue .json-Datei mit dem Inhalt für den eingehenden Envelope oder die Bedingungen für die eingehende Route für diesen Adapter zu bearbeiten oder hochzuladen.
    4. Wählen Sie Nicht angegeben aus, um entweder den eingehenden Envelope des Digital Twin Adapters oder die Spezifikation der eingehenden Route zu entfernen.
    5. Wählen Sie Aktualisieren aus.

      Wählen Sie in der Liste Digitaler Zwillingsadapter das Menü Aktionen am Ende der Zeile aus, um zu löschen, Tags zu verwalten oder die OCID zu kopieren.

  • Verwenden Sie den Befehl oci iot digital-twin-adapter update und die erforderlichen Parameter, um einen digitalen Zwillingsadapter zu aktualisieren. Sie können die Beschreibung, Freiformtags, definierte Tags oder den Anzeigenamen für einen digitalen Zwillingsadapter aktualisieren. Abhängig von Ihrem Betriebssystem benötigen Sie möglicherweise unterschiedliche Schrägstriche, z. B. auf Mac oder Linux: file:///inbound-routes.json für weitere Informationen, siehe

    So aktualisieren Sie die eingehenden Routen eines Digital Twin Adapters: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --inbound-routes file://inbound-routes.json
    So aktualisieren Sie die eingehende Envelop-Zuordnung eines Digital Twin Adapters: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --inbound-envelop file://inbound-envelop.json
    So aktualisieren Sie die Beschreibung eines digitalen Zwillingsadapters: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --description "<updated-description>"
    Um die Freiformtags eines Digital Twin Adapters zu aktualisieren, können Sie Schlüsselwertpaare wie in diesem Beispiel oder einen Pfad zu einer Datei wie tags.json wie im folgenden Beispiel definieren: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --freeform-tags '{"<key>": "<value>"}'
    Weitere Informationen finden Sie unter Freiformtags.
    Um die definierten Tags eines Digital Twin Adapters zu aktualisieren, verwenden Sie eine .json-Datei, um die Tags zu definieren, und fügen Sie einen Pfad wie die tags.json-Datei wie im Beispiel ein:
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --defined-tags file://tags.json
    Weitere Informationen finden Sie unter Arbeiten mit definierten Tags.
    So aktualisieren Sie den Anzeigenamen eines digitalen Zwillingsadapters: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --display-name "<updated-display-name>"

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

  • Führen Sie den Vorgang UpdateDigitalTwinAdapter aus, um den Digital Twin Adapter zu aktualisieren.