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-12
GET https://fully-qualified-iothubname.azure-devices.net/devices?top={top}&api-version=2021-04-12
URI-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. |