製品とデバイスをパブリックインスタンスからエンタープライズインスタンスに移行した後、一部の機能では再設定が必要になったり、動作が異なったりします。このトピックでは、機能ごとの使用上の注意点について説明します。
背景情報
インスタンス移行の詳細については、「開始前にお読みください」をご参照ください。
IoT Platform の機能の詳細については、「機能」をご参照ください。
デバイス接続
|
機能 |
説明 |
|
デバイス側 SDK |
デバイス側 SDK は自動的にエンタープライズインスタンスに接続します。変更は不要です。 |
|
デバイスセキュリティ認証 |
「1 デバイス 1 シークレット」および「1 プロダクト 1 シークレット」の事前登録認証をサポートします。 |
|
NB-IoT デバイス |
NB-IoT ネットワークプロトコルを使用するデバイスの移行はサポートされていません。 |
デバイス管理
|
機能 |
説明 |
|
TSL モデル |
移行されたプロダクトデータは変更する必要はありません。必要に応じて設定を追加または変更できます。 説明
レガシーパブリックインスタンスには元のデータが保持されます。エラーを防ぐため、移行が完了し、サービスの正常な動作を確認した後、手動でデータを削除してください。 |
|
データ解析 |
|
|
タグ |
エンタープライズインスタンスでタグを再度追加してください。 |
|
デバイスグループ |
エンタープライズインスタンスでグループを再度追加してください。 説明
デバイスは、レガシーパブリックインスタンスの元のグループに引き続き表示されます。これらのデバイスで操作を実行すると、エラーが発生します。移行されたデバイスに対応するグループを削除してください。 |
|
高度な検索 |
移行先のエンタープライズインスタンスに移行されたデータを取得できます。 |
|
デバイスタスク |
エンタープライズインスタンスでプロダクト関連のタスクを再度作成してください。 |
|
デバイスシャドウ |
引き続きデバイスシャドウのキャッシュメカニズムを使用できます。 |
|
ファイル管理 |
移行先のエンタープライズインスタンスでデバイスによってアップロードされたファイルを表示できます。 |
|
NTP サービス |
エンタープライズインスタンスで引き続き NTP サービスを使用して、リアルタイムで取得できない場合にサーバー側の時刻を取得できます。 |
|
ゲートウェイサブデバイス |
移行中にトポロジが変更されない場合に限り、サブデバイスは IoT Platform に接続できます。それ以外の場合、サブデバイスが IoT Platform に接続する際にエラーが発生します。 |
|
デバイス分散 |
グローバルに分散しているデバイスの場合、インスタンス移行が成功した後にデバイスが接続を確立するとエラーが発生します。 |
メッセージ通信
|
機能 |
説明 |
|
サーバー側サブスクリプション |
移行されたサブスクリプション設定と転送ルールを使用できます。サーバー側サブスクリプションとデータ転送ルールを追加または変更することもできます。 |
|
データ転送 |
|
|
シーンオーケストレーション |
エンタープライズインスタンスでシーンオーケストレーションルールを再度作成してください。 |
|
RRPC 通信 |
RRpc や PubBroadcast などの通信 API を呼び出すときは、エンタープライズインスタンス ID を渡す必要があります。 |
|
ブロードキャスト通信 |
モニタリングと運用保守
|
機能 |
説明 |
|
リアルタイムモニタリング |
デバイス、メッセージ、TSL モデル、およびルールエンジンのメトリクスは、移行の進行に伴って変化します。デバイス接続とメッセージ通信をリアルタイムでモニタリングし、正常に動作することを確認してください。 製品のデータを移行元のパブリックインスタンスから移行先のEnterprise Editionインスタンスに移行すると、インスタンスのビジネスデータの量が変化します。 ソースパブリックインスタンスのメトリックの値が減少し、ターゲットEnterprise Editionインスタンスのメトリックの値が増加します。 ソースパブリックインスタンスに対してしきい値トリガーアラートルールが設定されている場合、メトリックの値が指定されたしきい値未満になるとアラートがトリガーされます。 この場合、ビジネス要件に基づいてアラートルールを無効化または変更できます。 詳細については、「アラートルールの設定」をご参照ください。 |
|
運用保守ダッシュボード |
|
|
オンラインデバッグ |
エンタープライズインスタンスから移行されたデバイスに指示を送信して、デバイス側の機能をデバッグしてください。 |
|
デバイスエミュレーター |
パブリックインスタンスで、移行するデバイスのデバイスエミュレーターをシャットダウンしてください。その後、エンタープライズインスタンスでデバイスエミュレーターを再起動してください。 |
|
Simple Log Service |
エンタープライズインスタンスの Simple Log Service では、履歴データをクエリできません。 |
|
OTA アップデート |
デバイスが OTA (Over-the-Air) アップデートを確実に受信できるように、エンタープライズインスタンスで OTA アップデートタスクを再度追加してください。 |
|
リモート設定 |
エンタープライズインスタンスでリモート設定を再度実行してください。 |
|
アラートセンター |
エンタープライズインスタンスでアラート情報を再度設定してください。 |
|
セキュアトンネル |
デバイスへのリモートアクセスを確保するために、エンタープライズインスタンスでデバイスのセキュアトンネルを再度作成してください。 |
開発者ガイド
-
クラウド API コール:
関連するサービス API を呼び出すときは、エンタープライズインスタンス ID を含めるようにリクエストパラメーターを変更してください。
クラウド API の Pub、RRpc、InvokeThingService、および SetDeviceProperty は、エンタープライズインスタンス ID と互換性があります。チケットを起票してこの機能をリクエストすることで、サーバー側の変更を減らすことができます。
警告エンタープライズインスタンスでクラウド SDK を使用する場合、API コールにインスタンス ID を含める必要があります。そうしないと、コールが失敗し、サービスに影響します。必要な変更については、「移行前の準備」をご参照ください。
-
AMQP クライアント接続:
ルールエンジンを使用して AMQP サーバー側サブスクリプションまたは AMQP へのデータ転送を設定した場合、AMQP クライアント SDK を更新する必要があります。新しいエンタープライズインスタンス ID とアクセスドメイン名をコピーして、新しい AMQP クライアントを設定してください。グレースケール移行後、コンシューマーグループ ID をコピーして更新し、新しい AMQP クライアントを起動してください。
警告AMQP サーバー側サブスクリプションを設定している場合は、パブリックインスタンスと移行先のエンタープライズインスタンスの両方で AMQP クライアントを実行する必要があります。これにより、両方のインスタンスで AMQP クライアントがデータを受信できるようになり、データ損失を防ぐことができます。