Escenario: envío de datos no estructurados mediante HTTP

Utilice el comando oci iot domain-group create y los parámetros necesarios <compartment-OCID> y <domain-group-name> para crear un grupo de dominios IoT en un compartimento específico. Sustituya el <compartment-OCID> por el OCID del compartimento en el que desea crear el grupo de dominios. Sustituya <domain-group-name> por el nombre del grupo de dominios y, opcionalmente, sustituya <your-sample-description> por una descripción:

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

La creación de un grupo de dominios IoT puede tardar unos minutos. En este ejemplo de respuesta se muestra que el grupo de dominios está creando y utiliza esta URL de host de datos:

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

domain group short id: 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>"
}
        

Utilice el comando oci iot domain create y los parámetros <domain-group-OCID> y <compartment-OCID> necesarios para crear un dominio de Internet of Things. Sustituya <domain-group-OCID> por el OCID del grupo de dominios que desea asociar a este dominio IoT. Sustituya <your-sample-description> por una descripción para el 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 creación de un dominio puede tardar unos minutos. En esta respuesta de ejemplo, se muestra la URL del host de dispositivo con el domain short id:

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

ID corto de 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>"
}

Utilice el comando oci iot digital-twin-instance create y el parámetro <iot-domain-OCID>necesario para crear una instancia de gemelo digital para un dominio IoT asociado. Al crear una instancia de gemelo digital, necesita un ID de autenticación. Utilice un certificado o secreto. Consulte Creación de un secreto.

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>"
}

Envíe datos mediante la URL del host de dispositivo del paso anterior.

Puede enviar tantos datos como desee. Este ejemplo muestra el envío de 2 mensajes de datos de texto sin formato. El primer ejemplo muestra el comando utilizando valores de este escenario. El segundo comando muestra los nombres de valores. Para obtener más información, consulte Uso de cURL.

Sustituya <domain-short-id> y <region> por los valores de su entorno:

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"

Para ver los datos en APEX, es necesario configurar el acceso para ver los datos de IoT en APEX. En un paso de ese proceso se utiliza el siguiente comando para agregar la contraseña de APEX al dominio IoT para que pueda acceder a APEX.

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

Ejemplo de respuesta:

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

1. Utilice el domain short id que proviene del host de dispositivo para iniciar sesión en 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

   En APEX, conéctese mediante:

   • Base de datos: <domain-short-id-from-device-host>__WKSP
   • Nombre de usuario:<domain-short-id-from-device-host>__WKSP
   • Contraseña inicial definida al usar el comando de la CLI para configurar el acceso a datos de un dominio IoT para APEX: <initial-apex-password>

   Nota
   
   Utilice solo mayúsculas para <domain-short-id-from-device-host> y observe los dos caracteres de subrayado: __WKSP
2. Para consultar los datos IoT, seleccione el esquema <domain-short-id-from-device-host>__IOT. Seleccione SQL Workshop y, a continuación, Object Browser.

   URL del taller SQL:

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

3. Consulte los datos IoT introduciendo y ejecutando un comando SQL. Confirme que ha seleccionado el esquema correcto para la tabla de base de datos que desea consultar y ejecute el siguiente comando:

   select * from RAW_DATA

   Ahora, puede ver las vistas de base de datos, los esquemas y los datos raw del dispositivo conectado a Internet of Things.

   Para ver una captura de pantalla más grande, haga clic con el botón derecho y abra la imagen en una nueva ventana del explorador.