この記事では、Azure IoT Central アプリケーションでデバイスを管理する方法について説明します。 次のようにすることができます。
- [ デバイス ] ページを使用して、Azure IoT Central アプリケーションに接続されているデバイスを表示、追加、削除します。
- ビューからデバイス プロパティに格納されている値を変更して、デバイス メタデータを最新の状態に保ちます。
- ビューから特定のデバイスの設定を更新して、デバイスの動作を制御します。
デバイスを一括で管理する方法については、「 Azure IoT Central アプリケーションでデバイスを一括管理する」を参照してください。
IoT Central REST API を使用してデバイスを管理する方法については、「IoT Central REST API を使用してデバイスを管理する方法」を参照してください。
デバイスを表示する
個々のデバイスを表示するには:
左側のウィンドウで [ デバイス ] を選択します。 ここには、デバイス テンプレートの一覧と、組織からアクセスできるすべてのデバイスの一覧が表示されます。
デバイス テンプレートを選択します。
[ デバイス ] ページの右側のウィンドウには、そのデバイス テンプレートから作成された組織からアクセスできるデバイスの一覧が表示されます。
個々のデバイスを選択すると、そのデバイスのデバイスの詳細ページが表示されます。
ヒント
このページのフィルター ツールを使用して、特定の組織のデバイスを表示できます。
デバイスを監視する
[デバイス] ページを使用して、デバイスを監視および管理します。
次のビデオでは、デバイスの接続状態の監視について説明します。
デバイスの状態の値
すべてのデバイスは、UI に 1 つの状態値を持ちます。 デバイスの状態は、次のいずれかになります。
デバイスの状態は最初に登録済みです。 この状態は、デバイスが IoT Central で作成され、デバイス ID があることを意味します。 デバイスは次の場合に登録されます。
- [デバイス] ページに新しい実 デバイス が追加されます。
- [デバイス] ページの [インポート] を使用して、一連の デバイス が追加されます。
登録済みデバイスが Device Provisioning Service (DPS) を使用してプロビジョニング手順を完了すると、デバイスの状態が [プロビジョニング済み] に変わります。 プロビジョニング プロセスを完了するには、デバイスの登録に使用された デバイス ID 、SAS キーまたは X.509 証明書、 および ID スコープがデバイスに必要です。 DPS は、デバイスをプロビジョニングした後、IoT Central アプリケーションに接続し、データの送信を開始できます。
ブロックされたデバイスの状態は [ ブロック済み] です。 オペレーターは、デバイスをブロックおよびブロック解除できます。 デバイスがブロックされると、IoT Central アプリケーションにデータを送信できません。 オペレーターは、データの送信を再開する前に、デバイスのブロックを解除する必要があります。 オペレーターがデバイスのブロックを解除すると、状態は以前の値 [登録済み ] または [ プロビジョニング済み] に戻ります。
デバイスの状態が [承認待ち] の場合は、[デバイス接続グループ] ページで [自動承認] オプションが無効になっていることを意味します。 オペレーターは、プロビジョニングしてデータを送信する前に、デバイスを明示的に承認する必要があります。 [ デバイス] ページ で手動で登録されていないが、有効な資格情報で接続されているデバイスの状態は [承認待ち] です。 オペレーターは、[承認] ボタンを使用して [ デバイス ] ページからこれらのデバイスを 承認 できます。
次の表は、UI 内のデバイスの状態値が、デバイスと対話するために REST API によって使用される値にどのようにマップされるかを示しています。
| UI デバイスの状態 | 注記 | REST API Get |
|---|---|---|
| 承認待ち | デバイス接続グループで自動承認オプションが無効になっており、UI を介してデバイスが追加されませんでした。 ユーザーは、UI を使用する前に、デバイスを手動で承認する必要があります。 |
Provisioned: false Enabled: false |
| 登録済み | デバイスが自動的または手動で承認されました。 | Provisioned: false Enabled: true |
| プロビジョニング済み | デバイスがプロビジョニングされ、IoT Central アプリケーションに接続できます。 | Provisioned: true Enabled: true |
| Blocked | デバイスは、IoT Central アプリケーションへの接続を許可されていません。 他のいずれかの状態にあるデバイスをブロックできます。 |
Provisioned: 異なります Waiting for approval/Registered/Provisioned status Enabled: false |
デバイスの状態が [未割り当て] になっている場合もあります。 この状態は UI の [デバイスの状態 ] フィールドには表示されず、UI の [デバイス テンプレート ] フィールドに表示されます。 ただし、未 割り当て 状態のデバイスのデバイス一覧をフィルター処理できます。 デバイスの状態が [未割り当て] の場合、IoT Central に接続しているデバイスはデバイス テンプレートに割り当てられません。 この状況は、通常、次のシナリオで発生します。
- デバイス テンプレートを指定せずに、[デバイス] ページの [インポート] を使用して一連のデバイスが追加されます。
- デバイス テンプレートを指定せずに、[ デバイス ] ページでデバイスが手動で登録されました。 その後、デバイスは有効な資格情報で接続されます。
オペレーターは、[移行] ボタンを使用して [デバイス] ページからデバイス テンプレートにデバイスを割り当てることができます。
デバイス接続の状態
デバイスまたはエッジ デバイスが MQTT プロトコルを使用して接続すると、デバイスの接続イベントと切断イベントが生成されます。 デバイスはこれらのイベントを送信しません。IoT Central によって内部で生成されます。
次の図は、デバイスが接続するときに、時間枠の最後に接続がどのように登録されるかを示しています。 複数の接続イベントと切断イベントが発生した場合、IoT Central は時間枠の最後に最も近いイベントを登録します。 たとえば、デバイスが接続を切断して時間枠内に再接続すると、IoT Central によって接続イベントが登録されます。 現在、時間枠は約 1 分です。
デバイスの接続状態を監視する方法の詳細については、次のビデオをご覧ください。
Blob Storage を使用して、IoT データをクラウドの宛先にエクスポートする際に接続イベントと切断イベントを含めることができます。 詳細については、>デバイス接続状態イベントの制限についてを参照してください。
デバイスを追加する
Azure IoT Central アプリケーションにデバイスを追加するには:
左側のウィンドウで [ デバイス ] を選択します。
デバイスを作成するデバイス テンプレートを選択します。
+[新規]を選択します。
デバイス名と ID を入力するか、既定値をそのまま使用します。 デバイス名の最大長は 148 文字です。 デバイス ID の最大長は 128 文字です。
[シミュレートされた] トグルを [オン] または [オフ] に切り替えます。 実際のデバイスは、Azure IoT Central アプリケーションに接続する物理デバイス用です。 シミュレートされたデバイスには、Azure IoT Central によって生成されたサンプル データがあります。
アプリケーションで組織を使用する場合は、デバイスが属する組織を選択します。
ヒント
既定の組織を 組織 のドロップダウンに表示するように設定できます。
を選択してを作成します。
このデバイスは、このテンプレートのデバイス一覧に表示されます。 デバイスを選択して、デバイスのすべてのビューを含むデバイスの詳細ページを表示します。
デバイス接続情報を取得する
デバイスが IoT Central をプロビジョニングして接続するときは、IoT Central アプリケーションからの接続情報が必要です。
- アプリケーションを DPS に識別する ID スコープ 。
- デバイスの登録に使用されたデバイス ID 。
- SAS キーまたは X.509 証明書。
これらの値を見つけるには:
左側のウィンドウで [ デバイス ] を選択します。
デバイスの詳細を表示するには、デバイスの一覧でデバイスを選択します。
[接続] を選択して接続情報を表示します。 QR コードは、既定の SAS-IoT-Devices デバイス接続グループから派生した ID スコープ、デバイス ID、および主キーを含む JSON ドキュメントをエンコードします。
注
認証の種類が Shared Access Signature の場合、表示されるキーは既定の SAS-IoT-Devices デバイス接続グループから派生します。
組織の変更
デバイスを別の組織に移動するには、移行元と移行先の両方の組織にアクセスできる必要があります。 デバイスを移動するには:
左側のウィンドウで [ デバイス ] を選択します。
デバイスの一覧で移動するデバイスを選択します。
ドロップダウン メニューから [デバイスと組織の管理] を選択します。
デバイスの新しい組織を選択します。
保存 を選択します。
デバイスをテンプレートに移行する
[すべてのデバイス] でインポートを開始してデバイスを登録すると、デバイス テンプレートの関連付けなしでデバイスが作成されます。 デバイスに関するデータやその他の詳細を調べるには、デバイスをテンプレートに割り当てる必要があります。 デバイスをテンプレートに割り当てるには、次の手順に従います。
左側のウィンドウで [ デバイス ] を選択します。
左側のパネルで、[ すべてのデバイス] を選択します。
テンプレートに割り当てたい未割り当てのデバイスを選択してください。
[ 移行] を選択します。
使用可能なテンプレートの一覧からテンプレートを選択し、[ 移行] を選択します。
選択したデバイスは、選択したデバイス テンプレートに割り当てられます。
デバイスを削除する
Azure IoT Central アプリケーションから実際のデバイスまたはシミュレートされたデバイスを削除するには:
左側のウィンドウで [ デバイス ] を選択します。
削除するデバイスのデバイス テンプレートを選択します。
フィルター ツールを使用して、デバイスをフィルター処理して検索します。 削除するデバイスの横にあるチェック ボックスをオンにします。
[削除] を選択します。 この削除の状態は、デバイス操作パネルで追跡できます。
プロパティを変更する
クラウド プロパティは、市区町村やシリアル番号など、デバイスに関連付けられているデバイス メタデータです。 クラウド プロパティは IoT Central アプリケーションにのみ存在し、デバイスに同期されません。 書き込み可能なプロパティは、デバイスの動作を制御し、たとえばサーモスタット デバイスの目標温度を設定するなどして、デバイスの状態をリモートで設定できるようにします。 デバイスは、IoT Central 内で読み取り専用のデバイス プロパティを設定します。 デバイスの [ デバイスの詳細 ] ビューでプロパティを表示および更新できます。
左側のウィンドウで [ デバイス ] を選択します。
プロパティを変更するデバイスのデバイス テンプレートを選択し、ターゲット デバイスを選択します。
デバイスのプロパティを含むビューを選択します。このビューでは、値を入力し、ページの上部にある [保存] を選択できます。 ここでは、デバイスのプロパティとその現在の値が表示されます。 クラウド のプロパティと書き込み可能なプロパティには編集可能なフィールドがあり、デバイスのプロパティは読み取り専用です。 書き込み可能なプロパティの場合、フィールドの下部に同期状態が表示されます。
必要な値にプロパティを変更します。 一度に複数のプロパティを変更し、それらをすべて同時に更新できます。
[保存] を選択します。 書き込み可能なプロパティを保存した場合、値はデバイスに送信されます。 デバイスが書き込み可能なプロパティの変更を確認すると、状態は 同期済みに戻ります。 クラウド プロパティを保存した場合、値が更新されます。