Cenário: Enviando Dados Estruturados em um Formato Padrão usando HTTPs

Use o comando oci iot digital-twin-adapter create para criar um adaptador de gêmeo digital. Substitua o <iot-domain-OCID> pelo OCID do domínio IoT. Para associar o modelo de gêmeo digital, use o parâmetro --digital-twin-model-spec-uri do URI do DTMI ou o parâmetro --digital-twin-model-id do OCID do gêmeo digital para associar o modelo de gêmeo digital a este adaptador de gêmeo digital.

Este exemplo usa o comando com o parâmetro --digital-twin-model-spec-uri. Substitua o dtmi:com:oracle:example:hvac;1 pelo URI DTMI do modelo de gêmeo digital que você deseja associar a este adaptador de gêmeo 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>"
}

Use os parâmetros necessários oci iot digital-twin-instance create e <iot-domain-OCID>, <vault-secret-OCID> e <digital-twin--adapter-OCID> para criar uma instância de gêmeo digital para dados estruturados.

Substitua o <iot-domain-OCID> pelo OCID do domínio IoT que você deseja atualizar. Opcionalmente, você pode incluir o parâmetro de exibição e substituir o <display-name> por um nome amigável para a instância de gêmeo digital.

Substitua o <digital-twin--adapter-OCID> pelo OCID do adaptador de gêmeo digital criado na etapa anterior. Substitua o <vault-secret-OCID> por um segredo que esteja na mesma região que seus outros recursos de gêmeos digitais. A Oracle recomenda o uso de um segredo exclusivo para cada instância de gêmeo digital. Para obter mais informações, consulte Criando um Segredo.

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 obter mais informações, consulte a documentação da Internet of Things (IoT) Data API.

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

Este exemplo usa HTTPs. Como alternativa, você pode usar MQTT e MQTT em WebSockets. Para obter exemplos específicos, consulte Cenários.

Use esta instrução SQL para exibir os dados de telemetria rejected. Substitua o <domain-short-id-from-device-host> pelo id curto do domínio do host do dispositivo e substitua o <digital-twin-OCID> pelo OCID do gêmeo digital do qual você deseja exibir os dados rejeitados:

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 obter o <domain-short-id-from-device-host> do domínio IoT, obtenha os detalhes do domínio IoT com o qual você deseja trabalhar.