Creazione di un dominio IoT

Creare un dominio Internet of Things (IoT) associato a un gruppo di domini IoT. Quando crei risorse digital twin per un dispositivo, associ tutte le risorse digital twin correlate a un dominio IoT specifico.

Per ogni dominio IoT vengono creati un endpoint di dispositivo univoco e uno schema di database dedicato con un ID breve del dominio.

  • device-host:<domain-short-id-from-device-host>.device.iot.<region>.oci.oraclecloud.com
  • Schema di database di sola lettura con le definizioni dei gemelli digitali e i dati di telemetria inviati da e verso il dispositivo: <domain-short-id-from-device-host>__IOT
Nota

È possibile creare fino a 2 domini IoT in ogni gruppo di domini IoT. Il numero massimo di gruppi di domini IoT è 5 e il numero massimo di domini IoT è 10 per ogni area della tenancy. Per creare un dominio IoT, l'utente deve disporre dell'accesso in lettura per il gruppo di domini IoT associato.

Tutte le risorse IoT devono trovarsi nella stessa area.

    1. Nella pagina elenco Dominio, selezionare Crea dominio. Se è necessaria assistenza per trovare la pagina di elenco dei domini IoT, vedere Elenco dei domini IoT.
    2. Immettere un nome riconoscibile dall'utente per il dominio IoT. Evitare di fornire informazioni riservate.
    3. Immettere una descrizione (facoltativo).
    4. Selezionare un compartimento in cui si desidera memorizzare i domini IoT. Il gruppo di domini IoT e il dominio IoT possono trovarsi in compartimenti diversi. Le tue risorse IoT possono trovarsi in compartimenti diversi, ma devono trovarsi nella stessa area.
    5. Selezionare il compartimento del gruppo di domini associato e selezionare il gruppo di domini da associare a questo dominio. Se non sono presenti gruppi di domini, creare un gruppo di domini.
    6. Selezionare Crea.
      Ora è possibile visualizzare la richiesta di lavoro per la creazione del dominio, inclusi l'operazione della richiesta di lavoro, lo stato del ciclo di vita, il % di completamento e la data e l'ora per lo stato accettato, avviato e finito per la richiesta di lavoro.

      Ad esempio, se il dominio viene creato correttamente, lo stato viene visualizzato come accettato e pochi secondi dopo come riuscito e la percentuale di completamento a 100.

      Selezionare il nome del dominio per visualizzare i dettagli del dominio.

      Azioni

      I dettagli del dominio visualizzano i seguenti dettagli sul dominio, quindi selezionano i collegamenti o le schede per accedere a queste opzioni.

      • Visualizzare i dettagli per il dominio, inclusi il nome, la descrizione, l'OCID, il gruppo di domini associato, il compartimento, inclusi la data e l'ora in cui il dominio è stato creato e aggiornato.
      • Selezionare il nome del gruppo di domini per visualizzare i dettagli del gruppo di domini associato.
      • Visualizza e copia gli endpoint dell'host del dispositivo per il dominio, mentre l'host del dispositivo visualizza l'ID breve del dominio. Selezionare Copia per copiare questo endpoint.

        device-host:<domain-short-id>.device.iot.<region>.oci.oraclecloud.com

      • Tempo di conservazione dei dati: per qualsiasi tipo di dati, selezionare Aumenta per aggiornare il numero di giorni. È possibile aumentare solo il numero di giorni. Il valore predefinito è 16 giorni per i dati raw, i dati rifiutati e i dati raw del comando. Il valore predefinito per i dati storicizzati è 30 giorni.
        • Dati raw: raccolta di record contenenti dati raw ricevuti da un dispositivo IoT. Ciò include un endpoint, il tempo ricevuto, il tipo di contenuto e il contenuto effettivo.
        • Dati storicizzati: se il contenuto del modello digital twin è contrassegnato per la cronologia, i dati delle serie temporali per le istanze digital twin vengono raccolti per ogni dominio IoT.
        • Dati rifiutati: raccolta di record rifiutati contenenti dati non elaborati ricevuti da un dispositivo IoT. Questo include codice e un messaggio dettagliato contenente il motivo del rifiuto.
        • Dati dei comandi raw: i comandi dei dati raw vengono inviati alle istanze digital twin nel dominio IoT insieme a tutti i dettagli della risposta, incluso lo stato di consegna.
      • Scheda Monitoraggio: consente di visualizzare le metriche per un dominio IoT. Per ogni grafico delle metriche è possibile visualizzare la query in Metrics Explorer, copiare l'URL del grafico, copiare MQL o creare un allarme in una query.

        Per un elenco di grafici e dettagli delle metriche, vedere Internet of Things Metrics Reference, Visualizzazione delle metriche dal servizio di monitoraggio e Modifica dell'espressione MQL per una query.

      Selezionare il menu Azioni per effettuare le operazioni riportate di seguito.
      • Modifica accesso ai dati: selezionare il tipo di accesso per questo dominio,
        • Accesso diretto ai dati: immettere un gruppo di identità IAM a cui è consentito connettersi all'host dati del gruppo di domini associato. Per aggiungere più gruppi di identità per accedere ai dati per questo dominio IoT, selezionare Aggiungi un altro gruppo di identità.

          Immettere una qualsiasi delle opzioni del gruppo di identità IAM riportate di seguito. Un valore <identity-group-name> è il gruppo di utenti Identity o un gruppo dinamico Identity. Il numero massimo consentito di nomi di gruppi di identità è 5.

          • Se <identity-group-name> si trova nel dominio di Identity predefinito, utilizzare il seguente formato:

            <tenancy-OCID>:<identity-group-name>

          • Se <identity-group-name> non si trova nel dominio di Identity predefinito, utilizzare questo formato per specificare il nome del dominio di Identity per il gruppo di utenti del dominio di Identity o il gruppo dinamico di Identity:

            <tenancy-OCID>:<identity-domain-name>/<identity-group-name>

        • Accesso a Oracle REST Data Services (ORDS): immettere il nome host del dominio di Identity del database per la connessione host dati ORDS.

          idcs-<unique-id>.identity.oraclecloud.com

        • Accesso a Oracle Application Express (APEX): immettere la password APEX iniziale per l'area di lavoro APEX per il dominio IoT: <your-apex-initial-password>

          Per ulteriori informazioni, vedere Configurazione dell'accesso ai dati di un dominio IoT.

      • Selezionare Aggiorna.
      • Sposta la risorsa: selezionare il compartimento di destinazione per spostare il dominio in un altro compartimento. Selezionare Sposta risorsa.
      • Elimina: selezionare Elimina per eliminare il dominio.
      • Selezionare Modifica per modificare i dettagli di questo dominio.
  • Utilizzare il comando oci iot domain create e i parametri richiesti per creare un dominio IoT.

    Sostituire <iot-domain-group-OCID> con il gruppo di domini IoT che si desidera associare al dominio IoT. Sostituire <compartment-OCID> con l'OCID del compartimento per il dominio IoT:

    oci iot domain create --compartment-id <compartment-OCID> --iot-domain-group-id <iot-domain-group-OCID>

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

  • Eseguire l'operazione CreateIotDomain per creare un dominio IoT.