Devices - Get Devices
Lekéri több eszköz identitását az IoT Hub identitásjegyzékből. Nem ajánlott. Az IoT Hub lekérdezési API-val lekérheti az ikereszköz- és eszközidentitás-adatokat. További https://docs.microsoft.com/en-us/rest/api/iothub/service/queryiothub információ: és https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-query-language .
GET https://fully-qualified-iothubname.azure-devices.net/devices?api-version=2021-04-12GET https://fully-qualified-iothubname.azure-devices.net/devices?top={top}&api-version=2021-04-12URI-paraméterek
| Name | In | Kötelező | Típus | Description |
|---|---|---|---|---|
|
api-version
|
query | True |
string |
Az Api verziója. |
|
top
|
query |
integer int32 |
A lekérdezés által visszaadott eszközidentitások maximális száma. Az 1-1000 tartományon kívül eső értékek 1000-nek minősülnek. |
Válaszok
| Name | Típus | Description |
|---|---|---|
| 200 OK |
Device[] |
OK gombra. |
Definíciók
| Name | Description |
|---|---|
|
Authentication |
|
| Device | |
|
Device |
Az eszközön engedélyezett képességek állapota. |
|
Symmetric |
|
| X509Thumbprint |
AuthenticationMechanism
| Name | Típus | Description |
|---|---|---|
| symmetricKey |
Az SAS-alapú hitelesítéshez használt elsődleges és másodlagos kulcsok. |
|
| type |
enum:
|
A szolgáltatáshoz való csatlakozáshoz használt hitelesítés típusa. |
| x509Thumbprint |
Az x509-alapú hitelesítéshez használt elsődleges és másodlagos x509 ujjlenyomatok. |
Device
| Name | Típus | Description |
|---|---|---|
| authentication |
Az eszköz által használt hitelesítési mechanizmus. |
|
| capabilities |
Az eszköz képességeinek halmaza. Ha például ez az eszköz egy peremeszköz, vagy sem. |
|
| cloudToDeviceMessageCount |
integer |
Az eszközre küldendő, jelenleg várólistán lévő felhőből eszközre irányuló üzenetek száma. |
| connectionState |
enum:
|
Az eszköz állapota. |
| connectionStateUpdatedTime |
string |
A kapcsolati állapot legutóbbi frissítésének dátuma és időpontja. |
| deviceId |
string |
Az eszköz egyedi azonosítója. |
| deviceScope |
string |
Az eszköz hatóköre. Automatikusan létrehozott és nem módosítható peremeszközökhöz, és módosítható a levéleszközökben a gyermek-szülő kapcsolat létrehozásához. |
| etag |
string |
Az eszközidentitás gyenge ETag-jének megfelelő sztring, a RFC7232 szerint. |
| generationId |
string |
A IoT Hub által létrehozott, legfeljebb 128 karakter hosszú kis- és nagybetűkre érzékeny sztring. Ez az érték az azonos deviceId azonosítójú eszközök megkülönböztetésére szolgál, amikor törölték és újra létrehozták őket. |
| lastActivityTime |
string |
Az eszköz legutóbbi csatlakoztatásának, fogadásának vagy üzenetküldésének dátuma és utolsó időpontja. |
| parentScopes |
string[] |
A felső szintű peremeszközök hatókörei, ha vannak. Csak peremeszközökhöz érhető el. |
| status |
enum:
|
Az eszköz állapota. Ha az állapot le van tiltva, az eszköz nem tud csatlakozni a szolgáltatáshoz. |
| statusReason |
string |
Az eszközidentitás állapotának okát tároló 128 karakter hosszúságú sztring. Minden UTF-8 karakter megengedett. |
| statusUpdatedTime |
string |
Az állapotmező utolsó frissítésének dátuma és időpontja. |
DeviceCapabilities
Az eszközön engedélyezett képességek állapota.
| Name | Típus | Description |
|---|---|---|
| iotEdge |
boolean |
Az a tulajdonság, amely meghatározza, hogy az eszköz peremeszköz-e vagy sem. |
SymmetricKey
| Name | Típus | Description |
|---|---|---|
| primaryKey |
string |
Az eszköz base64 kódolású elsődleges kulcsa. |
| secondaryKey |
string |
Az eszköz base64 kódolású másodlagos kulcsa. |
X509Thumbprint
| Name | Típus | Description |
|---|---|---|
| primaryThumbprint |
string |
Az X509 ügyféltanúsítvány elsődleges ujjlenyomata. |
| secondaryThumbprint |
string |
Az X509 ügyféltanúsítvány másodlagos ujjlenyomata. |