Oracle Cloud Infrastructureドキュメント

IoTドメインの作成

IoTドメイン・グループに関連付けられているInternet of Things (IoT)ドメインを作成します。デバイスのデジタル・ツイン・リソースを作成する場合、関連するすべてのデジタル・ツイン・リソースを特定のIoTドメインに関連付けます。

IoTドメインごとに、一意のデバイス・エンドポイントおよび専用のデータベース・スキーマがドメイン短縮IDで作成されます。

  • device-host:<domain-short-id-from-device-host>.device.iot.<region>.oci.oraclecloud.com
  • デバイスとの間で送受信されるデジタル・ツイン定義およびテレメトリ・データを含む読取り専用データベース・スキーマ: <domain-short-id-from-device-host>__IOT
ノート

各IoTドメイン・グループで最大2つのIoTドメインを作成できます。IoTドメイン・グループの最大数は5で、IoTドメインの最大数はテナンシのリージョンごとに10です。IoTドメインを作成するには、関連付けられたIoTドメイン・グループの読取りアクセス権が必要です。

すべてのIoTリソースは同じリージョンに存在する必要があります。

    1. 「ドメイン」リスト・ページで、IoTドメインを格納するコンパートメントを選択します。IoTドメイン・グループとIoTドメインは、異なるコンパートメントに配置できます。IoTデジタル・ツイン・リソースは、異なるコンパートメントに配置できますが、同じリージョンに配置する必要があります。IoTドメイン・リスト・ページの検索に関するヘルプが必要な場合は、「IoTドメインのリスト」を参照してください。
    2. 「ドメインの作成」を選択します。
    3. IoTドメインのユーザーフレンドリな名前を入力します。機密情報を入力しないでください。
    4. 説明を入力します。(オプション)
    5. 関連付けられたドメイン・グループ・コンパートメントを選択し、このドメインに関連付けるドメイン・グループを選択します。ドメイン・グループがない場合は、ドメイン・グループを作成します。
    6. 「作成」を選択します。
      これで、作業リクエストの操作、ライフサイクルのステータス、完了率、および作業リクエストの承認済、開始済および終了済ステータスの日時を含む、ドメインを作成するための作業リクエストを表示できます。

      たとえば、ドメインが正常に作成された場合、状態は「受諾済」と表示され、数秒後に「成功」と表示され、「%完了」は100になります。

      ドメインの詳細を表示するには、ドメイン名を選択します。

      アクション

      「ドメインの詳細」には、ドメインに関する次の詳細が表示され、これらのオプションにアクセスするためのリンクまたはタブを選択します。

      • 名前、説明、OCID、関連付けられたドメイン・グループ、コンパートメント(ドメインが作成および更新された日時を含む)を含むドメインの詳細を表示します。
      • ドメイン・グループ名を選択して、関連するドメイン・グループの詳細を表示します。
      • ドメインのデバイスホストをエンドポイントで表示およびコピーすると、デバイスホストにドメイン短縮IDが表示されます。「コピー」を選択して、このエンドポイントをコピーします。

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

      • データ保持時間: 任意のデータ型について、「増加」を選択して日数を更新します。日数のみ増やすことができます。RAWデータ、拒否データおよびRAWコマンド・データのデフォルト値は16日で、履歴データのデフォルト値は30日です。
        • RAWデータ: IoTデバイスから受信したRAWデータを含むレコードの集合。これには、エンドポイント、受信時間、コンテンツ・タイプおよび実際のコンテンツが含まれます。
        • 履歴データ: デジタル・ツイン・モデルのコンテンツが履歴済としてマークされている場合、デジタル・ツイン・インスタンスの時系列データがIoTドメインごとに収集されます。
        • 拒否されたデータ: IoTデバイスから受信したRAWデータを含む拒否されたレコードの集合。これには、拒否理由を含むコードと詳細メッセージが含まれます。
        • RAWコマンド・データ: RAWデータ・コマンドは、配信ステータスなどのレスポンス詳細とともに、IoTドメインのデジタル・ツイン・インスタンスに送信されます。
      • 「モニタリング」タブ: IoTドメインのメトリックを表示します。メトリック・チャートごとに、メトリック・エクスプローラでの問合せの表示、チャートURLのコピー、MQLのコピーまたは問合せに対するアラームの作成を実行できます。

        チャートおよびメトリック詳細のリストは、Internet of Thingsメトリック・リファレンス、モニタリング・サービスからのメトリックの表示および問合せのMQL式の編集を参照してください。

      「アクション」メニューを選択して、次の操作を行います。
      • データ・アクセスの変更: このドメインの「アクセス・タイプ」を選択します。
        • 直接データ・アクセス: 関連付けられたドメイン・グループ・データ・ホストへの接続を許可されたIAMアイデンティティ・グループを入力します。このIoTドメインのデータにアクセスする複数のアイデンティティ・グループを追加するには、「別のアイデンティティ・グループの追加」を選択します。

          次のIAMアイデンティティ・グループ・オプションのいずれかを入力します。<identity-group-name>は、ユーザーのアイデンティティ・グループまたはアイデンティティ動的グループのいずれかです。最大許容アイデンティティ・グループ名は5です。

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

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

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

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

        • Oracle REST Data Services (ORDS)アクセス: ORDSデータ・ホスト接続のデータベース・アイデンティティ・ドメイン・ホスト名を入力します:

          idcs-<unique-id>.identity.oraclecloud.com

        • Oracle Application Express (APEX)アクセス: IoTドメインのAPEXワークスペースの初期APEXパスワードを入力します: <your-apex-initial-password>

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

      • 「更新」を選択します。
      • リソースの移動: 宛先コンパートメントを選択して、ドメインを別のコンパートメントに移動します。「リソースの移動」を選択します。
      • 削除: 「削除」を選択して、ドメインを削除します。
      • 「編集」を選択して、このドメインの詳細を編集します。

  • IoTドメインを作成するには、oci iot domain createコマンドと必要なパラメータを使用します。

    <iot-domain-group-OCID>を、IoTドメインに関連付けるIoTドメイン・グループに置き換えます。<compartment-OCID>を、IoTドメインのコンパートメントOCIDに置き換えます:

    oci iot domain create --compartment-id <compartment-OCID> --iot-domain-group-id <iot-domain-group-OCID>

    CLIコマンドのパラメータおよび値の完全なリストは、CLIコマンド・リファレンスを参照してください。

  • CreateIotDomain操作を実行して、IoTドメインを作成します。