デジタル・ツイン・インスタンスの作成
デバイスのデジタル・ツイン・インスタンスを作成するか、物理エンティティのデジタル表現であるデバイス接続をシミュレートします。
管理者は、IoTリソース、証明書およびシークレットのポリシーの詳細は、前提条件を参照してください。デジタル・ツイン・インスタンスの設定の具体的な例は、シナリオを参照してください。
- 構造化データの場合は、アダプタおよびモデルを使用してデジタル・ツイン・インスタンスを作成します : デバイスから構造化データを受信する場合は、デジタル・ツイン・モデルおよびデジタル・ツイン・アダプタを作成してデジタル・ツイン・インスタンスに関連付ける必要があります。
- 非構造化データの場合、アダプタまたはモデルなしでデジタル・ツイン・インスタンスを作成します: デバイスから非構造化データを受信している場合、デジタル・ツイン・インスタンスにはデジタル・ツイン・アダプタまたはモデルは必要ありません。
- 認証: (オプション)
- 認証あり: デジタル・ツイン・インスタンスがデバイス・データを受信するように設定されている場合、またはデジタル・ツイン・アダプタに関連付けられている場合は、認証IDパラメータをボールト・シークレットまたは証明書OCIDとともに使用して、デジタル・ツインを認証できるようにする必要があります。これを実行するには、シークレットを作成するか、証明書を作成します。
- 認証なし: デバイスからの取込み可能なデータなしでデジタル・ツイン・インスタンスを作成する場合は、デジタル・ツイン・アダプタなしで、認証IDパラメータ
--auth-idなしでデジタル・ツイン・インスタンスを作成できます。関連付けられたデジタル・ツイン・モデルは必須であり、テレメトリまたはプロパティを含めることはできません。その後、デジタル・ツイン・インスタンスを作成すると、デジタル・ツイン関係を作成して、データや認証の複雑さなしにテストするためのIoT環境をシミュレートできます。
- 外部キー: (オプション)
- mTLS証明書認証IDでの外部キーの使用: デジタル・ツイン・インスタンスを作成する場合、
--external-keyパラメータはオプションです。外部キーを含め、認証IDがmTLS証明書OCIDとして指定されている場合は、証明書の共通名を外部キー値として使用する必要があります。 - ボールト・シークレット認証IDの使用: データの送信時にデバイスを認証するために
--auth-idパラメータをボールト・シークレットとともに使用する場合にデジタル・ツイン・インスタンスを作成する場合、データを送信するときにプレーン・テキストのシークレット値をデバイス・パスワードとして使用する必要があります。 - 外部キーとしてのデバイスIDの使用: 外部キーは、デバイスの名前にすることも、MACアドレスやシリアル番号などの特定のデバイスIDを使用することもできます。
- 外部キーなし: デジタル・ツイン・インスタンスの作成時に
--external-keyを含めないと、外部キーが自動的に生成されます。デジタル・ツイン・インスタンスの作成後、update digital twin instanceコマンドを使用して外部キーを変更します。
- mTLS証明書認証IDでの外部キーの使用: デジタル・ツイン・インスタンスを作成する場合、
- 「IoTドメイン」リスト・ページで、操作するIoTドメインを選択します。IoTドメイン・リスト・ページの検索に関するヘルプが必要な場合は、IoTドメインのリストを参照してください。
- 「デジタル・ツイン・インスタンス」タブを選択し、「作成」を選択します。
- 「名前」およびオプションで「説明」を入力します。機密情報は入力しないでください。
- オプション。 一意の識別子である外部キーを入力します。外部キーを指定しない場合、このデジタル・ツイン・インスタンスの保存時に生成されます。デバイスへの接続時またはデバイスへのデータの送信時に、外部キーをデバイスのユーザー名として使用します。
- タイプを選択します。
- 直接接続: デバイスまたはエンティティをIoTドメインに直接接続します。デバイスまたはエンティティが構造化データを送信する場合は、アダプタを選択します。アダプタを選択すると、このデジタル・ツイン・インスタンスが変換レイヤーに関連付けられ、インバウンド・デバイス・ペイロードが、インスタンスで想定される関連するデジタル・ツイン・モデルのDTDL構造に変換されます。
- アダプタの選択: デジタル・ツイン・アダプタをオンにしてリストから選択し、アダプタをこのデジタル・ツイン・インスタンスに関連付けます。アダプタがない場合は、デジタル・ツイン・アダプタを作成します。
デバイスが構造化データを送信する場合は、アダプタを選択する必要があります。接続するデバイスまたはエンティティが非構造化データを送信するか、非構造化データ・コマンドを受信する場合、アダプタは必要ありません。
- アダプタの選択: デジタル・ツイン・アダプタをオンにしてリストから選択し、アダプタをこのデジタル・ツイン・インスタンスに関連付けます。アダプタがない場合は、デジタル・ツイン・アダプタを作成します。
- 未接続: このオプションは、IoTデバイスに支えられていないデジタル・ツイン・インスタンスに使用します。その結果、これらのインスタンスはテレメトリを受信できず、コマンドの送受信もできません。これらのインスタンスに関連付けられたデジタル・ツイン・モデルでは、デジタル・ツイン関係を定義できます。ただし、テレメトリやプロパティを含めることはできません。このオプションを使用すると、データまたはデバイス認証の複雑さなしにIoT環境をシミュレートできます。
- 認証ID: デバイスまたはエンティティがデータを送受信する場合は、認証IDを指定する必要があります。テスト用にボールト・シークレットを作成し、本番用にデジタル・ツイン・インスタンスの認証IDのmTLS証明書を作成します。
- 認証IDの選択: シークレットまたは証明書オプションを選択します。シークレットの場合は、ボールト・コンパートメント、ボールトおよびシークレットを選択します。証明書の場合は、証明書コンパートメントを選択し、証明書を選択します。
- 認証OCIDの貼付け: 証明書またはシークレットのOCIDを貼り付けます。
- タグ: (オプション)デジタル・ツイン・アダプタに1つ以上のタグを追加します。リソースを作成する権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの詳細は、リソース・タグを参照してください。タグを適用するかどうかわからない場合は、このオプションをスキップするか、管理者に問い合せてください。後でタグを適用できます。
- 直接接続: デバイスまたはエンティティをIoTドメインに直接接続します。デバイスまたはエンティティが構造化データを送信する場合は、アダプタを選択します。アダプタを選択すると、このデジタル・ツイン・インスタンスが変換レイヤーに関連付けられ、インバウンド・デバイス・ペイロードが、インスタンスで想定される関連するデジタル・ツイン・モデルのDTDL構造に変換されます。
- 「作成」を選択します。
非構造化データの場合:
関連するIoTドメインのデジタル・ツイン・インスタンスを作成するには、oci iot digital-twin-instance createコマンドと必要なパラメータを使用します。
<iot-domain-OCID>を、このデジタル・ツイン・インスタンスに関連付けるIoTドメインのOCIDに置き換え、<certificate-or-secret-OCID>を証明書またはシークレットに置き換えます:oci iot digital-twin-instance create --auth-id <certificate-or-secret-OCID> --iot-domain-id <iot-domain-OCID>構造化データの場合:
oci iot digital-twin-instance createコマンドおよび必須パラメータを使用します。構造化データでは、認証IDとデジタル・ツイン・アダプタを使用してデジタル・ツイン・インスタンスを作成する必要があります。
<iot-domain-OCID>を、このデジタル・ツイン・インスタンスに関連付けるIoTドメインのOCIDに置き換え、<certificate-or-secret-OCID>を証明書またはシークレットに置き換えます。<digital-twin-adapter-OCID>を関連するデジタル・ツイン・アダプタOCIDに置き換えます:
詳細は、デジタル・ツイン・アダプタの作成を参照してください。oci iot digital-twin-instance create --iot-domain-id <iot-domain-OCID> --auth-id <certificate-or-secret-OCID> --digital-twin-adapter-id <digital-twin-adapter-OCID>ノート
外部キー値で引用符を使用しないでください。一部のアプリケーションまたはコード・エディタでは、不要な引用符を値に追加すると、エラーが発生する可能性があります。外部キーを使用する場合は、引用符を削除することがベスト・プラクティスです。これは、curlコマンドの外部キーにも適用されます。このCLIコマンドは、--external-keyパラメータと、引用符を含まない対応する値を表示します。--external-key 01-23-45-67-89-ab認証ID、デジタル・ツイン・モデルまたはデジタル・ツイン・アダプタがない場合:
このコマンド例は、デジタル・ツイン・アダプタ、デジタル・ツイン・モデルまたは認証IDなしでデジタル・ツイン・インスタンスを作成し、オプションの外部キー・パラメータを含める方法を示しています。
外部キーをデバイスの外部キーに置き換えます。外部キーは一意である必要があり、説明テキスト値にすることも、デバイスのMACアドレスまたはシリアル番号を使用することもできます。
この例では、--external-key値に引用符が含まれていません:01-23-45-67-89-aboci iot digital-twin-instance create --iot-domain-id <iot-domain-OCID> --external-key 01-23-45-67-89-abCLIコマンドのパラメータおよび値の完全なリストは、CLIコマンド・リファレンスを参照してください。
CreateDigitalTwinInstance操作を実行して、デジタル・ツイン・インスタンスを作成します。