クイックスタート: IoT ハブに接続されているデバイスを制御する

このクイックスタートでは、ダイレクトメソッドを使用して、IoT ハブに接続されているシミュレートされたデバイスを制御します。 IoT Hub は、クラウドから IoT デバイスを管理し、ストレージまたは処理のために大量のデバイステレメトリをクラウドに取り込む Azure サービスです。ダイレクトメソッドを使用して、IoT ハブに接続されているデバイスの動作をリモートで変更できます。

このクイックスタートでは、2 つの事前に書き込まれた .NET アプリケーションを使用します。

サービスアプリケーションから呼び出されたダイレクトメソッドに応答するシミュレートされたデバイスアプリケーション。ダイレクトメソッド呼び出しを受け取るために、このアプリケーションは IoT ハブ上のデバイス固有のエンドポイントに接続します。
シミュレートされたデバイスでダイレクトメソッドを呼び出すサービスアプリケーション。デバイスでダイレクトメソッドを呼び出すために、このアプリケーションは IoT ハブ上のサービス側エンドポイントに接続します。

[前提条件]

アクティブなサブスクリプションを持つ Azure アカウント。無料で作成できます。
このクイックスタートで実行する 2 つのサンプルアプリケーションは、C# を使用して記述されています。開発用コンピューターに .NET SDK 6.0 以上が必要です。

.NET から複数のプラットフォーム用の .NET Core SDK をダウンロードできます。

次のコマンドを使用して、開発用コンピューター上の現在のバージョンの C# を確認できます。
```
dotnet --version
```
GitHub から Microsoft Azure IoT SDK for .NET を複製またはダウンロードします。このクイックスタートで使用するサンプルアプリケーションは、SDK に含まれています。
ポート 8883 がファイアウォールで開放されていることを確認してください。このクイックスタートのデバイスサンプルでは、ポート 8883 経由で通信する MQTT プロトコルを使用します。このポートは、企業や教育用のネットワーク環境によってはブロックされている場合があります。この問題を回避する方法の詳細については、「MQTT プロトコルを使用して IoT ハブと通信する」の「 IoT Hub への接続」セクションを参照してください。

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 を実行します。

注

この記事では、azure-iot と呼ばれる、Azure IoT 拡張機能の最新バージョンを使用します。レガシバージョンは、 azure-cli-iot-extと呼ばれます。一度にインストールするバージョンは 1 つだけです。コマンド az extension list を使用すると、現在インストールされている拡張機能を確認できます。

拡張機能の従来のバージョンを削除するには、az extension remove --name azure-cli-iot-ext を使用します。

拡張機能の新しいバージョンを追加するには、az extension add --name azure-iot を使用します。

現在インストールされている拡張機能を確認するには、 az extension listを使用します。

このセクションでは、Azure CLI を使用して IoT ハブとリソースグループを作成します。 Azure リソースグループとは、Azure リソースのデプロイと管理に使用する論理コンテナーです。 IoT ハブは、IoT アプリケーションとデバイスの間の双方向通信に対する中央メッセージハブとして機能します。

Azure サブスクリプションに IoT ハブが既にある場合は、このセクションをスキップできます。

IoT ハブとリソースグループを作成するには、次のようにします。

CLI アプリを起動します。この記事の以降の部分で CLI コマンドを実行するには、コマンド構文をコピーして CLI アプリに貼り付け、変数の値を編集して Enter を押します。
- Cloud Shell を使用する場合は、CLI コマンドの [Try It](試してみる) ボタンを選択すると、分割されたブラウザーウィンドウで Cloud Shell が起動します。また、別のブラウザータブで Cloud Shell を開くこともできます。
- Azure CLI をローカルで使用している場合は、CLI コンソールアプリを起動し、Azure CLI にサインインします。
az extension add を実行して、azure-iot 拡張機能をインストールするか、最新バージョンにアップグレードします。
```
az extension add --upgrade --name azure-iot
```
CLI アプリで az group create コマンドを実行してリソースグループを作成します。次のコマンドは、myResourceGroup という名前のリソースグループを eastus という場所に作成します。

