Documentazione dell'infrastruttura Oracle Cloud

Aggiornamento di un adattatore Digital Twin

Aggiornare l'adattatore gemello digitale per Internet of Things (IoT).

Quando si aggiorna un'opzione esistente applicata a un adattatore digital twin, si modifica solo il valore che non si aggiunge un nuovo valore all'adattatore digital twin utilizzando questa opzione di aggiornamento. Se si desidera aggiungere un nuovo valore, è necessario creare un nuovo adattatore digital twin e associare il nuovo OCID adattatore digital twin all'istanza digital twin con cui si desidera lavorare, è possibile eseguire questa operazione quando si crea un'istanza digital twin o si aggiorna un'istanza digital twin.

Per gli scenari specifici con adattatori gemelli digitali, vedere:

Opzioni adattatore Digital Twin

  • Quando aggiornare o ricreare un adattatore digital twin: utilizzare l'aggiornamento per i metadati, inclusi display-name, description e tags se queste opzioni sono state incluse inizialmente quando è stato creato l'adattatore digital twin. Per le modifiche alla logica di mapping in un file envelope-mapping o inbound-routes, creare un nuovo adattatore.
  • Best practice per gli aggiornamenti dell'adattatore: applica gli aggiornamenti in un nuovo adattatore, associa all'istanza gemella digitale di test, invia una telemetria di esempio, verifica le risposte 202 e i valori a valle, quindi associa l'istanza gemella digitale di produzione al nuovo adattatore.
  • Valori adattatore: può essere null o vuoto.
  • Gli spostamenti in entrata devono essere in formato JSON valido: i valori ${...} senza virgolette non sono supportati e verranno rifiutati. Le espressioni JQ devono essere all'interno di stringhe tra virgolette, ad esempio "${(.velocity_kph / 1.609) | floor}"
  • Limiti sui percorsi in entrata: il numero massimo di percorsi in entrata è di 128 percorsi in entrata.
  • CLI quoting su Windows: a seconda del sistema operativo o dell'applicazione in uso, i parametri stringa, le virgolette e gli spazi possono causare problemi. Evitare di utilizzare virgolette che generano argomenti aggiuntivi imprevisti, evitando anche di utilizzare spazi. Ad esempio, per immettere i parametri dell'interfaccia CLI OCI, utilizzare una procedura simile alla seguente:

    --description your-description

Nota

L'interfaccia CLI OCI utilizza parole separate da trattini per le definizioni dell'adattatore gemello digitale. L'API utilizza la notazione camelCase. Ad esempio, quando si utilizzano i comandi oci cli envelope-mapping utilizzati per l'interfaccia CLI OCI, diventa envelopeMapping quando si utilizza l'SDK IoT Python o l'API IoT.
  • Utilizzare l'opzione di aggiornamento per aggiornare il valore di un'opzione adattatore gemello digitale IoT esistente.
    1. Nella pagina di elenco Domini, selezionare il dominio da utilizzare. Se è necessaria assistenza per trovare la pagina di elenco dei domini IoT o un dominio IoT, vedere Elenco dei domini IoT.
    2. Selezionare la scheda Adattatori gemelli digitali.
    3. Selezionare il nome adattatore gemello digitale. Selezionare Modifica per aggiornare il nome, la descrizione o per modificare o caricare un nuovo file .json con i contenuti per l'envelope in entrata o le condizioni di instradamento in entrata per questo adattatore.
    4. Selezionare Non specificato per rimuovere l'envelope in entrata o la specifica di instradamento in entrata dell'adattatore digital twin.
    5. Selezionare Aggiorna.

      Nell'elenco Adattatore gemello digitale selezionare il menu Azioni alla fine della riga, quindi eliminare, gestire i tag o copiarne l'OCID.

  • Utilizzare il comando oci iot digital-twin-adapter update e i parametri necessari per aggiornare un adattatore digital twin. È possibile aggiornare la descrizione, i tag in formato libero, i tag definiti o il nome visualizzato per un adattatore gemello digitale. A seconda del sistema operativo, potrebbe essere necessario un numero diverso di barre, ad esempio su Mac o Linux utilizza: file:///inbound-routes.json per ulteriori informazioni, vedere

    Per aggiornare gli instradamenti in entrata di un adattatore digital twin: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --inbound-routes file://inbound-routes.json
    Per aggiornare il mapping dell'envelopment in entrata di un adattatore digital twin, procedere come segue. 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --inbound-envelop file://inbound-envelop.json
    Per aggiornare la descrizione di un adattatore digital twin: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --description "<updated-description>"
    Per aggiornare i tag in formato libero di un adattatore gemello digitale, è possibile definire coppie di valori chiave come in questo esempio o un percorso a un file simile al file tags.json, come nell'esempio seguente: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --freeform-tags '{"<key>": "<value>"}'
    Per ulteriori informazioni, vedere Informazioni sui tag in formato libero.
    Per aggiornare le tag definite di un adattatore digital twin, utilizzare un file .json per definire le tag e includere un percorso simile al file tags.json come nell'esempio riportato di seguito.
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --defined-tags file://tags.json
    Per ulteriori informazioni, vedere Utilizzo delle tag definite.
    Per aggiornare il nome visualizzato di un adattatore gemello digitale: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --display-name "<updated-display-name>"

    Per un elenco completo dei parametri e dei valori per i comandi CLI, vedere CLI Command Reference.

  • Eseguire l'operazione UpdateDigitalTwinAdapter per aggiornare l'adattatore gemello digitale.