IoT Platform:更新ステータスの表示

手順

1. IoT Platform コンソール にログオンします。

2. [概要] ページで、[すべての環境] をクリックします。 [すべての環境] タブで、管理するインスタンスを見つけ、インスタンス ID またはインスタンス名をクリックします。

3. 左側のナビゲーションウィンドウで、[メンテナンス] > [OTA 更新] を選択します。
   説明 より良いサービスを提供するために、IoT Platform は OTA 更新機能を改善し、更新パッケージバージョンの統計を追加しました。 コンソールで新しい OTA 更新機能を初めて使用するときは、アップロードした更新パッケージを製品に関連付ける必要があります。 更新パッケージは 1 つの製品にのみ関連付けることができます。 更新パッケージを製品に関連付ける方法の詳細については、コンソールの説明をご参照ください。
4. [更新パッケージ] タブで、バッチ更新に使用する更新パッケージを見つけ、[アクション] 列の [表示] をクリックします。 次に、次のタブで情報を確認し、操作を実行できます。
   • [バッチ管理]
     • 更新バッチのタイプ（更新パッケージの検証やバッチ更新など）を表示します。
     • 更新バッチを見つけ、[アクション] 列の [表示] をクリックします。 [バッチの詳細] ページの [デバイスリスト] タブで、さまざまな状態のデバイスを表示できます。

       状態	説明
       確認待ち	OTA アップデートタスクは、モバイルアプリを使用して確認されていません。 アップデートバッチの作成時に [アプリでアップグレードを確認] パラメーターを [はい] に設定した場合、バッチ内のアップデートタスクはこの状態になります。
       プッシュ予定	OTA アップデート通知がデバイスにプッシュされていません。 アップデートタスクがこの状態になる理由は次のとおりです。1. デバイスがオフラインです。2. 通知がプッシュされるようにスケジュールされています。3. プッシュレートが指定されたしきい値を超えています。これらの理由に対応する次の状態が表示されます。 [プッシュ予定 (デバイスがオフライン)] [プッシュ予定 (スケジュール済み:XX XX, XXXX, XX:XX:XX)] [プッシュ予定]
       プッシュ済み	デバイスは OTA アップデート通知を受信しましたが、アップデートの進捗状況を送信していません。
       アップグレード中	デバイスは OTA アップデート通知を受信し、アップデートの進捗状況を送信しました。
       更新済み	デバイスは、更新後に有効なバージョン番号を送信しました。 説明 デバイスが更新された後、デバイスができるだけ早く有効なバージョン番号を送信することを確認してください。そうしないと、タイムアウトの問題が原因で更新が失敗する可能性があります。
       更新失敗	OTA 更新は、次の理由で失敗する可能性があります。 たとえば、デバイスの新しい一括更新を開始し、デバイスで完了していない以前の更新タスクを上書きしない場合などです。 この場合、次の操作を実行できます。 以前の更新タスクが完了した後、新しい更新を開始します。 デバイスの新しい更新を開始する前に、デバイスで実行されている以前のタスクを上書きします。 説明 デバイスが [アップグレード中] 状態の場合、デバイスで実行されている更新タスクを上書きすることはできません。 デバイスが特定の Topic を使用して IoT Platform に更新の進捗状況を送信するときに、エラーが発生したことを示す値 -1、値 -2、値 -3、または値 -4 をデバイスが送信します。値の説明： -1: 更新に失敗しました。 -2: ダウンロードに失敗しました。 -3: 検証に失敗しました。 -4: 書き込みに失敗しました。 デバイスの更新中、デバイスが更新の進捗状況を初めて送信すると、システムは更新期間の計算を開始します。指定されたタイムアウト期間内にデバイスが更新されたバージョン番号を送信できなかった場合、更新は失敗します。 [アップグレード中] 状態のデバイスが、ソースバージョンまたはデスティネーションバージョンではないバージョン番号を送信しました。 更新するバージョン番号を指定し、一括更新の開始時に再試行間隔を指定した場合、更新の失敗後に再試行が実行されます。更新は、次のいずれかの理由で失敗する可能性があります。 [アップグレード中] 状態のデバイスが、ソースバージョンまたはデスティネーションバージョンではないバージョン番号を送信しました。 デバイスが特定の Topic を使用して IoT Platform に更新の進捗状況を送信するときに、デバイスが次のいずれかの値を送信します： -1、-2、-3、および -4。 自動再試行中、IoT Platform 内のデバイスの更新ステータスは変更されません。たとえば、[プッシュ済み] 状態のデバイスで再試行が実行された場合、デバイスのステータスは IoT Platform コンソールに [プッシュ済み] として表示されます。[アップグレード中] 状態のデバイスで再試行が実行された場合、デバイスのステータスは IoT Platform コンソールに [アップグレード中] として表示されます。 説明 次のいずれかの理由で更新が失敗した場合、IoT Platform による自動再試行は実行されません。 更新がタイムアウトしました。 更新がキャンセルされました。
       キャンセル済み	デバイスの更新はキャンセルされました。

       更新バッチが [アップグレード中] 状態の場合、更新バッチの [アクション] 列に [編集] ボタンが表示されます。[編集] をクリックできます。表示されるページの「更新ポリシーの設定」ステップで、[更新パッケージのプッシュレート] パラメーターが [一定レート] に設定されている場合は [一定レートでの更新] パラメーターの値を変更できます。また、[更新パッケージのプッシュレート] パラメーターが可変レートに設定されている場合は、必須パラメーターの値を変更できます。既存のタグを変更したり、新しいタグを追加したりすることもできます。詳細については、「バッチ更新を開始する」をご参照ください。

       [バッチ情報] タブをクリックして、バッチの基本情報を表示することもできます。更新バッチが [アップグレード中] 状態の場合、[タグ情報] の横に [編集] ボタンが表示されます。[編集] をクリックして、タグを変更または追加できます。

       
     • 更新バッチを見つけ、[アクション] 列の [キャンセル] をクリックします。
       • 静的更新バッチをキャンセルすると、[保留中確認]、[プッシュ予定]、[プッシュ済み]、および [更新済み] 状態のタスクを含む、バッチのすべての更新タスクが自動的にキャンセルされます。
       • 動的更新バッチをキャンセルすると、動的更新ポリシーのみがキャンセルされます。[プッシュ予定]、[プッシュ済み]、および [アップグレード中] 状態のタスクを含む、ビジネス要件に基づいて、進行中のすべての更新タスクをキャンセルできます。

       [保留中確認]、[プッシュ予定]、または [プッシュ済み] 状態のすべてのデバイス更新タスクをキャンセルできます。

   • デバイス一覧

     更新パッケージのプッシュ先デバイスに関する情報 (デバイスの更新ステータス、更新の成功、失敗、およびキャンセルの統計情報など) を表示します。

     デバイスを検索し、[アクション] 列の [表示] をクリックします。 [バッチ詳細] ページで、デバイスの更新タスクをキャンセルできます。

   • [更新パッケージ情報]
     • 更新パッケージの ID、名前、署名、署名アルゴリズム、バージョン番号、ステータス、モジュールなどの基本情報を表示します。
     • 更新パッケージを取得するには、ダウンロード[更新パッケージの署名] の横にある をクリックします。

次の手順

更新パッケージのバージョンと成功率に関する統計情報を表示する: OTA 更新タスクが完了したら、[データ分析] タブに移動して、更新パッケージのバージョンの分布と更新の成功率に関する統計情報を表示できます。

関連 API 操作

OTA 更新機能に関連する API 操作の詳細については、「OTA 更新」をご参照ください。