IoT Platform:アップデートステータスの表示

操作手順

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

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

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

       ステータス	説明
       確認待ち	OTA アップデートは、モバイルアプリでの確認を待機しています。 このステータスは、一括更新タスクの作成時に [アプリ確認のアップグレード] を [はい] に設定した場合にのみ適用されます。
       プッシュ待ち	システムはまだ OTA アップデート通知をデバイスに送信していません。 この状態は、デバイスがオフラインの場合、アップデートがスケジュールされている場合、またはレート制限が有効な場合に発生する可能性があります。特定のステータスは次のように表示されます。 プッシュ待ち (デバイスオフライン) プッシュ待ち (スケジュール済み：YYYY/MM/DD hh:mm:ss) プッシュ待ち
       プッシュ済み	OTA アップデート通知はデバイスに送信されましたが、デバイスは進行状況を報告していません。
       アップグレード中	デバイスはアップデート通知を受信し、進行状況の報告を開始しました。
       アップデート済み	デバイスはアップデートを正常に完了し、新しいバージョン番号を報告しました。 説明 アップデート完了後、デバイスは直ちに新しいバージョン番号を報告する必要があります。そうしないと、アップデートがタイムアウトし、失敗としてマークされる可能性があります。
       アップデート失敗	アップデートは、いくつかの理由で失敗する可能性があります。 前回のタスクが完了する前にデバイスの新しい一括更新タスクを開始し、前回のタスクを上書きしないことを選択した場合。この場合、新しいタスクは失敗します。 以下のいずれかの操作を実行できます。 新しいアップデートを開始する前に、前回のアップデートが完了するのを待ちます。 新しいアップデートを開始するときに、前回のタスクを上書きすることを選択します。 説明 デバイスが [アップグレード中] の状態にある場合、アップデートタスクは上書きできません。 デバイスが進行状況報告 Topic で失敗コード (-1、-2、-3、または -4) を IoT Platform に報告した場合。これらのコードは以下の情報を示します。 -1：アップデート失敗。 -2：ダウンロード失敗。 -3：検証失敗。 -4：書き込み失敗。 アップデートがタイムアウトした場合。システムは、デバイスが最初に進行状況を報告したときにタイマーを開始します。タイムアウト期間が終了する前にデバイスがターゲットバージョン番号を報告しない場合、アップデートは失敗します。 デバイスが [アップグレード中] の状態で、ソースバージョンでもターゲットバージョンでもないバージョン番号を報告した場合。 一括更新タスクの作成時に更新するバージョンを指定し、リトライを有効にしている場合、システムは以下の失敗シナリオで更新を自動的にリトライします。 デバイスが [アップグレード中] の状態で、ソースバージョンでもターゲットバージョンでもないバージョン番号を報告したためにアップデートが失敗した場合。 デバイスが進行状況報告 Topic で -1、-2、-3、または -4 の値を送信して能動的に失敗を報告したためにアップデートが失敗した場合。 自動リトライ中、IoT Platform コンソールでのデバイスのアップデートステータスは変更されません。たとえば、デバイスが [プッシュ済み] の状態でリトライがトリガーされた場合、そのステータスは [プッシュ済み] のままです。デバイスが [アップグレード中] の状態でリトライがトリガーされた場合、そのステータスは [アップグレード中] のままです。 説明 IoT Platform は、以下の場合には自動リトライをトリガーしません。 タイムアウトによりアップデートに失敗しました。失敗理由はタイムアウトです。 手動でアップデートをキャンセルした場合。
       キャンセル済み	このデバイスのアップデートはキャンセルされました。

       更新バッチが [アップグレード中] の場合、[編集] ボタンが [操作] 列に表示されます。[編集] をクリックして、[更新ポリシー設定] の [アップデートパッケージのプッシュレート] (たとえば [定速レート] や [可変レート] の値) を変更したり、タグを変更・追加したりします。詳細については、「一括更新タスクの作成」をご参照ください。

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

       [タグの編集] ダイアログボックスで、バッチのタグキーとタグ値を入力し、[OK] をクリックします。デバイス通知は 1 分以内に新しいタグを使用します。
     • ターゲットの更新バッチの [操作] 列にある [キャンセル] をクリックします。
       • 静的一括更新バッチの場合、この操作はデフォルトでバッチおよび関連するすべての更新タスク ([確認待ち]、[プッシュ待ち]、[プッシュ済み]、[アップグレード中] の状態を含む) をキャンセルします。
       • 動的一括更新バッチの場合、この操作はデフォルトで動的更新ポリシーのみをキャンセルします。[プッシュ待ち]、[プッシュ済み]、[アップグレード中] の状態を含む、進行中のすべてのタスクもキャンセルするかどうかを選択できます。

       バッチ内で [確認待ち]、[プッシュ待ち]、または [プッシュ済み] の状態にあるすべての更新タスクをキャンセルできます。

   • [デバイスリスト]

     アップデートパッケージのターゲットデバイス、そのアップデートステータス、およびアップデート済み、失敗、キャンセルされたタスクの統計を表示します。

     ターゲットデバイスを見つけ、[操作] 列の [表示] をクリックします。[バッチ詳細] ページで、単一のデバイスまたは複数のデバイスの更新タスクをキャンセルできます。

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

次のステップ

アップデートパッケージのバージョンと成功率の表示：OTA アップデートが完了した後、データ分析を使用して、アップデートパッケージのバージョンのディストリビューションとアップデート成功率の統計を表示します。

API リファレンス

OTA アップデート機能に関連する API オペレーションの詳細については、「OTA アップデート API」をご参照ください。