注

必要に応じて、別の場所を設定できます。選択できる場所を確認するには、az account list-locations を実行します。コマンド例を見るとわかるように、このクイックスタートでは eastus を使用しています。
```
az group create --name MyResourceGroup --location eastus
```
az iot hub create コマンドを実行して、IoT ハブを作成します。 IoT ハブの作成には数分かかることがあります。

YourIoTHubName。以下のコマンドでは、選択した IoT ハブの名前に合わせて、プレースホルダーとそれを囲む中かっこを置き換えます。 IoT ハブ名は Azure でグローバルに一意である必要があります。以降、このクイックスタートに出現しているプレースホルダーにはすべて、実際の IoT ハブの名前を使用してください。
```
az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
```

サービス接続文字列を取得する

また、サービスアプリケーションがハブに接続してメッセージを取得できるようにするには、IoT ハブのサービス 接続文字列 も必要です。サービス接続文字列は IoT ハブ全体を対象としており、前のセクションで取得したデバイス接続文字列とは異なります。

次のコマンドは、IoT ハブのサービス接続文字列を取得します。

az iot hub connection-string show --policy-name service --hub-name {YourIoTHubName} --output table

次のようなサービス接続文字列を書き留めます。

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

この値は、クイックスタートの後半で使用します。

デバイスをシミュレートする

シミュレートされたデバイスアプリケーションは、IoT ハブ上のデバイス固有のエンドポイントに接続し、シミュレートされたテレメトリを送信し、ハブからのダイレクトメソッド呼び出しをリッスンします。このクイックスタートでは、ハブからのダイレクトメソッド呼び出しによって、テレメトリを送信する間隔を変更するようにデバイスに指示します。シミュレートされたデバイスは、ダイレクトメソッドを実行した後、ハブに受信確認を送信します。

ローカルターミナルウィンドウで、SDK のルートフォルダーに移動します。次に、 iothub\device\samples\getting started\SimulatedDeviceWithCommand フォルダーに 移動します。
次のコマンドを実行して、シミュレートされたデバイスアプリケーションに必要なパッケージをインストールします。
```
dotnet restore
```
次のコマンドを実行して、シミュレートされたデバイスアプリケーションをビルドして実行します。

{DeviceConnectionString}: このプレースホルダーは、前に説明したデバイス接続文字列に置き換えます。
```
dotnet run -- -c "{DeviceConnectionString}"
```
次のスクリーンショットは、シミュレートされたデバイスアプリケーションが IoT ハブにテレメトリを送信するときの出力を示しています。

ダイレクトメソッドを呼び出す

サービスアプリケーションは、IoT Hub 上のサービス側エンドポイントに接続します。アプリケーションは、IoT ハブを介してデバイスに直接メソッド呼び出しを行い、受信確認をリッスンします。通常、IoT Hub サービスアプリケーションはクラウドで実行されます。

別のローカルターミナルウィンドウで、SDK のルートフォルダーに移動します。次に、 iothub\service\samples\getting started\InvokeDeviceMethod フォルダーに移動します。
ローカルターミナルウィンドウで、次のコマンドを実行して、サービスアプリケーションに必要なライブラリをインストールします。
```
dotnet build
```
ローカルターミナルウィンドウで、次のコマンドを実行して、サービスアプリケーションをビルドして実行します。

{ServiceConnectionString}: このプレースホルダーを、前に説明した IoT Hub サービス接続文字列に置き換えます。

{DeviceName}: このプレースホルダーは、登録したデバイスの名前に置き換えます。
```
dotnet run -- -c "{ServiceConnectionString}" -d {DeviceName}
```
次のスクリーンショットは、アプリケーションがデバイスへのダイレクトメソッド呼び出しを行い、受信確認を受信する際の出力を示しています。

サービスアプリケーションを実行すると、シミュレートされたデバイスを実行しているローカルターミナルウィンドウにメッセージが表示され、メッセージの送信速度が変わります。

