シナリオ: IoTドメインの使用

次のコマンドを使用して、IoTドメインの詳細を取得します:

oci iot domain get --iot-domain-id <iot-domain-OCID>

この例は、IoTドメインがアクティブであることを示しています。次のアイデンティティ・ドメイン・グループ名および許可アイデンティティ・ドメイン・ホスト・パラメータはnullです。データベース接続の詳細がまだ定義されていないため、これは予想される結果です。データベースへの直接接続を確立する場合は、次のステップでIoTドメインのデータ・アクセスを構成する必要があります。

"db-allow-listed-identity-group-names": null,

{
  "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-09-08T09:47:17.759Z"
      }
    },
    "description": "<your-description>",
    "device-host": "<domain-short-id>.device.iot.<region>.oci.oraclecloud.com",
    "display-name": "<your-display-name>",
    "freeform-tags": {},
    "id": "<iot-domain-OCID>",
    "iot-domain-group-id": "<iot-domain-group-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-09-08T09:47:17.987000+00:00",
    "time-updated": "2025-09-08T09:49:23.223000+00:00"
  },
  "etag": "<unique-id>"
}

オプションで、データベース内のIoTデータを直接表示する場合、またはOracle Analytics Cloud内のデータを表示するためにデータベース接続を構成する場合、またはデータベース内で直接表示する場合は、oci iot domain configure-direct-data-accessコマンドを使用して、構成時にアイデンティティ・ドメイン・グループまたはグループ設定を使用してデータベースにアクセスするためにIoTドメインの認証を構成します。

<identity-domain-name>パラメータに、次のいずれかのオプションを入力します。<identity-group-name>は、アイデンティティ・グループまたはアイデンティティ動的グループのいずれかです。

• <identity-group-name>がデフォルトのアイデンティティ・ドメインにある場合は、次の形式を使用します。

  <tenancy-OCID:<identity-group-name>

• <identity-group-name>がデフォルトのアイデンティティ・ドメインにない場合は、この形式を使用して、アイデンティティ・ドメイン・グループまたはアイデンティティ・ドメインの動的グループのアイデンティティ・ドメイン名を指定します。

  <tenancy-OCID>:<identity-domain-name>/<identity-group-name>

oci iot domain configure-direct-data-access --iot-domain-id <iot-domain-OCID> --db-allow-listed-identity-group-names '["<tenancy-OCID>:<identity-group-name>"]'

この例は、構成され、データベースへの接続が許可されているデフォルトのアイデンティティ・ドメインにない複数のアイデンティティ動的グループを示しています。動的グループが構成されたVCNでアプリケーションまたはユーザーが実行されている場合は、次の形式を使用します:

oci iot domain configure-direct-data-access --iot-domain-id <iot-domain-OCID> --db-allow-listed-identity-group-names '["<tenancy-OCID>:<identity-domain-name>/<identity-group-name>", "<tenancy-OCID>:<identity-domain-name>/<identity-group-name>"]'

データベースへの直接接続を構成するステップの完全なリストは、シナリオ: IoTデータベースへの直接接続を参照するか、Oracle Analytics CloudでIoTデータを表示するためのアクセスを構成するステップの完全なリストは、シナリオ: Analytics CloudへのIoTデータの接続を参照してください。

IoTデータAPIを使用するか、Oracle REST Data Services (ORDS)でデータを表示する場合は、ORDSへの接続の構成を完了する必要があります。

構成の一部として、oci iot domain configure-ords-data-accessコマンドを使用して、アイデンティティ・ドメイン・ホストへのアクセスを構成します。

idcs-<idcs-id>.identity.oraclecloud.comを、使用する環境のアイデンティティ・ドメイン・ホストおよびIoTドメインのOCIDに置き換えます。

oci iot domain configure-ords-data-access --iot-domain-id <iot-domain-OCID> --db-allowed-identity-domain-host <idcs-unique-id.identity.oraclecloud.com>

ORDS内のデータを表示するためのアクセスを構成するステップの完全なリストは、シナリオ: IoTデータのOracle REST Data Services (ORDS)への接続を参照してください。

IoTデータAPIを使用するか、Oracle Application Express (APEX)でデータを表示する場合は、APEXへの接続の構成を完了する必要があります。

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

oci iot domain get --iot-domain-id <iot-domain-OCID>

このレスポンス例では、IoTドメインに現在定義されているデータベース接続の詳細が含まれています。

{
  "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": [
      "<tenancy-OCID>:<identity-domain-name>/<identity-group-name>"
    ],
  "db-allowed-identity-domain-host": "<idcs-unique-id.identity.oraclecloud.com>",
  "defined-tags": {
    "Oracle-Tags": {
      "CreatedBy": "default/user@oracle.com",
      "CreatedOn": "2025-08-05T18:02:51.633Z"
    }
  },
  "description": "<your-description>",
  "device-host": "<domain-short-id>.device.iot.<region>.oci.oraclecloud.com",
  "display-name": "<your-display-name>",
  "freeform-tags": {},
  "id": "<iot-domain-OCID>",
  "iot-domain-group-id": "<iot-domain-group-OCID>",
  "lifecycle-state": "ACTIVE",
  "system-tags": {},
  "time-created": "2025-08-05T18:02:53.418000+00:00",
  "time-updated": "2025-08-05T18:04:42.585000+00:00"
}