Device Update for IoT Hub リソースを作成する

Device Update の使用を開始するには、Device Update アカウントとインスタンスを作成し、アクセス制御ロールを設定します。

Device Update アカウントは、Azure サブスクリプションのリソースです。 Device Update インスタンスは、特定の IoT ハブに関連付けられているアカウント内の論理コンテナーです。 インスタンスには、その IoT ハブに関連付けられている更新プログラムとデプロイが含まれています。 1 つのアカウント内に複数のインスタンスを作成できます。 詳細については、「デバイス更新のリソース」を参照してください。

前提条件

Azure Portal

IoT Hub。 S1 (Standard) レベル以上を使う必要があります。

Azure CLI

• IoT Hub。 S1 (Standard) レベル以上を使う必要があります。

• Azure CLI 環境:

  • Azure Cloud Shell で Bash 環境を使用します。

    

  • CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします

    • az login コマンドを使用して、Azure CLI にサインインします。

    • az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。

    • 初回使用時に確認を求められたら、Azure CLI 拡張機能をインストールします。 この記事のコマンドでは、azure-iot 拡張機能を使います。 az extension update --name azure-iot を実行して、最新バージョンの拡張機能を使用していることを確認してください。

アカウントとインスタンスを作成する

Azure Portal

1. Azure portal で、[リソースの作成] を選択し、[Device Update for IoT Hub] を探します

2. [作成]>[Device Update for IoT Hub] を選択します

   

3. [基本] タブで、Device Update のアカウントとインスタンスに関する次の情報を指定します。

   • サブスクリプション: Device Update アカウントに関連付ける Azure サブスクリプション。
   • リソース グループ: 既存または新しいリソース グループ。
   • 名前: アカウントの名前。
   • 場所: アカウントが配置される Azure リージョン。 Device Update for IoT Hub をサポートするリージョンについては、リージョン別の Azure 製品に関するページを参照してください。
   • チェック ボックスをオンにして、Device Update 管理者ロールを自分に割り当てます。 「アクセス制御ロールの構成」セクションに記載されている手順を使用し、ロールの組み合わせを使ってユーザーとアプリケーションに適切なレベルのアクセスを提供することもできます。 ロールを管理するには、サブスクリプションの所有者またはユーザー アクセス管理者のアクセス許可が必要です。
   • インスタンス名: インスタンスの名前。
   • IoT ハブ名: Device Update インスタンスにリンクする IoT ハブを選びます
   • Azure Device Update サービス プリンシパルに、IoT Hub で Device Update サービスを設定して操作するための適切なアクセス権を付与するには、このチェック ボックスをオンにします。 アクセスを追加するには、適切なアクセス許可が必要です。

   注意

   リソースの作成時に Azure Device Update サービス プリンシパルにアクセスを許可できない場合は、ユーザーと Azure Device Update サービス プリンシパルのアクセス制御の構成に関する記事をご覧ください。 このアクセス権が設定されていない場合、デプロイ、デバイス管理、診断操作を実行できません。 Azure Device Update サービス プリンシパルのアクセスの詳細を確認してください。

   

4. [次へ: 診断] を選びます。 Microsoft 診断を有効にすると、更新エラーが発生したときにデバイスから診断ログ ファイルを収集、保存、分析するためのアクセス許可が Microsoft に付与されます。 診断のためのリモート ログ収集を有効にするには、Device Update インスタンスを Azure Blob Storage アカウントにリンクする必要があります。 Azure ストレージ アカウントを選ぶと、ストレージの詳細が自動的に更新されます。

   

5. [ネットワーク] タブで、Device Update のアカウントとインスタンスの作成を続けます。 デバイスが Device Update インスタンスに接続するために使用できるエンドポイントを選びます。 この例では、既定の設定であるパブリック アクセスを受け入れます。

   

6. 確認と作成 を選択します。 検証後、[作成] を選択します。

   

7. デプロイが進行中であることがわかります。 数分でデプロイの状態が "完了" に変わるのがわかります。 完了に変わったら、[リソースに移動] を選択します

Azure CLI

az iot du account create コマンドを使って、新しい Device Update アカウントを作成します。

次のプレースホルダーを独自の情報に置き換えます。

• <resource_group>: サブスクリプション内の既存のリソース グループ。

• <account_name>: Device Update アカウントの名前。

• <region>: アカウントが配置される Azure リージョン。 Device Update for IoT Hub をサポートするリージョンについては、リージョン別の Azure 製品に関するページを参照してください。 リージョンが指定されていない場合は、リソース グループの場所が使用されます。

  Note

  Device Update アカウントは、お使いの IoT ハブと同じリージョンに存在する必要はありませんが、パフォーマンス向上のために、地理的に近い場所におくことをお勧めします。

az iot du account create --resource-group <resource_group> --account <account_name> --location <region>

az iot du instance create コマンドを使って、Device Update インスタンスを作成します。

Device Update の "インスタンス" は、1 つの IoT ハブに関連付けられます。 Device Update で使用する IoT ハブを選択します。 IoT ハブを Device Update インスタンスにリンクすると、新しい共有アクセス ポリシーが自動的に作成され、IoT Hub (レジストリ書き込みとサービス接続) を操作するための Device Update のアクセス許可が与えられます。 このポリシーにより、アクセスは Device Update のみに制限されます。

次のプレースホルダーを独自の情報に置き換えます。

• <account_name>: このインスタンスが関連付けられる Device Update アカウントの名前。
• <instance_name>: このインスタンスの名前。
• <othub_id>: このインスタンスにリンクされる IoT ハブのリソース ID。 az iot hub show コマンドを使用し、ID 値のクエリを実行して (az iot hub show -n <iothub_name> --query id)、IoT ハブのリソース ID を取得することができます。

az iot du instance create --account <account_name> --instance <instance_name> --iothub-ids <iothub_id>

ヒント

インスタンス作成プロセスの一環として、診断ログを構成することもできます。 詳細については、デバイスから診断ログをリモートで収集するに関するページを参照してください。

次のステップ

Device Update リソースを作成したら、ユーザーと Azure Device Update サービス プリンシパルのアクセス制御を構成します。

または、Device Update アカウントとインスタンス または Device Update アクセス制御ロールの詳細を確認します。