デジタル・ツイン・インスタンスの作成
デバイスのデジタル・ツイン・インスタンスを作成するか、物理エンティティのデジタル表現であるデバイス接続をシミュレートします。
管理者は、IoTリソース、証明書およびシークレットのポリシーの詳細は、前提条件を参照してください。デジタル・ツイン・インスタンスの設定の具体的な例は、シナリオを参照してください。
- 認証: (オプション)
- 認証あり: デジタル・ツイン・インスタンスがデバイス・データを受信するように設定されている場合、またはデジタル・ツイン・アダプタに関連付けられている場合は、認証IDパラメータをボールト・シークレットまたは証明書OCIDとともに使用して、デジタル・ツインを認証できるようにする必要があります。そのためには、他の関連するIoTリソースと同じリージョンおよびテナンシにシークレットを作成するか、証明書を作成します。具体的な例は、シナリオ: mTLS証明書を使用するデジタル・ツイン・インスタンスの作成を参照してください。証明書OCIDまたはボールト・シークレットOCIDを
--auth-idパラメータの値として使用します。デジタル・ツイン・インスタンスに認証IDが含まれている場合、デジタル・ツイン・モデルは不要です。たとえば、シナリオ: HTTPを使用した非構造化データの送信などです。 - 認証なし: デバイスからの取込み可能なデータなしでデジタル・ツイン・インスタンスを作成する場合は、デジタル・ツイン・アダプタなしで、認証IDパラメータ
--auth-idなしでデジタル・ツイン・インスタンスを作成できます。関連付けられたデジタル・ツイン・モデルは必須であり、テレメトリまたはプロパティを含めることはできません。その後、デジタル・ツイン・インスタンスを作成すると、デジタル・ツイン関係を作成して、データや認証の複雑さなしにテストするためのIoT環境をシミュレートできます。
- 認証あり: デジタル・ツイン・インスタンスがデバイス・データを受信するように設定されている場合、またはデジタル・ツイン・アダプタに関連付けられている場合は、認証IDパラメータをボールト・シークレットまたは証明書OCIDとともに使用して、デジタル・ツインを認証できるようにする必要があります。そのためには、他の関連するIoTリソースと同じリージョンおよびテナンシにシークレットを作成するか、証明書を作成します。具体的な例は、シナリオ: mTLS証明書を使用するデジタル・ツイン・インスタンスの作成を参照してください。証明書OCIDまたはボールト・シークレットOCIDを
- 外部キー: (オプション)
- mTLS証明書認証IDでの外部キーの使用: デジタル・ツイン・インスタンスを作成する場合、
--external-keyパラメータはオプションです。外部キーを含め、認証IDがmTLS証明書OCIDとして指定されている場合は、証明書の共通名を外部キー値として使用する必要があります。 - ボールト・シークレット認証IDの使用: データの送信時に
--auth-idパラメータを使用してデバイスを認証する場合にデジタル・ツイン・インスタンスを作成する場合、データの送信時にベース64でエンコードされたシークレット値をデバイス・パスワードとして使用する必要があります。 - 外部キーとしてのデバイスIDの使用: 外部キーは、デバイスの名前にすることも、MACアドレスやシリアル番号などの特定のデバイスIDを使用することもできます。
- 外部キーなし: デジタル・ツイン・インスタンスの作成時に
--external-keyを含めないと、外部キーが自動的に生成されます。デジタル・ツイン・インスタンスが作成された後、update digital twin instanceコマンドを使用して外部キーを変更します。
ノート
外部キー値で引用符を使用しないでください。一部のアプリケーションまたはコード・エディタでは、不要な引用符を値に追加すると、エラーが発生する可能性があります。外部キーを使用する場合は、引用符を削除することがベスト・プラクティスです。これは、curlコマンドの外部キーにも適用されます。このCLIコマンドは、--external-keyパラメータと、引用符を含まない対応する値を表示します。--external-key 01-23-45-67-89-ab - mTLS証明書認証IDでの外部キーの使用: デジタル・ツイン・インスタンスを作成する場合、
- デジタル・ツイン・アダプタ・オプション: 詳細は、デジタル・ツイン・アダプタの作成を参照してください。
- 構造化データの場合は、アダプタおよびモデルを使用してデジタル・ツイン・インスタンスを作成します : デバイスから構造化データを受信する場合は、デジタル・ツイン・モデルおよびデジタル・ツイン・アダプタを作成してデジタル・ツイン・インスタンスに関連付ける必要があります。
- 非構造化データの場合、アダプタまたはモデルなしでデジタル・ツイン・インスタンスを作成します: デバイスから非構造化データを受信している場合、デジタル・ツイン・インスタンスにはデジタル・ツイン・アダプタまたはモデルは必要ありません。
非構造化データの場合:
関連する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>認証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操作を実行して、デジタル・ツイン・インスタンスを作成します。