Documentazione dell'infrastruttura Oracle Cloud

Creazione di un'istanza Digital Twin

Crea un'istanza digital twin per un dispositivo o simula una connessione dispositivo che è una rappresentazione digitale di un'entità fisica.

Per gli amministratori, vedere Prerequisiti per informazioni sui criteri per le risorse, i certificati e i segreti IoT. Per un esempio specifico che mostra come funzionano insieme i quattro tipi di istanze digital twin, vedere Scenario: Create Digital Twins for Indirectly Connected Devices Using a Gateway o rivedere altri scenari.

Quando si crea un'istanza digital twin, tenere presenti le opzioni riportate di seguito.
  • Per i dati strutturati, creare un'istanza digital twin con un adattatore e un modello: se si ricevono dati strutturati da un dispositivo, è necessario creare e associare un modello digital twin e un adattatore digital twin all'istanza digital twin.
  • Per i dati non strutturati, creare un'istanza digital twin senza un adattatore o un modello: se si ricevono dati non strutturati da un dispositivo, l'istanza digital twin non richiede un adattatore o un modello digital twin.
  • Autenticazione: (facoltativo)
    • Con autenticazione: se l'istanza digital twin è impostata per ricevere i dati del dispositivo o è associata a un adattatore digital twin, è necessario utilizzare il parametro ID autenticazione con un segreto vault o un OCID certificato, in modo che il digital twin possa eseguire l'autenticazione. A tale scopo, creare un segreto o un certificato.
    • Senza autenticazione: se si desidera creare un'istanza digital twin senza dati ingeribili da un dispositivo, è possibile creare un'istanza digital twin senza un adattatore digital twin e senza il parametro ID autenticazione, --auth-id. Il modello gemello digitale associato è obbligatorio e non deve contenere telemetria o proprietà. Dopo aver creato un'istanza digital twin, è possibile creare una relazione digital twin per simulare l'ambiente IoT per i test senza la complessità dei dati o dell'autenticazione.
  • Chiave esterna: (facoltativo)
    • Uso di una chiave esterna con un ID di autenticazione del certificato mTLS: quando si crea un'istanza gemella digitale, il parametro --external-key è facoltativo. Se si include una chiave esterna e l'ID di autenticazione è specificato come OCID certificato mTLS, è necessario utilizzare il nome comune del certificato come valore della chiave esterna.
    • Utilizzo di un ID di autenticazione segreto vault: quando si crea un'istanza di gemello digitale se si utilizza il parametro --auth-id con un segreto vault per autenticare un dispositivo quando si inviano dati, è necessario utilizzare il valore del segreto di testo normale come password del dispositivo quando si inviano dati.
    • Uso di un ID dispositivo come chiave esterna: la chiave esterna può essere un nome per un dispositivo oppure è possibile utilizzare un ID dispositivo specifico, ad esempio un indirizzo MAC o un numero di serie.
    • Senza chiave esterna: se non si include un elemento --external-key quando si crea un'istanza gemella digitale, la chiave esterna viene generata automaticamente. Dopo aver creato l'istanza digital twin, utilizzare il comando update digital twin instance per modificare la chiave esterna.
    1. Nella pagina elenco Domini IoT selezionare il dominio IoT da utilizzare. Se è necessaria assistenza per trovare la pagina dell'elenco dei domini IoT, vedere Elenca domini IoT.
    2. Selezionare la scheda Istanze gemelle digitali, quindi selezionare Crea.
    3. Immettere un nome e, facoltativamente, una descrizione. Evitare di fornire informazioni riservate.
    4. Facoltativa. Immettere una chiave esterna che sia un identificativo univoco. Se non si specifica una chiave esterna, questa viene generata quando si salva questa istanza del gemello digitale. Utilizzare la chiave esterna come nome utente del dispositivo quando ci si connette o si inviano dati al dispositivo.
    5. Selezionare il tipo:
      • Connesso direttamente: connette un dispositivo o un'entità direttamente al dominio IoT. Se il dispositivo o l'entità invia dati strutturati, selezionare un adattatore. La selezione di un adattatore associa questa istanza digital twin a un livello di trasformazione che converte i payload dei dispositivi in entrata nella struttura DTDL del modello digital twin associato prevista dall'istanza.
      • Connesso in modo diretto: selezionare un gateway e l'adattatore gemello digitale per il dispositivo o l'entità connessi in modo indiretto da connettersi utilizzando un gateway specifico e un adattatore gemello digitale.
      • Gateway: selezionare l'adattatore gemello digitale.
      • Non connesso: utilizzare questa opzione per creare un'istanza gemella digitale di sola simulazione senza l'inclusione dei dati. Un modello gemello digitale è obbligatorio e non deve contenere telemetria o proprietà. Dopo aver creato questa istanza di digital twin, è possibile aggiungere relazioni digital twin per simulare l'ambiente IoT senza la complessità dell'inclusione o dell'autenticazione dei dati.
      • ID autenticazione: se il dispositivo o l'entità invia o riceve dati, è necessario specificare un ID autenticazione. Per i test, creare un ID di autenticazione segreto vault e per la produzione creare un certificato mTLS per l'ID di autenticazione dell'istanza del gemello digitale.
        • Seleziona ID autenticazione: selezionare l'opzione Segreto o Certificato. Per un segreto, selezionare il compartimento del vault, il vault e il segreto. Per un certificato, selezionare il compartimento del certificato, quindi selezionare il certificato.
        • Incolla OCID autenticazione: incollare l'OCID del certificato o del segreto.
      • Tag: (facoltativo) aggiungere una o più tag all'adattatore gemello digitale. Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare tag in formato libero a tale risorsa. Per applicare una tag definita, è necessario disporre delle autorizzazioni per utilizzare lo spazio di nomi tag. Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa. Se non sei sicuro di applicare i tag, salta questa opzione o chiedi a un amministratore. È possibile applicare le tag in un secondo momento.
    6. Selezionare Crea.

  • Per i dati non strutturati:

    Utilizzare il comando oci iot digital-twin-instance create e i parametri necessari per creare un'istanza digital twin per un dominio IoT associato.

    Sostituire <iot-domain-OCID> con l'OCID del dominio IoT che si desidera associare a questa istanza di gemello digitale e sostituire <certificate-or-secret-OCID> con il certificato o il segreto:

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

    Per i dati strutturati:

    Utilizzare il comando oci iot digital-twin-instance create e i parametri richiesti. I dati strutturati richiedono la creazione di un'istanza digital twin con un ID di autenticazione e un adattatore digital twin.

    Sostituire <iot-domain-OCID> con l'OCID del dominio IoT che si desidera associare a questa istanza di gemello digitale e sostituire <certificate-or-secret-OCID> con il certificato o il segreto.

    Sostituire <digital-twin-adapter-OCID> con l'OCID digital twin adapter correlato: 
    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>
    Per ulteriori informazioni, vedere Creazione di un adattatore Digital Twin.
    Nota

    Non utilizzare virgolette con un valore di chiave esterna. Alcune applicazioni o editor di codice possono aggiungere virgolette indesiderate ai valori, questo può causare un errore. Quando si utilizzano chiavi esterne, è consigliabile rimuovere le virgolette. Ciò vale anche per le chiavi esterne nei comandi curl. Questo comando dell'interfaccia CLI mostra il parametro --external-key e il valore corrispondente che non contiene virgolette:

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

    Senza un ID autenticazione, un modello gemello digitale o un adattatore gemello digitale:

    Questo comando di esempio mostra come creare un'istanza gemella digitale senza un adattatore gemello digitale, un modello gemello digitale o un ID di autenticazione e include il parametro chiave esterna facoltativo.

    Sostituire la chiave esterna con una chiave esterna per il dispositivo. La chiave esterna deve essere univoca e può essere un valore di testo descrittivo oppure è possibile utilizzare l'indirizzo MAC o il numero di serie del dispositivo.

    In questo esempio il valore --external-key non contiene virgolette: 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

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

  • Eseguire l'operazione CreateDigitalTwinInstance per creare un'istanza gemella digitale.