デジタル・ツイン・インスタンスの更新

Internet of Things (IoT)で、デジタル・ツイン・インスタンスの接続タイプ、ゲートウェイ・アソシエーション、認証ID、アダプタ、モデル、外部キー、名前、説明またはタグを更新します。

DIRECT、INDIRECTおよびGATEWAY接続タイプの間でデジタル・ツイン・インスタンスを変更できます。宛先構成は全体として有効である必要があります。宛先接続タイプに必要なモデル、アダプタ、認証IDおよびゲートウェイ・アソシエーションを同じ更新に含めます。

デジタルツインモデルを更新する場合は、現在のモデルと同じDTMIパスとメジャーバージョンの互換性のあるモデルを使用します。マイナー・バージョンは、同じかそれ以上である必要があります。接続タイプの変更中は、無関係なモデルに切り替えることはできません。

直接接続、間接接続およびゲートウェイ・インスタンスを一緒に使用するエンドツーエンドの例については、デジタル・ツイン・インスタンス接続タイプの変更を参照してください。

接続タイプ遷移要件
変更先	必須の設定	制限
`DIRECT`	認証IDを指定します。構造化データの場合、ゲートウェイ・ターゲット・マッピングなしでデジタル・ツイン・アダプタを使用します。	ゲートウェイ・アソシエーションは許可されていません。
`INDIRECT`	ゲートウェイ・デジタル・ツイン・インスタンスOCIDsの空でないリストを指定します。構造化データの場合、ゲートウェイ・ターゲット・マッピングなしでデジタル・ツイン・アダプタを使用します。	認証IDは許可されていません。各ゲートウェイは、IoTドメイン内の既存のアクティブな`GATEWAY`インスタンスである必要があります。重複するゲートウェイを含めないか、ゲートウェイ容量を超えないようにしてください。
`GATEWAY`	ゲートウェイ・ターゲット・マッピングを使用して、認証IDおよびデジタル・ツイン・アダプタを指定します。	ゲートウェイ・アソシエーションは許可されていません。既存のゲートウェイを別の接続タイプに変更する前に、それを使用する間接的に接続されたすべてのデジタル・ツイン・インスタンスを再割当てします。

ノート

コンソール・ラベル「未接続」は、APIおよびCLI値NONEに対応します。既存のデジタル・ツイン・インスタンスをNONEに変更することはできません。この接続タイプを使用するには、新しいデジタル・ツイン・インスタンスを作成し、コンソールで「未接続」を選択するか、APIまたはCLIでNONEを指定します。

現在の接続タイプでインスタンスを更新することは冪等です。

デジタル・ツイン・インスタンスを更新するには、oci iot digital-twin-instance updateコマンドと必要なパラメータを使用します。

--connectivity-type、--auth-id、--digital-twin-adapter-id、--digital-twin-model-id、--digital-twin-model-spec-uriおよび--gatewaysを使用して、有効な宛先構成を指定します。

ゲートウェイに直接接続されたインスタンスの変更

このコマンドを使用して、ゲートウェイ接続タイプ、認証IDおよびゲートウェイ・ターゲット・マッピングのあるアダプタを指定します。
```
oci iot digital-twin-instance update \
  --digital-twin-instance-id <digital-twin-instance-OCID> \
  --connectivity-type GATEWAY \
  --auth-id <certificate-or-secret-OCID> \
  --digital-twin-adapter-id <gateway-adapter-OCID> \
  --force
```
間接的に接続されたインスタンスを直接接続に変更

このコマンドを使用して、ゲートウェイ・ターゲット・マッピングのない直接接続タイプ、認証IDおよびアダプタを指定します。
```
oci iot digital-twin-instance update \
  --digital-twin-instance-id <digital-twin-instance-OCID> \
  --connectivity-type DIRECT \
  --auth-id <certificate-or-secret-OCID> \
  --digital-twin-adapter-id <direct-adapter-OCID> \
  --force
```
ゲートウェイを直接接続に変更

最初に、ゲートウェイを使用する間接的に接続されたすべてのデジタル・ツイン・インスタンスを再割当てします。次に、このコマンドを使用して直接接続構成を指定します。
```
oci iot digital-twin-instance update \
  --digital-twin-instance-id <gateway-instance-OCID> \
  --connectivity-type DIRECT \
  --auth-id <certificate-or-secret-OCID> \
  --digital-twin-adapter-id <direct-adapter-OCID> \
  --force
```
他のデジタル・ツイン・インスタンス設定の更新

