シナリオ: IoTドメイン・グループの使用

管理者は、テナンシおよび使用するコンパートメントにポリシーを追加する必要があります。ポリシーの例および前提条件については、Internet of Things (IoT)プラットフォームのポリシー詳細およびIoTの前提条件を参照してください。

適用可能なリソース制限のリストおよび制限の引上げをリクエストする手順は、Internet of Thingsリソースの制限を参照してください。

ドメインを作成する前に、ドメイン・グループを設定する必要があります。各IoTドメイン・グループは、IoTドメイン・グループに関連付けられたすべてのIoTドメインで共有される専用データベース・インスタンスを使用します。

oci iot domain-group create --compartment-id <compartment-OCID> --display-name <your-iot-domain-group-name>

レスポンス例は、ドメイン・グループが作成され、ドメイン・グループの短縮IDを持つデータ・ホストURLが含まれていることを示しています。データ・ホストURLを使用して、関連するIoTドメインのすべてのデバイスを含む特定のIoTドメイン・グループに関連付けられたメタデータおよびデータにアクセスします。

data-host:<domain-group-short-id>.data.iot.<region>.oci.oraclecloud.com

データベース接続の詳細がnullであることを確認します。ドメイン・グループの作成後、データを表示する場所に応じて、関連するIoTドメインのデータ・アクセスを構成して、別のシステムに接続するためのIoTドメインの認証詳細を追加する必要があります。

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-host": "<domain-group-short-id>.data-iot.<region>.oci.oraclecloud.com,
    "db-allow-listed-vcn-ids": null,
    "db-connection-string": null,
    "db-token-scope": null,
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-05T18:15:41.260Z"
      }
    },
    "description": null,
    "display-name": "<your-iot-domain-group-name>",
    "freeform-tags": {},
    "id": "<domain-group-OCID>",
    "lifecycle-state": "CREATING",
    "system-tags": {},
    "time-created": "2025-08-05T18:15:43.054000+00:00",
    "time-updated": "2025-08-05T18:15:43.054000+00:00"
  },
  "etag": "<unique-id>",
  "opc-work-request-id": "<work-request-OCID>"
            }

オプションで、ドメイン・グループを使用するこのプロセス中に、各操作の作業リクエストをモニターして、次の操作に進む前に成功したかどうかを確認できます。作業リクエストを使用して、ログまたはエラー・メッセージを確認できます。

任意の操作から"opc-work-request-id": "<work-request-OCID>"を使用して、その特定の操作の関連作業リクエストを取得します。たとえば:

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

このレスポンス例では、IoTドメイン・グループにVCNが構成されていません。

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-host": "<domain-group-short-id>.data.iot.us-phoenix-1.oci.oraclecloud.com",
    "db-allow-listed-vcn-ids": null,
    "db-connection-string": null,
    "db-token-scope": null,
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-09-08T09:29:22.092Z"
      }
    },
    "description": null,
    "display-name": "Demo Domain Group",
    "freeform-tags": {},
    "id": "<iot-domain-group-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-09-08T09:29:22.449000+00:00",
    "time-updated": "2025-09-08T09:38:01.413000+00:00"
  },
  "etag": "<unique-id>"
}

IoTドメイン・グループがアクティブになった後、データベース内のデータを直接表示する直接データベース接続を確立する場合、またはOracle Analytics Cloudを使用するようにデータを接続する場合は、その構成の一部として、このドメイン・グループのIoTデータへのアクセスを許可するVCNまたはVCNsを追加する必要があります。

次のステップを完了するには、IoTドメイン・グループに追加するVCNまたはVCNsに対する読取りアクセス権が少なくともユーザーに必要です。To confirm if you have read access to the VCN, see Getting a VCN's Details to view the VCNs you have access to. VCNの読取りアクセス権がない場合は、管理者に詳細の関連ポリシーの追加を依頼します。IoTの前提条件を参照してください。

Use the oci iot domain-group configure-data-access command to configure the VCN or VCNs that you want to allow access to the database for the domain group.

["vcn-OCID-1","vcn-OCID-2"]を、環境用に構成されたVCN OCIDsに置き換えます。<domain-group-OCID>を、操作するドメイン・グループのOCIDに置き換えます:

oci iot domain-group configure-data-access --db-allow-listed-vcn-ids '["vcn-OCID-1","vcn-OCID-2"]' --iot-domain-group-id <domain-group-OCID>

詳細は、「IoTドメイン・グループのデータ・アクセスの構成」を参照してください。

IoTドメイン・グループを使用する場合、このコマンドを使用してドメイン・グループの詳細を取得できます。レスポンスでは、このIoTドメイン・グループに対して定義されたデータベース接続の詳細を確認できます。<iot-domain-group-OCID>を、特定のIoTドメイン・グループのOCIDに置き換えます。

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

このレスポンス例では、ドメイン・グループがアクティブである"lifecycleState": "ACTIVE"を示し、このレスポンスが構成されている場合は、データベース接続の詳細とドメイン・グループのデータ・ホストが含まれます。

db-allow-listed-vcn-ids

db-connection-string

db-token-scope

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-host": "<domain-group-short-id>.iot-data.<region>.oci.oraclecloud.com",
    "db-allow-listed-vcn-ids": [
      "<vcn-OCID>"
    ],
    "db-connection-string": "tcps:adb.<region>.oraclecloud.com:1521/<unique-id>.adb.oraclecloud.com?retry_count=20&retry_delay=3",
    "db-token-scope": "urn:oracle:db::id::ocid1.<database-compartment-OCID>",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-11T19:21:24.791Z"
      }
    },
    "description": "<your-domain-group-description>",
    "display-name": "<your-domain-group-name>",
    "freeform-tags": {},
    "id": "<iot-domain-group-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-08-11T19:21:26.411000+00:00",
    "time-updated": "2025-08-12T02:17:02.763000+00:00"
  },
  "etag": "<unique-id>"
          }

次に、IoTドメインを作成し、ドメインをIoTドメイン・グループに関連付けます。