シナリオ: HTTPを使用したデフォルト形式での構造化データの送信

oci iot digital-twin-adapter createコマンドを使用して、デジタル・ツイン・アダプタを作成します。<iot-domain-OCID>をIoTドメインOCIDに置き換えます。デジタル・ツイン・モデルを関連付けるには、DTMI URIパラメータ--digital-twin-model-spec-uriまたはデジタル・ツインOCID --digital-twin-model-idパラメータのいずれかを使用して、デジタル・ツイン・モデルをこのデジタル・ツイン・アダプタに関連付けます。

この例では、--digital-twin-model-spec-uriパラメータを指定してコマンドを使用します。dtmi:com:oracle:example:hvac;1を、このデジタル・ツイン・アダプタに関連付けるデジタル・ツイン・モデルのDTMI URIに置き換えます。

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

構造化データのデジタル・ツイン・インスタンスを作成するには、oci iot digital-twin-instance createおよび<iot-domain-OCID>、<vault-secret-OCID>および<digital-twin--adapter-OCID>の必須パラメータを使用します。

<iot-domain-OCID>を、更新するIoTドメインのOCIDに置き換えます。オプションで、表示パラメータを含め、<display-name>をデジタル・ツイン・インスタンスのわかりやすい名前に置き換えることができます。

<digital-twin--adapter-OCID>を、前のステップで作成したデジタル・ツイン・アダプタOCIDに置き換えます。<vault-secret-OCID>を、他のデジタル・ツイン・リソースと同じリージョンにあるシークレットに置き換えます。Oracleでは、デジタル・ツイン・インスタンスごとに一意のシークレットを使用することをお薦めします。詳細は、シークレットの作成に関する項を参照してください。

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

詳細は、Internet of Things (IoT)データ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>\"}]}"

この例では、HTTPを使用します。または、MQTTおよびMQTTをWebSockets上で使用できます。具体的な例は、シナリオを参照してください。

このSQL文を使用して、rejectedテレメトリ・データを表示します。<domain-short-id-from-device-host>をデバイス・ホストからのドメイン短縮IDに置き換え、<digital-twin-OCID>を、拒否されたデータを表示するデジタル・ツインのOCIDに置き換えます:

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

IoTドメインの<domain-short-id-from-device-host>を取得するには、作業するIoTドメインの詳細を取得します。