このクイックスタートでは、次の 2 つの Java アプリケーションを使用します。

バックエンドアプリケーションから呼び出されたダイレクトメソッドに応答するシミュレートされたデバイスアプリケーション。
シミュレートされたデバイスでダイレクトメソッドを呼び出すサービスアプリケーション。

[前提条件]

アクティブなサブスクリプションを持つ Azure アカウント。無料で作成できます。
Java SE 開発キット 8. Azure と Azure Stack に対する Java の長期的なサポートでは、[長期的なサポート] で [Java 8] を選択します。

次のコマンドを使用して、開発用コンピューター上の Java の現在のバージョンを確認できます。
```
java -version
```
Apache Maven 3。

次のコマンドを使用して、開発用コンピューター上の Maven の現在のバージョンを確認できます。
```
mvn --version
```
GitHub から Java 用 Azure IoT サンプルを複製またはダウンロードします。
ポート 8883 がファイアウォールで開放されていることを確認してください。このクイックスタートのデバイスサンプルでは、ポート 8883 経由で通信する MQTT プロトコルを使用します。このポートは、企業や教育用のネットワーク環境によってはブロックされている場合があります。この問題を回避する方法の詳細については、「MQTT プロトコルを使用して IoT ハブと通信する」の「 IoT Hub への接続」セクションを参照してください。

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 を実行します。

注

拡張機能の従来のバージョンを削除するには、az extension remove --name azure-cli-iot-ext を使用します。

拡張機能の新しいバージョンを追加するには、az extension add --name azure-iot を使用します。

現在インストールされている拡張機能を確認するには、 az extension listを使用します。

IoT ハブを作成する

Azure サブスクリプションに IoT ハブが既にある場合は、このセクションをスキップできます。

IoT ハブとリソースグループを作成するには、次のようにします。

CLI アプリを起動します。この記事の以降の部分で CLI コマンドを実行するには、コマンド構文をコピーして CLI アプリに貼り付け、変数の値を編集して Enter を押します。
- Cloud Shell を使用する場合は、CLI コマンドの [Try It](試してみる) ボタンを選択すると、分割されたブラウザーウィンドウで Cloud Shell が起動します。また、別のブラウザータブで Cloud Shell を開くこともできます。
- Azure CLI をローカルで使用している場合は、CLI コンソールアプリを起動し、Azure CLI にサインインします。
az extension add を実行して、azure-iot 拡張機能をインストールするか、最新バージョンにアップグレードします。
```
az extension add --upgrade --name azure-iot
```
CLI アプリで az group create コマンドを実行してリソースグループを作成します。次のコマンドは、myResourceGroup という名前のリソースグループを eastus という場所に作成します。

注

必要に応じて、別の場所を設定できます。選択できる場所を確認するには、az account list-locations を実行します。コマンド例を見るとわかるように、このクイックスタートでは eastus を使用しています。
```
az group create --name MyResourceGroup --location eastus
```
az iot hub create コマンドを実行して、IoT ハブを作成します。 IoT ハブの作成には数分かかることがあります。

YourIoTHubName。以下のコマンドでは、選択した IoT ハブの名前に合わせて、プレースホルダーとそれを囲む中かっこを置き換えます。 IoT ハブ名は Azure でグローバルに一意である必要があります。以降、このクイックスタートに出現しているプレースホルダーにはすべて、実際の IoT ハブの名前を使用してください。
```
az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
```

デバイスの登録

デバイスを IoT Hub に接続するには、あらかじめ IoT Hub に登録しておく必要があります。このセクションでは、Azure CLI を使用してデバイス ID を作成します。

IoT ハブにデバイスが既に登録されている場合は、このセクションをスキップできます。

デバイス ID を作成するには:

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

YourIoTHubName。以下のコマンドでは、選択した IoT ハブの名前に合わせて、プレースホルダーとそれを囲む中かっこを置き換えます。 IoT ハブ名は Azure でグローバルに一意である必要があります。

