Oracle Cloud Infrastructureドキュメント

デジタル・ツイン・アダプタの更新

Internet of Things (IoT)のデジタル・ツイン・アダプタを更新します。

デジタル・ツイン・アダプタに適用されている既存のオプションを更新する場合、この更新オプションを使用して、デジタル・ツイン・アダプタに新しい値を追加しない値のみを変更します。新しい値を追加する場合は、新しいデジタル・ツイン・アダプタを作成し、新しいデジタル・ツイン・アダプタOCIDを作業するデジタル・ツイン・インスタンスに関連付ける必要があります。これは、デジタル・ツイン・インスタンスを作成するか、デジタル・ツイン・インスタンスを更新するときに実行できます。

デジタル・ツイン・アダプタを使用する特定のシナリオについては、次を参照してください:

デジタルツインアダプタオプション

  • デジタル・ツイン・アダプタを更新または再作成する場合: デジタル・ツイン・アダプタの作成時にこれらのオプションが最初に含まれていた場合は、display-name、description、tagsなどのメタデータに対してupdateを使用します。envelope-mappingまたはinbound-routesでロジック変更をマッピングするには、新しいアダプタを作成します。
  • アダプタ更新のベスト・プラクティス: 新しいアダプタでの更新の適用、テスト・デジタル・ツイン・インスタンスへの関連付け、サンプル・テレメトリのポスト、202レスポンスおよびダウンストリーム値の検証、および本番デジタル・ツイン・インスタンスの新規アダプタへの関連付けを行います。
  • アダプタ値: nullまたは空にできます。
  • インバウンド・ルートは有効なJSONである必要があります: 引用符で囲まれていない${...}値はサポートされず、拒否されます。JQ式は、"${(.velocity_kph / 1.609) | floor}"のように引用符で囲まれた文字列内にある必要があります。
  • インバウンド・ルートの制限: インバウンド・ルートの最大数は128インバウンド・ルートです。
  • WindowsでのCLIの見積り: 使用しているオペレーティング・システムまたはアプリケーションによっては、文字列パラメータ、引用符およびスペースが原因で問題が発生する可能性があります。予期しない余分な引数が発生する引用符を使用することは避け、空白を使用することも避けてください。たとえば、OCI CLIパラメータを入力するには、次のように使用します。

    --description your-description

ノート

OCI CLIでは、デジタル・ツイン・アダプタ定義にハイフン区切り語が使用され、APIではcamelCase表記が使用されます。たとえば、OCI CLIで使用されるoci cliコマンドenvelope-mappingを使用すると、Python IoT SDKまたはIoT APIを使用すると、envelopeMappingになります。

  • デジタル・ツイン・アダプタを更新するには、oci iot digital-twin-adapter updateコマンドと必要なパラメータを使用します。デジタル・ツイン・アダプタの説明、フリー・フォーム・タグ、定義済タグまたは表示名を更新できます。オペレーティング・システムによっては、MacやLinuxなどで異なる数のスラッシュが必要になる場合があります。詳細は、file:///inbound-routes.jsonを参照してください。

    デジタル・ツイン・アダプタのインバウンド・ルートを更新するには: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --inbound-routes file://inbound-routes.json
    デジタル・ツイン・アダプタのインバウンド・エンベロープ・マッピングを更新するには: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --inbound-envelop file://inbound-envelop.json
    デジタル・ツイン・アダプタの説明を更新するには: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --description "<updated-description>"
    デジタル・ツイン・アダプタのフリー・フォーム・タグを更新するには、この例のようにキー値ペアを定義するか、次の例のようにtags.jsonファイルへのパスを定義できます。 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --freeform-tags '{"<key>": "<value>"}'
    詳細は、フリーフォーム・タグの理解に関する項を参照してください。
    デジタル・ツイン・アダプタの定義済タグを更新するには、.jsonファイルを使用してタグを定義し、tags.jsonファイルのようなパスを例のように含めます。
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --defined-tags file://tags.json
    詳細は、定義済タグの作業を参照してください。
    デジタル・ツイン・アダプタの表示名を更新するには: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --display-name "<updated-display-name>"

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

  • UpdateDigitalTwinAdapter操作を実行して、デジタル・ツイン・アダプタを更新します。