Devices - Get Devices
IoT Hub kimlik kayıt defterinden birden çok cihazın kimliklerini alır. Önerilmez. Cihaz ikizi ve cihaz kimliği bilgilerini almak için IoT Hub sorgu API'sini kullanın. Daha fazla bilgi için bkz https://docs.microsoft.com/en-us/rest/api/iothub/service/queryiothub . ve 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 Parametreleri
| Name | İçinde | Gerekli | Tür | Description |
|---|---|---|---|---|
|
api-version
|
query | True |
string |
Api sürümü. |
|
top
|
query |
integer int32 |
Sorgu tarafından döndürülen en fazla cihaz kimliği sayısı. 1-1000 aralığındaki herhangi bir değer 1000 olarak kabul edilir. |
Yanıtlar
| Name | Tür | Description |
|---|---|---|
| 200 OK |
Device[] |
Tamam ögesini seçin. |
Tanımlar
| Name | Description |
|---|---|
|
Authentication |
|
| Device | |
|
Device |
Cihazda etkinleştirilen özelliklerin durumu. |
|
Symmetric |
|
| X509Thumbprint |
AuthenticationMechanism
| Name | Tür | Description |
|---|---|---|
| symmetricKey |
SAS tabanlı kimlik doğrulaması için kullanılan birincil ve ikincil anahtarlar. |
|
| type |
enum:
|
Hizmete bağlanmak için kullanılan kimlik doğrulama türü. |
| x509Thumbprint |
x509 tabanlı kimlik doğrulaması için kullanılan birincil ve ikincil x509 parmak izleri. |
Device
| Name | Tür | Description |
|---|---|---|
| authentication |
Cihaz tarafından kullanılan kimlik doğrulama mekanizması. |
|
| capabilities |
Cihazın özellik kümesi. Örneğin, bu cihaz bir uç cihazsa veya değilse. |
|
| cloudToDeviceMessageCount |
integer |
Şu anda cihaza gönderilmek üzere kuyruğa alınan buluttan cihaza ileti sayısı. |
| connectionState |
enum:
|
Cihazın durumu. |
| connectionStateUpdatedTime |
string |
Bağlantı durumunun son güncelleştirildiği tarih ve saat. |
| deviceId |
string |
Cihazın benzersiz tanımlayıcısı. |
| deviceScope |
string |
Cihazın kapsamı. Uç cihazlar için otomatik olarak oluşturulan ve sabit olan ve alt/üst ilişki oluşturmak için yaprak cihazlarda değiştirilebilir. |
| etag |
string |
RFC7232 göre cihaz kimliği için zayıf bir ETag'i temsil eden dize. |
| generationId |
string |
128 karakter uzunluğunda IoT Hub oluşturulan büyük/küçük harfe duyarlı dize. Bu değer, silinip yeniden oluşturulduklarında aynı deviceId değerine sahip cihazları ayırt etmek için kullanılır. |
| lastActivityTime |
string |
Cihazın en son bağlanıp alındığı, alındığı veya ileti gönderdiği tarih ve son zaman. |
| parentScopes |
string[] |
Varsa üst düzey uç cihazların kapsamları. Yalnızca uç cihazlar için kullanılabilir. |
| status |
enum:
|
Cihazın durumu. Durum devre dışı bırakılırsa, cihaz hizmete bağlanamaz. |
| statusReason |
string |
Cihaz kimliği durumunun nedenini depolayan 128 karakter uzunluğunda dize. Tüm UTF-8 karakterlerine izin verilir. |
| statusUpdatedTime |
string |
Durum alanının son güncelleştirildiği tarih ve saat. |
DeviceCapabilities
Cihazda etkinleştirilen özelliklerin durumu.
| Name | Tür | Description |
|---|---|---|
| iotEdge |
boolean |
Cihazın bir uç cihaz olup olmadığını belirleyen özellik. |
SymmetricKey
| Name | Tür | Description |
|---|---|---|
| primaryKey |
string |
Cihazın base64 kodlanmış birincil anahtarı. |
| secondaryKey |
string |
Cihazın base64 kodlamalı ikincil anahtarı. |
X509Thumbprint
| Name | Tür | Description |
|---|---|---|
| primaryThumbprint |
string |
X509 istemci sertifikası birincil parmak izi. |
| secondaryThumbprint |
string |
X509 istemci sertifikası ikincil parmak izi. |