myDevice。この記事全体でデバイス ID にこの名前を使用することも、別のデバイス名を指定することもできます。
```
az iot hub device-identity create --device-id myDevice --hub-name {YourIoTHubName}
```

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

az iot hub device-identity connection-string show --device-id myDevice --hub-name {YourIoTHubName}

接続文字列の出力形式は次のとおりです。

HostName=<your IoT Hub name>.azure-devices.net;DeviceId=<your device id>;SharedAccessKey=<some value>

接続文字列を安全な場所に保存します。

注

CLI アプリを開いたままにします。後の手順で使用します。

サービス接続文字列を取得する

バックエンドアプリケーションが IoT ハブに接続してメッセージを取得できるようにするには、 サービス接続文字列 も必要です。次のコマンドは、IoT ハブのサービス接続文字列を取得します。

YourIoTHubName: 次のコマンドのこのプレースホルダーを、IoT ハブ用に選択した名前に置き換えます。

az iot hub connection-string show --policy-name service --hub-name {YourIoTHubName} --output table

次のようなサービス接続文字列を書き留めます。

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

この値は、クイックスタートの後半で使用します。このサービス接続文字列は、前の手順で説明したデバイス接続文字列とは異なります。

デバイスをシミュレートする

ローカルターミナルウィンドウで、サンプル Java プロジェクトのルートフォルダーに移動します。次に、 iot-hub\Quickstarts\simulated-device-2 フォルダーに 移動します。
任意のテキストエディターで src/main/java/com/microsoft/docs/iothub/samples/SimulatedDevice.java ファイルを開きます。

connString変数の値を、前にメモしたデバイス接続文字列に置き換えます。次に、変更を SimulatedDevice.javaに保存します。
ローカルターミナルウィンドウで、次のコマンドを実行して必要なライブラリをインストールし、シミュレートされたデバイスアプリケーションをビルドします。
```
mvn clean package
```
ローカルターミナルウィンドウで、次のコマンドを実行して、シミュレートされたデバイスアプリケーションを実行します。
```
java -jar target/simulated-device-2-1.0.0-with-deps.jar
```
次のスクリーンショットは、シミュレートされたデバイスアプリケーションが IoT ハブにテレメトリを送信するときの出力を示しています。

ダイレクトメソッドを呼び出す

バックエンドアプリケーションは、IoT Hub 上のサービス側エンドポイントに接続します。アプリケーションは、IoT ハブを介してデバイスに直接メソッド呼び出しを行い、受信確認をリッスンします。通常、IoT Hub バックエンドアプリケーションはクラウドで実行されます。

別のローカルターミナルウィンドウで、サンプル Java プロジェクトのルートフォルダーに移動します。次に、 iot-hub\Quickstarts\バックエンドアプリケーション フォルダーに移動します。
任意のテキストエディターで src/main/java/com/microsoft/docs/iothub/samples/BackEndApplication.java ファイルを開きます。

iotHubConnectionString変数の値を、前にメモしたサービス接続文字列に置き換えます。次に、変更を BackEndApplication.javaに保存します。
ローカルターミナルウィンドウで、次のコマンドを実行して必要なライブラリをインストールし、バックエンドアプリケーションをビルドします。
```
mvn clean package
```
ローカルターミナルウィンドウで、次のコマンドを実行してバックエンドアプリケーションを実行します。
```
java -jar target/back-end-application-1.0.0-with-deps.jar
```
次のスクリーンショットは、アプリケーションがデバイスへのダイレクトメソッド呼び出しを行い、受信確認を受信する際の出力を示しています。

バックエンドアプリケーションを実行すると、シミュレートされたデバイスを実行しているローカルターミナルウィンドウにメッセージが表示され、メッセージの送信速度が変わります。

このクイックスタートでは、次の 2 つの Node.js アプリケーションを使用します。

