チュートリアル: IoT Hub メッセージ ルーティングを使用してデバイス データを Azure Storage に送信する

Azure portal には、その他の前提条件はありません。

• Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Azure Cloud Shell の概要」を参照してください。

  

• CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。 詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。

  • ローカル インストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、「 Azure CLI を使用した Azure への認証」を参照してください。

  • 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。 拡張機能の詳細については、「Azure CLI で拡張機能を使用および管理する」を参照してください。

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

1. Azure Portal にサインインし、IoT Hub に移動します。

2. メニューの [デバイス管理] セクションから [デバイス] を選択します。

3. [デバイスの追加] を選択します。

   

4. デバイス ID を指定し、[保存] を選択します。

5. 新しいデバイスがデバイスの一覧に表示されます。 そうでない場合は、ページを更新します。 デバイス ID を選択し、[デバイスの詳細] ページを開きます。

6. デバイス キーの 1 つをコピーして保存します。 この値を使用して、シミュレートされたデバイス テレメトリ メッセージを生成するサンプル コードを構成します。

   

1. IoT ハブとデバイスの変数を定義します。

   IOTHUB_NAME: このプレースホルダーを IoT ハブの名前に置き換えます。

   DEVICE_NAME: このプレースホルダーを、このチュートリアルでデバイスに使用する任意の名前に置き換えます。

   hubName=IOTHUB_NAME
   deviceName=DEVICE_NAME
   

2. CLI シェルで、az iot hub device-identity create コマンドを実行します。 このコマンドで、デバイス ID が作成されます。

   az iot hub device-identity create --device-id $deviceName --hub-name $hubName
   

3. デバイス ID の出力から、囲みの引用符を除いた primaryKey 値をコピーして保存します。 この値を使用して、シミュレートされたデバイス テレメトリ メッセージを生成するサンプル コードを構成します。

1. Azure Portal で、お使いの IoT ハブに移動します。

2. メニューの [セキュリティ設定] セクションから [共有アクセス ポリシー] を選択します。

3. iothubowner ポリシーを選択します。

   

4. プライマリ接続文字列をコピーします。

   

1. az iot hub connection-string show コマンドを実行します。

   az iot hub connection-string show --hub-name $hubName
   

2. 囲み引用符無しで接続文字列をコピーします。

1. Azure portal で、[ストレージ アカウント] を検索します。

2. ［作成］ を選択します

3. ストレージ アカウントには、下の値を指定します。

   パラメーター	価値
   サブスクリプション	IoT Hub を含む同じサブスクリプションを選択します。
   リソース グループ	IoT Hub を含む同じリソース グループを選択します。
   Storage account name (ストレージ アカウント名)	グローバルに一意の名前を [ストレージ アカウント] に指定します。
   パフォーマンス	既定値の [標準] をそのまま使用します。

   

4. [確認と作成] を選択すると、他のすべての既定値をそのまま使用できます。

5. 検証が完了した後、 [作成] を選択します。

6. デプロイが完了したら、[リソースに移動] を選択します。

7. [ストレージ アカウント] メニューの [データ ストレージ] セクションから [コンテナー] を選択します。

8. [+ コンテナー] を選択して、新しいコンテナーを作成します。

   

9. コンテナーの名前を入力し、[作成] を選択します。

1. ストレージ アカウントとコンテナーの変数を定義します。

   GROUP_NAME: このプレースホルダーを IoT ハブを含むリソース グループの名前に置き換えます。

   STORAGE_NAME: このプレースホルダーをストレージ アカウントの名前に置き換えます。 ストレージ アカウント名は小文字で、グローバルに一意である必要があります。

   CONTAINER_NAME: このプレースホルダーをコンテナーの名前に置き換えます。

   resourceGroup=GROUP_NAME
   storageName=STORAGE_NAME
   containerName=CONTAINER_NAME
   

