Scenario: invio di dati non strutturati mediante HTTP

Utilizzare il comando oci iot domain-group create, <compartment-OCID> e i parametri richiesti <domain-group-name> per creare un gruppo di domini IoT in un compartimento specifico. Sostituire <compartment-OCID> con l'OCID per il compartimento in cui si desidera creare il gruppo di domini. Sostituire <domain-group-name> con il nome del gruppo di domini e, facoltativamente, sostituire <your-sample-description> con una descrizione:

oci iot domain-group create --compartment-id <compartment-OCID> --display-name <domain-group-name> --description <your-sample-description>

La creazione di un gruppo di domini IoT può richiedere alcuni minuti. Questa risposta di esempio mostra che il gruppo di domini sta creando e utilizza questo URL host dati:

wtmn2xs4ifkba.data.iot.us-phoenix-1.oci.oraclecloud.com

ID breve del gruppo di domini: wtmn2xs4ifkba

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

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-host": "wtmn2xs4ifkba.data.iot.<region>.oci.oraclecloud.com",
    "db-allow-listed-vcn-ids": null,
    "db-connection-string": null,
    "db-token-scope": null,
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-14T16:43:02.950Z"
      }
    },
    "description": "<your-domain-group-description>",
    "display-name": "<your-domain-group-name>",
    "freeform-tags": {},
    "id": "<domain-group-OCID>",
    "lifecycle-state": "CREATING",
    "system-tags": {},
    "time-created": "2025-08-14T16:43:03.307000+00:00",
    "time-updated": "2025-08-14T16:43:03.307000+00:00"
  },
  "etag": "<unique-id>",
  "opc-work-request-id": "<work-request-OCID>"
}
        

Utilizzare il comando oci iot domain create e i parametri <domain-group-OCID> e <compartment-OCID> richiesti per creare un dominio Internet of Things. Sostituire <domain-group-OCID> con l'OCID per il gruppo di domini che si desidera associare a questo dominio IoT. Sostituire <your-sample-description> con una descrizione per il dominio IoT.

oci iot domain create --compartment-id <compartment-OCID> --iot-domain-group-id <domain-group-OCID> --display-name <your-iot-domain-name> --description <your-iot-domain-description>

La creazione di un dominio può richiedere alcuni minuti. In questa risposta di esempio viene visualizzato l'URL dell'host del dispositivo con l'ID breve del dominio:

"device-host": "cuay2mrhlgrrg.device.iot.<region>.oci.oraclecloud.com"

ID breve del dominio: cuay2mrhlgrrg

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

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-retention-periods-in-days": {
      "historized-data": 30,
      "raw-command-data": 16,
      "raw-data": 16,
      "rejected-data": 16
    },
    "db-allow-listed-identity-group-names": null,
    "db-allowed-identity-domain-host": null,
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-14T16:57:03.140Z"
      }
    },
    "description": "<your-iot-domain-description>",
    "device-host": "cuay2mrhlgrrg.device.iot.<region>.oci.oraclecloud.com",
    "display-name": "<your-iot-domain-name>",
    "freeform-tags": {},
    "id": "<iot-domain-OCID>",
    "iot-domain-group-id": "<iot-domain-group-OCID>",
    "lifecycle-state": "CREATING",
    "system-tags": {},
    "time-created": "2025-08-14T16:57:03.384000+00:00",
    "time-updated": "2025-08-14T16:57:03.384000+00:00"
  },
  "etag": "<unique-id>",
  "opc-work-request-id": "<work-request-OCID>"
}

Utilizzare il comando oci iot digital-twin-instance create e il parametro <iot-domain-OCID> richiesto per creare un'istanza digital twin per un dominio IoT associato. Quando si crea un'istanza di gemello digitale, è necessario un ID di autenticazione. Utilizzare un certificato o un segreto. Vedere Creazione di un segreto.

oci iot digital-twin-instance create --iot-domain-id <iot-domain-OCID> --auth-id <vault-secret-OCID> --display-name <display-name>

