デジタル・ツイン・インスタンスの更新
デジタル・ツイン・インスタンスのアダプタID、モデルID、モデル仕様URI、認証ID、外部キー、説明、タグまたはInternet of Things (IoT)の表示名を更新します。
デジタル・ツイン・インスタンスに適用されている既存のオプションを更新する場合、この更新オプションを使用してデジタル・ツイン・インスタンスに新規値を追加できない値のみを変更します。デジタル・ツイン・インスタンスの作成時に更新するパラメータを含めなかった場合は、値を更新できません。かわりに、新しいデジタル・ツイン・インスタンスを作成して新しいパラメータを追加します。
たとえば、テスト用の認証パラメータなしでデジタル・ツイン・インスタンスを作成する場合、デジタル・ツイン・インスタンスからデータを送信または受信する場合は、認証パラメータを使用して新しいデジタル・ツイン・インスタンスを作成する必要があります。認証IDを使用してデジタル・ツイン・インスタンスが作成された場合は、認証IDを更新できます。
- 更新オプションを使用して、既存のIoTデジタル・ツイン・インスタンス・オプションの値を更新します。
- 「ドメイン」リスト・ページで、操作するドメインを選択します。IoTドメインのリスト・ページまたはIoTドメインの検索に関するヘルプが必要な場合は、IoTドメインのリストを参照してください。
- 「デジタル・ツイン・インスタンス」タブを選択します。
- デジタル・ツイン・インスタンス名を選択します。更新する「編集」を選択します:
- 機密情報を入力しないように、name、descriptionまたはExternal keyを更新します。
- typeを編集します。
- 直接接続: デバイスまたはエンティティをIoTドメインに直接接続します。デバイスまたはエンティティが構造化データを送信する場合は、トグルを「アダプタの選択」に切り替えます。アダプタを選択すると、インバウンド・エンベロープおよびインバウンド・ルートを使用して、このデジタル・ツイン・インスタンスが変換レイヤーに関連付けられ、インバウンド・デバイス・ペイロードが、インスタンスで想定される関連するデジタル・ツイン・モデルのDTDL仕様構造に変換されます。リストから選択するアダプタが表示されない場合は、アダプタを作成します。
オプション。 デバイスまたはエンティティがデータを送受信する場合は、認証IDを選択する必要があります。セキュア環境または本番環境ではmTLS証明書を使用するため、テストにのみ基本認証でシークレットを使用します。認証IDを選択するか、認証OCIDを貼り付けることができます。
- 未接続: このオプションを使用して、データ取込みなしでシミュレーション専用のデジタル・ツイン・インスタンスを作成します。デジタル・ツイン・モデルは必須であり、テレメトリまたはプロパティを含めることはできません。リストからモデルを選択するか、DTMIを入力してモデルを選択します。このデジタル・ツイン・インスタンスを作成した後、デジタル・ツイン・リレーションシップを追加して、データの取込みや認証を複雑にすることなくIoT環境をシミュレートできます。
- 直接接続: デバイスまたはエンティティをIoTドメインに直接接続します。デバイスまたはエンティティが構造化データを送信する場合は、トグルを「アダプタの選択」に切り替えます。アダプタを選択すると、インバウンド・エンベロープおよびインバウンド・ルートを使用して、このデジタル・ツイン・インスタンスが変換レイヤーに関連付けられ、インバウンド・デバイス・ペイロードが、インスタンスで想定される関連するデジタル・ツイン・モデルのDTDL仕様構造に変換されます。リストから選択するアダプタが表示されない場合は、アダプタを作成します。
- 「更新」を選択します。
- データ: デジタル・ツイン・インスタンスの最新のスナップショット・データを表示する場合に選択します。「デジタル・ツイン・インスタンス」リストから、行の最後にある「アクション」メニューを選択して削除するか、タグを管理するか、そのOCIDをコピーします。
外部キーを含めないと、外部キーが生成されます。
デジタル・ツイン・インスタンスの既存のパラメータを更新するには、oci iot digital-twin-instance updateコマンドと必要なパラメータを使用します。
たとえば、このコマンドを使用して、デジタル・ツイン・インスタンスの外部キーを更新します。外部キー値で引用符を使用しないことで、見積の問題を回避します。
<your-device-id>を外部キーとしてシリアル番号、MACアドレスまたはデバイス名に置き換えて、デバイスをデジタル・ツイン・インスタンスに関連付けることができます。oci iot digital-twin-instance update --digital-twin-instance-id <digital-twin-instance-OCID> --external-key <your-device-id>デジタル・ツイン・インスタンスのオプションの認証パラメータを更新するには、このコマンドおよび必須の
<digital-twin-instance-OCID>パラメータを使用します。値をシークレットまたは証明書のOCIDで更新します。これは、デバイスにデータを送信するときのデバイス・パスワードです:oci iot digital-twin-instance update --digital-twin-instance-id <digital-twin-instance-OCID> --auth "<updated-auth-ocid>"デジタル・ツイン・インスタンス・パラメータの完全なリストは、OCI iot digital-twin-instance updateを参照し、すべてのOCI CLIコマンドの完全なリストは、CLIコマンド・リファレンスを参照してください。
UpdateDigitalTwinInstance操作を実行して、デジタル・ツイン・インスタンスを更新します。