Megosztás a következőn keresztül:

Devices - Get Devices

  • Referencia
Szolgáltatás:
IoT Hub
API-verzió:
2021-04-12

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
Opcionális paraméterekkel: 
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
AuthenticationMechanism
Device
DeviceCapabilities

Az eszközön engedélyezett képességek állapota.
SymmetricKey
X509Thumbprint

AuthenticationMechanism

Objektum
Name Típus Description
symmetricKey

SymmetricKey

Az SAS-alapú hitelesítéshez használt elsődleges és másodlagos kulcsok.
type enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned

A szolgáltatáshoz való csatlakozáshoz használt hitelesítés típusa.
x509Thumbprint

X509Thumbprint

Az x509-alapú hitelesítéshez használt elsődleges és másodlagos x509 ujjlenyomatok.

Device

Objektum
Name Típus Description
authentication

AuthenticationMechanism

Az eszköz által használt hitelesítési mechanizmus.
capabilities

DeviceCapabilities

Az eszköz képességeinek halmaza. Ha például ez az eszköz egy peremeszköz, vagy sem.
cloudToDeviceMessageCount

integer (int32)

Az eszközre küldendő, jelenleg várólistán lévő felhőből eszközre irányuló üzenetek száma.
connectionState enum:
  • Connected
  • Disconnected

Az eszköz állapota.
connectionStateUpdatedTime

string (date-time)

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 (date-time)

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:
  • disabled
  • enabled

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 (date-time)

Az állapotmező utolsó frissítésének dátuma és időpontja.

DeviceCapabilities

Objektum

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

Objektum
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

Objektum
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.