Escenario: Envío de datos estructurados en un formato por defecto mediante HTTP

Utilice el comando oci iot digital-twin-adapter create para crear un adaptador gemelo digital. Sustituya <iot-domain-OCID> por el OCID del dominio IoT. Para asociar el modelo de gemelo digital, utilice el parámetro URI de DTMI --digital-twin-model-spec-urio el parámetro OCID --digital-twin-model-id de gemelo digital para asociar el modelo de gemelo digital a este adaptador de gemelo digital.

En este ejemplo se utiliza el comando con el parámetro --digital-twin-model-spec-uri. Sustituya dtmi:com:oracle:example:hvac;1 por el URI de DTMI para el modelo de gemelo digital que desea asociar a este adaptador de gemelo digital:

oci iot digital-twin-adapter create --iot-domain-id <iot-domain-OCID> --digital-twin-model-spec-uri "dtmi:com:oracle:example:hvac;1"

oci iot digital-twin-adapter create --iot-domain-id <iot-domain-OCID> --digital-twin-model-id <digital-twin-model-OCID>

{
  "data": {
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user",
        "CreatedOn": "2025-09-10T17:45:41.318Z"
      }
    },
    "description": null,
    "digital-twin-model-id": "<digital-twin-model-OCID>",
    "digital-twin-model-spec-uri": "dtmi:com:oracle:example:hvac;1",
    "display-name": "<your-digital-twin-adapter-name>",
    "freeform-tags": {},
    "id": "<digital-twin-adapter-OCID>",
    "inbound-envelope": {
      "envelope-mapping": {
        "time-observed": "$.time"
      },
      "reference-endpoint": "/",
      "reference-payload": {
        "data": {
          "humidity": 0,
          "location": {
            "coordinates": [0.0, 0.0],
            "type": "Point"
          },
          "temperature": 0,
          "time": "2025-09-10T17:45:41.387069258Z"
        },
        "data-format": "JSON"
      }
    },
    "inbound-routes": [
      {
        "condition": "*",
        "description": "Default condition",
        "payload-mapping": {
          "$.humidity": "$.humidity",
          "$.location": "$.location",
          "$.temperature": "$.temperature"
        },
        "reference-payload": null
      }
    ],
    "iot-domain-id": "<iot-domain-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-09-10T17:45:41.389000+00:00",
    "time-updated": "2025-09-10T17:45:41.389000+00:00"
  },
  "etag": "<unique-id>"
}

Utilice los parámetros necesarios oci iot digital-twin-instance create y <iot-domain-OCID>, <vault-secret-OCID> y <digital-twin--adapter-OCID> para crear una instancia de gemelo digital para los datos estructurados.

Sustituya <iot-domain-OCID> por el OCID del dominio IoT que desea actualizar. Opcionalmente, puede incluir el parámetro de visualización y sustituir <display-name> por un nombre fácil de recordar para la instancia de gemelo digital.

Sustituya <digital-twin--adapter-OCID> por el OCID del adaptador de gemelo digital creado en el paso anterior. Sustituya <vault-secret-OCID> por un secreto que se encuentre en la misma región que sus otros recursos de gemelos digitales. Oracle recomienda utilizar un secreto único para cada instancia de gemelo digital. Para obtener más información, consulte Crear un secreto.

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

{
  "data": {
    "auth-id": "<vault-secret-OCID>",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-09-11T06: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:hvac;1",
    "display-name": "your display name",
    "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>"
}

Para obtener más información, consulte la documentación de la API de datos de Internet of Things (IoT).

curl -H "Authorization: Bearer <token>" \
              -X GET "https://<domain-group-short-id>.data.iot.<region>.oci.oraclecloud.com/ords/<domain-short-id>/20250531/rawData?q={\"$and\":[{\"digital_twin_instance_id\":\"<iot-digital-twin-OCID>\"}]}"

En este ejemplo se utilizan HTTP. También puede utilizar MQTT y MQTT en WebSockets. Para ver ejemplos específicos, consulte Escenarios.

Utilice esta sentencia SQL para ver los datos de telemetría rejected. Sustituya <domain-short-id-from-device-host> por el ID corto de dominio del host de dispositivo y sustituya <digital-twin-OCID> por el OCID del gemelo digital desde el que desea ver los datos rechazados:

select * from <domain-short-id-from-device-host>__IOT.REJECTED_DATA where digital_twin_instance_id = '<digital-twin-instance-OCID>';

select * from <domain-short-id-from-device-host>__IOT.DIGITAL_TWIN_HISTORIZED_DATA where digital_twin_instance_id = '<digital-twin-instance-OCID>';

select * from <domain-short-id-from-device-host>__IOT.RAW_DATA where digital_twin_instance_id = '<digital-twin-instance-OCID>';

Para obtener el valor <domain-short-id-from-device-host> para el dominio IoT, obtenga los detalles del dominio IoT con el que desea trabajar.