バックエンドアプリケーションから呼び出されたダイレクトメソッドに応答するシミュレートされたデバイスアプリケーション。ダイレクトメソッド呼び出しを受け取るために、このアプリケーションは IoT ハブ上のデバイス固有のエンドポイントに接続します。
シミュレートされたデバイスでダイレクトメソッドを呼び出すバックエンドアプリケーション。デバイスでダイレクトメソッドを呼び出すために、このアプリケーションは IoT ハブ上のサービス固有のエンドポイントに接続します。

[前提条件]

アクティブなサブスクリプションを持つ Azure アカウント。無料で作成できます。
Node.js 12 以降。

次のコマンドを使用して、開発用コンピューター上の Node.js の現在のバージョンを確認できます。
```
node --version
```
GitHub から Azure IoT Node.js サンプルを複製またはダウンロードします。
ポート 8883 がファイアウォールで開放されていることを確認してください。このクイックスタートのデバイスサンプルでは、ポート 8883 経由で通信する MQTT プロトコルを使用します。このポートは、企業や教育用のネットワーク環境によってはブロックされている場合があります。この問題を回避する方法の詳細については、「MQTT プロトコルを使用して IoT ハブと通信する」の「 IoT Hub への接続」セクションを参照してください。

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 を実行します。

注

拡張機能の従来のバージョンを削除するには、az extension remove --name azure-cli-iot-ext を使用します。

拡張機能の新しいバージョンを追加するには、az extension add --name azure-iot を使用します。

現在インストールされている拡張機能を確認するには、 az extension listを使用します。

IoT ハブを作成する

Azure サブスクリプションに IoT ハブが既にある場合は、このセクションをスキップできます。

IoT ハブとリソースグループを作成するには、次のようにします。

CLI アプリを起動します。この記事の以降の部分で CLI コマンドを実行するには、コマンド構文をコピーして CLI アプリに貼り付け、変数の値を編集して Enter を押します。
- Cloud Shell を使用する場合は、CLI コマンドの [Try It](試してみる) ボタンを選択すると、分割されたブラウザーウィンドウで Cloud Shell が起動します。また、別のブラウザータブで Cloud Shell を開くこともできます。
- Azure CLI をローカルで使用している場合は、CLI コンソールアプリを起動し、Azure CLI にサインインします。
az extension add を実行して、azure-iot 拡張機能をインストールするか、最新バージョンにアップグレードします。
```
az extension add --upgrade --name azure-iot
```
CLI アプリで az group create コマンドを実行してリソースグループを作成します。次のコマンドは、myResourceGroup という名前のリソースグループを eastus という場所に作成します。

注

必要に応じて、別の場所を設定できます。選択できる場所を確認するには、az account list-locations を実行します。コマンド例を見るとわかるように、このクイックスタートでは eastus を使用しています。
```
az group create --name MyResourceGroup --location eastus
```
az iot hub create コマンドを実行して、IoT ハブを作成します。 IoT ハブの作成には数分かかることがあります。

YourIoTHubName。以下のコマンドでは、選択した IoT ハブの名前に合わせて、プレースホルダーとそれを囲む中かっこを置き換えます。 IoT ハブ名は Azure でグローバルに一意である必要があります。以降、このクイックスタートに出現しているプレースホルダーにはすべて、実際の IoT ハブの名前を使用してください。
```
az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
```

デバイスの登録

IoT ハブにデバイスが既に登録されている場合は、このセクションをスキップできます。

デバイス ID を作成するには:

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

YourIoTHubName。以下のコマンドでは、選択した IoT ハブの名前に合わせて、プレースホルダーとそれを囲む中かっこを置き換えます。 IoT ハブ名は Azure でグローバルに一意である必要があります。

myDevice。この記事全体でデバイス ID にこの名前を使用することも、別のデバイス名を指定することもできます。
```
az iot hub device-identity create --device-id myDevice --hub-name {YourIoTHubName}
```

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

az iot hub device-identity connection-string show --device-id myDevice --hub-name {YourIoTHubName}

接続文字列の出力形式は次のとおりです。

HostName=<your IoT Hub name>.azure-devices.net;DeviceId=<your device id>;SharedAccessKey=<some value>

接続文字列を安全な場所に保存します。

