Device Update for IoT Hub に更新プログラムを追加する
新しい更新プログラムを取得して、Device Update for IoT Hub にインポートする方法について説明します。 まだ行っていない場合は、鍵となるインポートの概念およびインポートする更新プログラムを準備する方法を確認してください。
前提条件
- Device Update for IoT Hub が有効になっている IoT ハブにアクセスできること。
- Device Update 用にプロビジョニングされている、IoT Hub 内の IoT デバイス (またはシミュレーター)。
- PowerShell 5 以降 (Linux、macOS、Windows のインストールを含む)
- サポートされているブラウザー:
- Microsoft Edge
- Google Chrome
更新プログラムをインポートする
注意
次の手順は、Azure portal ユーザー インターフェイスを使用して更新プログラムをインポートする方法を示しています。 代わりに、Device Update for IoT Hub の API を使用して、更新プログラムをインポートすることもできます。
Azure portal にログインし、Device Update がある IoT Hub に移動します。
ページの左側で、[
Device Management
] の下にある [Updates
] を選択します。画面の上部にあるタブの一覧から [
Updates
] タブを選択します。[
Available Updates
] ヘッダーの下にある [+ Import a new update
] を選択します。[
+ Select from storage container
] を選択します。 [ストレージ アカウント] の UI が表示されます。 既存のアカウントを選択するか、[+ Storage account
] を使用して新しいアカウントを作成します。 このアカウントは、インポート用に更新をステージするためにコンテナーで使用されます。ストレージ アカウントを選択すると、[コンテナー] の UI が表示されます。 既存のコンテナーを選択するか、
+ Container
を使用して コンテナーを作成します。 このコンテナーは、インポート用に更新ファイルをステージするために使用されます。"推奨: 以前の更新プログラムから誤ってファイルをインポートしないように、更新プログラムをインポートするごとに新しいコンテナーを使用することをお勧めします。新しいコンテナーを使用しない場合は、この手順を実行する前に、既存のコンテナーからファイルを削除してください。"コンテナーで [
Upload
] を選択します。 アップロードの UI が表示されます。[
Upload blob
] ヘッダーの下にある [Files
] セクションの右側にあるフォルダー アイコンを選択します。 ファイル ピッカーを使用して、更新ファイルとインポート マニフェストの場所に移動し、すべてのファイルを選択し、[Open
] を選択します。 "Shift キーを押しながらクリックすると、複数のファイルを選択できます。"すべての更新ファイルを選択したら、[
Upload
] を選択します。アップロードされたファイルを選択して、インポートするファイルを指定します。 次に、[
Select
] ボタンをクリックして、[Import update
] ページに戻ります。[更新プログラムのインポート] ページで、インポートするファイルを確認します。 次に、[
Import update
] を選択してインポート プロセスを開始します。 エラーを解決するには、 プロキシ更新のトラブルシューティングに関するページを参照してください。インポート プロセスが開始され、画面が [
Import History
] セクションに切り替わります。 インポート処理が完了するまでの進行状況を表示するには、[Refresh
] を選択します (更新プログラムのサイズによっては、プロセスは数分で完了することも、長時間かかることもあります)。[
Status
] 列にインポートが正常に完了したことが表示されたら、[Available Updates
] ヘッダーを選択します。 インポートされた更新プログラムが一覧に表示されるはずです。
代わりに API を使用してインポートしている場合
Azure portal を使用してインポートするだけでなく、次の方法で更新プログラムをインポートすることもできます。
-
.NET、Java、JavaScript、Python 用の
Azure SDK
を使用する - Import Update REST API を使用する
- サンプルの PowerShell モジュールを使用する
Note
必要な API アクセス許可については、デバイス更新のユーザー ロールとアクセス権に関する記事を参照してください。
更新ファイルとインポート マニフェストは、ステージング用に Azure Storage Blob コンテナーにアップロードする必要があります。 ステージングされたファイルをインポートするには、BLOB の URL、またはプライベート BLOB の Shared Access Signature (SAS) を Device Update API に提供します。 SAS を使用している場合は、3 時間以上の有効期間があることを確認してください。
ヒント
大量の更新ファイルを Azure Storage Blob コンテナーにアップロードするには、次のいずれかを使用してパフォーマンスを向上させることができます。