デジタル・ツイン・インスタンスの外部キーを更新するには、このコマンドと必要なパラメータを使用します。外部キー値で引用符を使用しないでください。
```
oci iot digital-twin-instance update \
  --digital-twin-instance-id <digital-twin-instance-OCID> \
  --external-key <your-device-id>
```
デジタル・ツイン・インスタンスの認証IDを更新するには、このコマンドと必要なパラメータを使用します。
```
oci iot digital-twin-instance update \
  --digital-twin-instance-id <digital-twin-instance-OCID> \
  --auth-id <updated-certificate-or-secret-OCID>
```
パラメータの完全なリストは、oci iot digital-twin-instance updateを参照してください。すべてのOCI CLIコマンドについては、CLIコマンド・リファレンスを参照してください。
UpdateDigitalTwinInstance操作を実行して、デジタル・ツイン・インスタンスを更新します。

接続タイプを変更するには、UpdateDigitalTwinInstanceDetailsのconnectivityTypeをDIRECT、INDIRECTまたはGATEWAYに設定します。宛先タイプで必要な場合、authIdやgatewaysなどのコンパニオン・フィールドを同じリクエストに含めます。

たとえば、直接接続されたインスタンスを間接的に接続するように変更するには、認証IDをクリアし、ゲートウェイ・ターゲット・マッピングのないアダプタを選択し、少なくとも1つのゲートウェイを指定します。
```
{
  "connectivityType": "INDIRECT",
  "authId": null,
  "digitalTwinAdapterId": "<direct-adapter-OCID>",
  "gateways": [
    "<gateway-instance-OCID>"
  ]
}
```

接続タイプの更新のトラブルシューティング

宛先構成が拒否されました

HTTP 400レスポンスは、リクエストされた接続タイプとそのコンパニオン設定が一緒に有効でないことを意味します。このページの遷移要件に対してモデルの互換性、認証ID、アダプタ・ターゲット・マッピングおよびゲートウェイ・アソシエーションを確認し、完全な宛先構成を再度送信してください。

ゲートウェイに間接的に接続された依存があります

HTTP 409レスポンスは、ゲートウェイをまだ使用している間接的に接続されたデジタル・ツイン・インスタンスを識別します。これらのダウンストリーム・インスタンスを別のゲートウェイに再割当てするか、サポートされている接続タイプに変更します。ゲートウェイに依存する間接的に接続されたインスタンスがない場合は、ゲートウェイの更新を再試行してください。

間接的に接続された更新では、認証IDが保持されます

--auth-id nullを渡さないでください。CLIは、nullをテキストとして処理し、無効なOCIDとして拒否します。更新で認証IDを明示的にクリアする必要がある場合は、UpdateDigitalTwinInstance操作を"authId": nullとともに使用します。

アダプタが宛先タイプと一致しません

GATEWAYでは、ゲートウェイ・ターゲット・マッピングを定義するアダプタを選択します。DIRECTまたはINDIRECTの場合は、ゲートウェイ・ターゲット・マッピングのないアダプタを選択します。

接続されていないインスタンスが必要です

既存のデジタル・ツイン・インスタンスをNONEに変更することはサポートされていません。かわりに、コンソールで「未接続」を使用して新しいデジタル・ツイン・インスタンスを作成するか、APIまたはCLIでNONEを作成します。

接続タイプ更新に関するFAQ

接続されておらず、NONEも同じ接続タイプですか。: はい。「未接続」はコンソール・ラベルです。NONEは、対応するAPIおよびCLI値です。
既存のデジタル・ツイン・インスタンスを「未接続」に変更できますか。: 番号かわりに、「未接続」またはNONEを使用して、新しいデジタル・ツイン・インスタンスを作成します。
接続を変更しながら、別のデジタルツインモデルに変更することはできますか?: モデルに互換性がある場合にのみ、同じDTMIパスとメジャー・バージョンを使用し、同じまたはそれ以上のマイナー・バージョンを使用する必要があります。接続更新で無関係なモデルに切り替えることはできません。
ゲートウェイを別の接続タイプに変更できないのはなぜですか。: 1つ以上の間接的に接続されたデジタル・ツイン・インスタンスは、引き続きそれを使用します。これらのダウンストリーム・インスタンスを再割当てしてから、ゲートウェイの更新を再試行してください。
インスタンスを現在の接続タイプに更新できますか。: はい。完全な構成が引き続き有効な場合、同じタイプの更新はべき等です。

Oracle Cloud Infrastructureドキュメント