Szenario: Strukturierte Daten mit HTTPs in einem Standardformat senden

Verwenden Sie den Befehl oci iot digital-twin-adapter create, um einen digitalen Zwillingsadapter zu erstellen. Ersetzen Sie <iot-domain-OCID> durch die OCID der IoT-Domain. Um das digitale Zwillingsmodell zu verknüpfen, verwenden Sie entweder den DTMI-URI-Parameter --digital-twin-model-spec-uri oder den Parameter für die OCID des digitalen Zwillings --digital-twin-model-id, um das digitale Zwillingsmodell mit diesem digitalen Zwillingsadapter zu verknüpfen.

In diesem Beispiel wird der Befehl mit dem Parameter --digital-twin-model-spec-uri verwendet. Ersetzen Sie dtmi:com:oracle:example:hvac;1 durch den DTMI-URI für das digitale Zwillingsmodell, das Sie diesem digitalen Zwillingsadapter zuordnen möchten:

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

Verwenden Sie die Parameter oci iot digital-twin-instance create und <iot-domain-OCID>, <vault-secret-OCID> und <digital-twin--adapter-OCID>, um eine digitale Zwillingsinstanz für strukturierte Daten zu erstellen.

Ersetzen Sie <iot-domain-OCID> durch die OCID für die IoT-Domain, die Sie aktualisieren möchten. Optional können Sie den Anzeigeparameter einbeziehen und <display-name> durch einen benutzerfreundlichen Namen für die Instanz des digitalen Zwillings ersetzen.

Ersetzen Sie <digital-twin--adapter-OCID> durch die OCID des Digital Twin-Adapters, die im vorherigen Schritt erstellt wurde. Ersetzen Sie <vault-secret-OCID> durch ein Secret, das sich in derselben Region wie Ihre anderen digitalen Zwillingsressourcen befindet. Oracle empfiehlt, für jede digitale Zwillingsinstanz ein eindeutiges Secret zu verwenden. Weitere Informationen finden Sie unter Secret erstellen.

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

Weitere Informationen finden Sie in der Dokumentation zur Internet of Things-(IoT-)Daten-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>\"}]}"

In diesem Beispiel werden HTTPs verwendet. Alternativ können Sie MQTT und MQTT über WebSockets verwenden. Spezielle Beispiele finden Sie unter Szenarios.

Mit dieser SQL-Anweisung können Sie die Telemetriedaten rejected anzeigen. Ersetzen Sie <domain-short-id-from-device-host> durch die Domain-Kurz-ID von Ihrem Gerätehost, und ersetzen Sie <digital-twin-OCID> durch die OCID des digitalen Zwillings, aus der Sie die abgelehnten Daten anzeigen möchten:

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>';

Um die <domain-short-id-from-device-host> für die Domain IoT abzurufen, holen Sie die Details für die Domain IoT, mit der Sie arbeiten möchten.