対象:
IoT Edge 1.5
重要
IoT Edge 1.5 LTS は、サポートされているリリースです。 IoT Edge 1.4 LTS は 2024 年 11 月 12 日に終了しました。 以前のリリースを使用している場合は、「Update IoT Edgeを参照してください。
IoT Edge エージェント モジュールのダイレクト メソッドを使用して、IoT Edgeデプロイを監視および管理します。 ダイレクト メソッドはデバイスに実装され、クラウドから呼び出すことができます。 IoT Edge エージェントには、IoT Edge デバイスをリモートで監視および管理するためのダイレクト メソッドが含まれています。
ダイレクト メソッド、ダイレクト メソッドの使用方法、および独自のモジュールでの実装方法の詳細については、「understand を参照し、IoT Hub からダイレクト メソッドを呼び出します。
これらのダイレクト メソッドの名前では、大文字と小文字が区別されません。
ping
ping メソッドは、IoT Edgeがデバイスで実行されているかどうか、またはデバイスがIoT Hubへの接続を開いているかどうかを確認します。 このメソッドを使用して、IoT Edge エージェントに ping を実行し、その状態を確認します。 ping が成功すると、空のペイロードと "status": 200 が返されます。
次に例を示します。
az iot hub invoke-module-method --method-name 'ping' -n <hub name> -d <device name> -m '$edgeAgent'
Azure ポータルで、メソッド名 ping と空の JSON ペイロード {} を使用してメソッドを呼び出します。
モジュールの再起動
RestartModule メソッドを使用すると、IoT Edge デバイスで実行されているモジュールをリモートで管理できます。 モジュールが失敗した状態または異常な動作を報告する場合は、IoT Edge エージェントをトリガーして再起動します。 再起動コマンドが成功すると、 "status": 200 の空のペイロードが返されます。
RestartModule メソッドは、IoT Edge バージョン 1.0.9 以降で使用できます。
ヒント
Azure ポータルの [IoT Edge のトラブルシューティング] ページでは、モジュールの再起動が簡略化されます。 詳細については、Azure ポータルから IoT Edge デバイスの監視とトラブルシューティングを参照してください。
edgeAgent モジュールを含め、IoT Edge デバイスで実行されている任意のモジュールで RestartModule ダイレクト メソッドを使用します。 このダイレクト メソッドを使用して edgeAgent をシャットダウンした場合、モジュールの再起動中に接続が中断されるため、成功の結果は得られません。
次に例を示します。
az iot hub invoke-module-method --method-name 'RestartModule' -n <hub name> -d <device name> -m '$edgeAgent' --method-payload \
'
{
"schemaVersion": "1.0",
"id": "<module name>"
}
'
Azure ポータルで、次の JSON ペイロードRestartModuleメソッド名を使用します。
{
"schemaVersion": "1.0",
"id": "<module name>"
}
診断直接メソッド
- GetModuleLogs: ダイレクト メソッドの応答でモジュール ログを取得します。
- UploadModuleLogs: モジュール ログを取得し、Azure Blob Storageにアップロードします。
- UploadSupportBundle: サポート バンドルを使用してモジュール ログを取得し、zip ファイルをAzure Blob Storageにアップロードします。
- GetTaskStatus: アップロード ログまたはサポート バンドル要求の状態を確認します。
これらの診断ダイレクト メソッドは、1.0.10 リリース以降で利用できます。