注

CLI アプリを開いたままにします。後の手順で使用します。

サービス接続文字列を取得する

また、バックエンドアプリケーションが IoT ハブに接続してメッセージを取得できるようにするには、IoT ハブの サービス接続文字列 も必要です。次のコマンドは、IoT ハブのサービス接続文字列を取得します。

YourIoTHubName: 次のコマンドのこのプレースホルダーを、IoT ハブ用に選択した名前に置き換えます。

az iot hub connection-string show \
  --policy-name service --hub-name {YourIoTHubName} --output table

次のようなサービス接続文字列を書き留めます。

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

この値は、クイックスタートの後半で使用します。このサービス接続文字列は、前の手順で説明したデバイス接続文字列とは異なります。

デバイスをシミュレートする

ローカルターミナルウィンドウで、サンプル Node.js プロジェクトのルートフォルダーに移動します。次に、 iot-hub\Quickstarts\simulated-device-2 フォルダーに 移動します。
任意のテキストエディターで SimulatedDevice.js ファイルを開きます。

connectionString変数の値を、前にメモしたデバイス接続文字列に置き換えます。その後、変更を SimulatedDevice.jsに保存します。
ローカルターミナルウィンドウで、次のコマンドを実行して必要なライブラリをインストールし、シミュレートされたデバイスアプリケーションを実行します。
```
npm install
node SimulatedDevice.js
```
次のスクリーンショットは、シミュレートされたデバイスアプリケーションが IoT ハブにテレメトリを送信するときの出力を示しています。

ダイレクトメソッドを呼び出す

バックエンドアプリケーションは、IoT ハブ上のサービス側エンドポイントに接続します。アプリケーションは、IoT ハブを介してデバイスに直接メソッド呼び出しを行い、受信確認をリッスンします。通常、IoT Hub バックエンドアプリケーションはクラウドで実行されます。

別のローカルターミナルウィンドウで、サンプル Node.js プロジェクトのルートフォルダーに移動します。次に、 iot-hub\Quickstarts\バックエンドアプリケーション フォルダーに移動します。
任意のテキストエディターで BackEndApplication.js ファイルを開きます。

connectionString変数の値を、前にメモしたサービス接続文字列に置き換えます。その後、変更を BackEndApplication.jsに保存します。
ローカルターミナルウィンドウで、次のコマンドを実行して必要なライブラリをインストールし、バックエンドアプリケーションを実行します。
```
npm install
node BackEndApplication.js
```
次のスクリーンショットは、アプリケーションがデバイスへのダイレクトメソッド呼び出しを行い、受信確認を受信する際の出力を示しています。

バックエンドアプリケーションを実行すると、シミュレートされたデバイスを実行しているローカルターミナルウィンドウにメッセージが表示され、メッセージの送信速度が変わります。

このクイックスタートでは、次の 2 つの Python アプリケーションを使用します。

バックエンドアプリケーションから呼び出されたダイレクトメソッドに応答するシミュレートされたデバイスアプリケーション。
シミュレートされたデバイスでダイレクトメソッドを呼び出すバックエンドアプリケーション。

[前提条件]

アクティブなサブスクリプションを持つ Azure アカウント。無料で作成できます。
Python 3.7 以降。サポートされている Python のその他のバージョンについては、 Azure IoT デバイスの機能に関するページを参照してください。
GitHub から Azure IoT Python サンプルを複製またはダウンロードします。
ポート 8883 がファイアウォールで開放されていることを確認してください。このクイックスタートのデバイスサンプルでは、ポート 8883 経由で通信する MQTT プロトコルを使用します。このポートは、企業や教育用のネットワーク環境によってはブロックされている場合があります。この問題を回避する方法の詳細については、「MQTT プロトコルを使用して IoT ハブと通信する」の「 IoT Hub への接続」セクションを参照してください。

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 を実行します。

注

拡張機能の従来のバージョンを削除するには、az extension remove --name azure-cli-iot-ext を使用します。

拡張機能の新しいバージョンを追加するには、az extension add --name azure-iot を使用します。