{
  "data": {
    "auth-id": "<vault-secret-OCID>",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-14T06:12:43.393Z"
      }
    },
    "description": null,
    "digital-twin-adapter-id": "<iot-digital-twin-adapter-OCID>",
    "digital-twin-model-id": "<iot-digital-twin-model-OCID>",
    "digital-twin-model-spec-uri": "dtmi:com:oracle:example:core:Space:sp;1",
    "display-name": "device for conference room 103",
    "external-key": "<unique-id>",
    "freeform-tags": {},
    "id": "<iot-digital-twin-instance-OCID>",
    "iot-domain-id": "<iot-domain-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-09-11T06:12:44.178000+00:00",
    "time-updated": "2025-09-11T06:12:44.178000+00:00"
  },
  "etag": "<unique-id>"
}

Inviare i dati utilizzando l'URL dell'host del dispositivo indicato nel passo precedente.

Puoi inviare tutti i dati che vuoi inviare. Questo esempio mostra l'invio di 2 messaggi di dati in testo semplice. Il primo esempio mostra il comando che utilizza i valori di questo scenario. Il secondo comando mostra i nomi dei valori. Per ulteriori informazioni, vedere Uso di cURL.

Sostituire <domain-short-id> e <region> con i valori dell'ambiente in uso:

https://<domain-short-id>.device.iot.<region>.oci.oraclecloud.com/sampletopic

curl -u '9K7F8Y3HJGX1FA1GFG9QVV9E2C<vault-secret-OCID>' https://<domain-short-id>.device.iot.us-phoenix-1.oci.oraclecloud.com/sampletopic -H 'Content-Type: plain-text' -d "sample data 2"

curl -u '<external-key>:<vault-secret-OCID>' https://<domain-short-id>.device.iot.<region>.oci.oraclecloud.com/sampletopic -H 'Content-Type: plain-text' -d "sample data 1"

Per visualizzare i dati in APEX è necessario configurare l'accesso per visualizzare i dati IoT in APEX, un passo di tale processo utilizza il comando seguente per aggiungere la password APEX al dominio IoT in modo che possa accedere ad APEX.

oci iot domain configure-apex-data-access --iot-domain-id <iot-domain-OCID> --db-workspace-admin-initial-password <your-inital-apex-password>

Risposta di esempio:

{
  "opc-work-request-id": "<work-request-OCID>"
}

1. Utilizzare l'ID breve del dominio proveniente dall'host del dispositivo per eseguire il login ad APEX:

   https://<domain-group-short-id-from-data-host>.data.iot.<region>.oci.oraclecloud.com/ords/r/apex

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

   In APEX eseguire il login utilizzando:

   • Database: <domain-short-id-from-device-host>__WKSP
   • Nome utente:<domain-short-id-from-device-host>__WKSP
   • Password iniziale impostata quando si utilizzò il comando CLI per configurare l'accesso ai dati di un dominio IoT per APEX: <initial-apex-password>

   Nota
   
   I due caratteri di sottolineatura sono: __WKSP e __IOT.
2. Per eseguire una query sui dati IoT, selezionare lo schema <domain-short-id-from-device-host>__IOT. Selezionare SQL Workshop, quindi selezionare Browser oggetti.

   URL del workshop SQL:

   https://<domain-group-short-id-from-data-host>.data.iot.<region>.oci.oraclecloud.com/ords/r/apex/sql-workshop

3. Eseguire una query sui dati IoT immettendo ed eseguendo un comando SQL. Confermare di aver selezionato lo schema corretto per la tabella di database di cui si desidera eseguire una query, eseguire il comando seguente:

   select * from RAW_DATA

   Ora è possibile visualizzare le viste del database, gli schemi e i dati raw per il dispositivo connesso a Internet of Things.

   Per visualizzare uno screenshot più grande, fare clic con il pulsante destro del mouse e aprire l'immagine in una nuova finestra del browser.