2. az storage account create コマンドを使用して、汎用の標準汎用 v2 ストレージ アカウントを作成します。

   az storage account create --name $storageName --resource-group $resourceGroup
   

3. az storage container create を使用して、ストレージ アカウントにコンテナーを追加します。

   az storage container create --auth-mode login --account-name $storageName --name $containerName
   

1. Azure portal で IoT Hub に移動します。

2. リソース メニューの [ハブ設定] で、[メッセージ ルーティング] を選択し、[追加] を選択します。

   

3. [エンドポイント] タブで、次の情報を指定してストレージ エンドポイントを作成します。

   パラメーター	値
   [エンドポイントの種類]	[ストレージ] を選択します。
   [エンドポイント名]	このエンドポイントの一意の名前を指定します。
   [Azure Storage コンテナー]	[コンテナーを選択します] を選択します。 プロンプトに従って、前のセクションで作成したストレージ アカウントとコンテナーを選択します。
   [エンコード]	[JSON] を選択します。 このフィールドが淡色表示されている場合、ストレージ アカウント リージョンは JSON をサポートしません。 その場合は、既定の [AVRO] で続行します。

   

4. 残りのパラメーターの既定値をそのまま使用し、[作成 + 次へ] を選択します。

5. [ルート] タブで、次の情報を指定して、作成したストレージ エンドポイントを指すルートを作成します。

   パラメーター	値
   名前	ルートの名前を作成します。
   データ ソース	ドロップダウン リストから [デバイス テレメトリ メッセージ] が選択されていることを確認します。
   ルートの有効化	このフィールドがオンにされていることを確認します。
   ルーティング クエリ	クエリ文字列として、「level="storage"」と入力します。

   

6. [エンリッチメントの作成 + スキップ] を選択します。

1. エンドポイントとルート コマンドに必要な変数を構成します。

   ENDPOINT_NAME: ストレージ コンテナーを表すエンドポイントの名前を指定します。

   ROUTE_NAME: ストレージ エンドポイントのメッセージをフィルター処理するルートの名前を指定します

   endpointName=ENDPOINT_NAME
   routeName=ROUTE_NAME
   

2. az iot hub message-endpoint create コマンドを使用して、前のセクションで作成したストレージ コンテナーを指すカスタム エンドポイントを作成します。

   az iot hub message-endpoint create storage-container \
     --connection-string $(az storage account show-connection-string --name $storageName --query connectionString -o tsv) \
     --endpoint-name $endpointName \
     --hub-name $hubName \
     --container $containerName \
     --resource-group $resourceGroup \
     --encoding json
   

3. az iot hub message-route create コマンドを使用して、level=storage の任意のメッセージをストレージ コンテナー エンドポイントに渡すルートを作成します。

   az iot hub message-route create \
     --route-name $routeName \
     --hub-name $hubName \
     --resource-group $resourceGroup \
     --source-type devicemessages \
     --endpoint-name $endpointName \
     --enabled true \
     --condition 'level="storage"'
   

1. Azure portal で、このチュートリアルの IoT ハブとストレージ アカウントを含むリソース グループに移動します。
2. リソース グループ内にあるすべてのリソースを確認して、クリーンアップするリソースを決定します。
   • すべてのリソースを削除する場合は、 [リソース グループの削除] を選択します。
   • 特定のリソースのみを削除する場合は、各リソース名の横にあるチェック ボックスを使用して、削除するリソースを選択します。 次に、 [削除] を選択します。

1. az resource list コマンドを使用して、リソース グループ内のすべてのリソースを表示します。

   az resource list --resource-group $resourceGroup --output table
   

2. リソース グループ内にあるすべてのリソースを確認して、クリーンアップするリソースを決定します。

   • すべてのリソースを削除する場合は、 az group delete コマンドを使用します。

     az group delete --name $resourceGroup
     

   • 特定のリソースのみを削除する場合は、 az resource delete コマンドを使用します。 次に例を示します。

     az resource delete --resource-group $resourceGroup --name $storageName