現在インストールされている拡張機能を確認するには、 az extension listを使用します。

IoT ハブを作成する

Azure サブスクリプションに IoT ハブが既にある場合は、このセクションをスキップできます。

IoT ハブとリソースグループを作成するには、次のようにします。

CLI アプリを起動します。この記事の以降の部分で CLI コマンドを実行するには、コマンド構文をコピーして CLI アプリに貼り付け、変数の値を編集して Enter を押します。
- Cloud Shell を使用する場合は、CLI コマンドの [Try It](試してみる) ボタンを選択すると、分割されたブラウザーウィンドウで Cloud Shell が起動します。また、別のブラウザータブで Cloud Shell を開くこともできます。
- Azure CLI をローカルで使用している場合は、CLI コンソールアプリを起動し、Azure CLI にサインインします。
az extension add を実行して、azure-iot 拡張機能をインストールするか、最新バージョンにアップグレードします。
```
az extension add --upgrade --name azure-iot
```
CLI アプリで az group create コマンドを実行してリソースグループを作成します。次のコマンドは、myResourceGroup という名前のリソースグループを eastus という場所に作成します。

注

必要に応じて、別の場所を設定できます。選択できる場所を確認するには、az account list-locations を実行します。コマンド例を見るとわかるように、このクイックスタートでは eastus を使用しています。
```
az group create --name MyResourceGroup --location eastus
```
az iot hub create コマンドを実行して、IoT ハブを作成します。 IoT ハブの作成には数分かかることがあります。

YourIoTHubName。以下のコマンドでは、選択した IoT ハブの名前に合わせて、プレースホルダーとそれを囲む中かっこを置き換えます。 IoT ハブ名は Azure でグローバルに一意である必要があります。以降、このクイックスタートに出現しているプレースホルダーにはすべて、実際の IoT ハブの名前を使用してください。
```
az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
```

デバイスの登録

IoT ハブにデバイスが既に登録されている場合は、このセクションをスキップできます。

デバイス ID を作成するには:

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

YourIoTHubName。以下のコマンドでは、選択した IoT ハブの名前に合わせて、プレースホルダーとそれを囲む中かっこを置き換えます。 IoT ハブ名は Azure でグローバルに一意である必要があります。

myDevice。この記事全体でデバイス ID にこの名前を使用することも、別のデバイス名を指定することもできます。
```
az iot hub device-identity create --device-id myDevice --hub-name {YourIoTHubName}
```

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

az iot hub device-identity connection-string show --device-id myDevice --hub-name {YourIoTHubName}

接続文字列の出力形式は次のとおりです。

HostName=<your IoT Hub name>.azure-devices.net;DeviceId=<your device id>;SharedAccessKey=<some value>

接続文字列を安全な場所に保存します。

注

CLI アプリを開いたままにします。後の手順で使用します。

サービス接続文字列を取得する

YourIoTHubName: 次のコマンドのこのプレースホルダーを、IoT ハブに対して選択した名前に置き換えます。

az iot hub connection-string show \
  --policy-name service \
  --hub-name {YourIoTHubName} \
  --output table

次のようなサービス接続文字列を書き留めます。

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

この値は、クイックスタートの後半で使用します。このサービス接続文字列は、前の手順で説明したデバイス接続文字列とは異なります。

デバイスをシミュレートする

ローカルターミナルウィンドウで、サンプル Python プロジェクトのルートフォルダーに移動します。次に、 iot-hub\Quickstarts\simulated-device-2 フォルダーに 移動します。
任意のテキストエディターで SimulatedDeviceSync.py ファイルを開きます。

CONNECTION_STRING変数の値を、前にメモしたデバイス接続文字列に置き換えます。次に、変更を SimulatedDeviceSync.py に保存します。
ローカルターミナルウィンドウで、次のコマンドを実行して、シミュレートされたデバイスアプリケーションに必要なライブラリをインストールします。
```
pip install azure-iot-device
```
ローカルターミナルウィンドウで、次のコマンドを実行して、シミュレートされたデバイスアプリケーションを実行します。
```
python SimulatedDeviceSync.py
```
次のスクリーンショットは、シミュレートされたデバイスアプリケーションが IoT ハブにテレメトリを送信するときの出力を示しています。

