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 esempi specifici di impostazione delle istanze dei gemelli digitali, vedere Scenari.
- 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 creare un certificato nella stessa area e tenancy di qualsiasi altra risorsa IoT correlata. Per un esempio specifico, vedere Scenario: Create a Digital Twin Instance that using a mTLS Certificate. Utilizzare l'OCID del certificato o l'OCID segreto del vault come valore per il parametro
--auth-id. Se un'istanza digital twin contiene un ID di autenticazione, non richiede un modello digital twin. Ad esempio, Scenario: invio di dati non strutturati mediante HTTP. - 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.
- 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 creare un certificato nella stessa area e tenancy di qualsiasi altra risorsa IoT correlata. Per un esempio specifico, vedere Scenario: Create a Digital Twin Instance that using a mTLS Certificate. Utilizzare l'OCID del certificato o l'OCID segreto del vault come valore per il parametro
- 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-idper 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-keyquando 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.
- Uso di una chiave esterna con un ID di autenticazione del certificato mTLS: quando si crea un'istanza gemella digitale, il parametro
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:
Per ulteriori informazioni, vedere Creazione di un adattatore Digital Twin.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>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 comandicurl. Questo comando dell'interfaccia CLI mostra il parametro--external-keye il valore corrispondente che non contiene virgolette:--external-key 01-23-45-67-89-abSenza 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-keynon contiene virgolette:01-23-45-67-89-aboci iot digital-twin-instance create --iot-domain-id <iot-domain-OCID> --external-key 01-23-45-67-89-abPer 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.