ダイレクトメソッドを呼び出す

別のローカルターミナルウィンドウで、サンプル Python プロジェクトのルートフォルダーに移動します。次に、 iot-hub\Quickstarts\バックエンドアプリケーション フォルダーに移動します。
任意のテキストエディターで BackEndApplication.py ファイルを開きます。

CONNECTION_STRING変数の値を、前にメモしたサービス接続文字列に置き換えます。次に、変更を BackEndApplication.py に保存します。
ローカルターミナルウィンドウで、次のコマンドを実行して、シミュレートされたデバイスアプリケーションに必要なライブラリをインストールします。
```
pip install azure-iot-hub
```
ローカルターミナルウィンドウで、次のコマンドを実行してバックエンドアプリケーションを実行します。
```
python BackEndApplication.py
```
次のスクリーンショットは、アプリケーションがデバイスへのダイレクトメソッド呼び出しを行い、受信確認を受信する際の出力を示しています。

バックエンドアプリケーションを実行すると、シミュレートされたデバイスを実行しているコンソールウィンドウにメッセージが表示され、メッセージの送信速度が変わります。

リソースをクリーンアップする

次の推奨記事に進む場合は、既に作成したリソースを保持して再利用できます。

それ以外の場合は、課金を回避するために、この記事で作成した Azure リソースを削除できます。

Important

リソースグループを削除すると、元に戻すことができません。リソースグループとそこに含まれるすべてのリソースは完全に削除されます。間違ったリソースグループやリソースをうっかり削除しないようにしてください。保持するリソースを含む既存のリソースグループ内に IoT ハブを作成した場合は、リソースグループを削除するのではなく、IoT Hub リソース自体のみを削除してください。

リソースグループを名前で削除するには:

Azure portal にサインインし、 [リソースグループ] を選択します。
[ 任意のフィールドのフィルター] ボックスに、IoT ハブを含むリソースグループの名前を入力します。
結果の一覧で、IoT ハブを含むリソースグループを選択します。
リソースグループの作業ウィンドウで、コマンドバーから [リソースグループの削除 ] を選択します。
リソースグループの削除の確認を求めるメッセージが表示されます。確認のためにもう一度リソースグループの名前を入力し、 [削除] を選択します。しばらくすると、リソースグループとそこに含まれているすべてのリソースが削除されます。

次のステップ

このクイックスタートでは、サービスアプリケーションからデバイスでダイレクトメソッドを呼び出し、シミュレートされたデバイスアプリケーションのダイレクトメソッド呼び出しに応答しました。

デバイスからクラウドへのメッセージをクラウド内のさまざまな宛先にルーティングする方法については、次のチュートリアルに進んでください。

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

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-10-09

次の方法で共有

クイック スタート: IoT ハブに接続されているデバイスを制御する

[前提条件]

サービス接続文字列を取得する

デバイスをシミュレートする

ダイレクト メソッドを呼び出す

[前提条件]

IoT ハブを作成する

デバイスの登録

サービス接続文字列を取得する

デバイスをシミュレートする

ダイレクト メソッドを呼び出す

[前提条件]

IoT ハブを作成する

デバイスの登録

サービス接続文字列を取得する

デバイスをシミュレートする

ダイレクト メソッドを呼び出す

[前提条件]

IoT ハブを作成する

デバイスの登録

サービス接続文字列を取得する

デバイスをシミュレートする

ダイレクト メソッドを呼び出す

リソースをクリーンアップする

次のステップ

フィードバック

その他のリソース

クイックスタート: IoT ハブに接続されているデバイスを制御する

ダイレクトメソッドを呼び出す

ダイレクトメソッドを呼び出す

ダイレクトメソッドを呼び出す

ダイレクトメソッドを呼び出す