Sdílet prostřednictvím


Query - Get Twins

Zadejte dotaz na IoT Hub a načtěte informace týkající se dvojčat zařízení pomocí jazyka podobného SQL. Další informace naleznete v tématu https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language. Stránkování je podporováno. Tím se vrátí pouze informace o dvojčatech zařízení.

POST https://fully-qualified-iothubname.azure-devices.net/devices/query?api-version=2021-04-12

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
api-version
query True

string

Verze rozhraní API.

Hlavička požadavku

Name Vyžadováno Typ Description
x-ms-continuation

string

Pokračovací token použitý k získání další stránky výsledků.

x-ms-max-item-count

string

Maximální počet položek vrácených na stránku Služba může použít jinou hodnotu, pokud zadaná hodnota není přijatelná.

Text požadavku

Name Typ Description
query

string

Řetězec dotazu.

Odpovědi

Name Typ Description
200 OK

Twin[]

OK.

Hlavičky

  • x-ms-item-type: string
  • x-ms-continuation: string

Definice

Name Description
DeviceCapabilities

Stav funkcí povolených na zařízení.

QuerySpecification

Požadavek dotazu JSON

Twin

Informace o stavu zařízení nebo modulu Ten se implicitně vytvoří a odstraní při vytvoření nebo odstranění odpovídající identity zařízení nebo modulu v IoT Hub.

TwinProperties

Požadované a hlášené vlastnosti dvojčete. Maximální hloubka objektu je 10.

X509Thumbprint

DeviceCapabilities

Stav funkcí povolených na zařízení.

Name Typ Description
iotEdge

boolean

Vlastnost, která určuje, jestli je zařízení hraničním zařízením, nebo ne.

QuerySpecification

Požadavek dotazu JSON

Name Typ Description
query

string

Řetězec dotazu.

Twin

Informace o stavu zařízení nebo modulu Ten se implicitně vytvoří a odstraní při vytvoření nebo odstranění odpovídající identity zařízení nebo modulu v IoT Hub.

Name Typ Description
authenticationType enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned

Typ ověřování používaný zařízením.

capabilities

DeviceCapabilities

Stav funkcí povolených na zařízení.

cloudToDeviceMessageCount

integer

Počet odeslaných zpráv typu cloud-zařízení.

connectionState enum:
  • Connected
  • Disconnected

Stav připojení zařízení.

deviceEtag

string

Řetězec představující ETag zařízení podle RFC7232.

deviceId

string

Jedinečný identifikátor zařízení v registru identit IoT Hub. Jedná se o řetězec rozlišující velká a malá písmena (až 128 znaků) 7bitových alfanumerických znaků ASCII. a následující speciální znaky {-', ':', '.', '+', '%', '_', '#', '*', '?', '!', ',', ',', '=', '@', ';', '$', ''}.

deviceScope

string

Rozsah zařízení.

etag

string

Řetězec představující ETag dvojčete zařízení podle RFC7232.

lastActivityTime

string

Datum a čas, kdy se zařízení naposledy připojilo, přijalo nebo odeslalo zprávu. Datum a čas jsou v ISO8601 formátu datetime ve formátu UTC, například 2015-01-28T16:24:48.789Z. Tato hodnota se neaktualizuje, pokud zařízení k provádění operací zasílání zpráv používá protokol HTTP/1.

moduleId

string

Jedinečný identifikátor modulu v registru identit IoT Hub. Jedná se o řetězec rozlišující velká a malá písmena (až 128 znaků) 7bitových alfanumerických znaků ASCII. a následující speciální znaky {-', ':', '.', '+', '%', '_', '#', '*', '?', '!', ',', ',', '=', '@', ';', '$', ''}.

parentScopes

string[]

Rozsahy hraničních zařízení horní úrovně, pokud jsou k dispozici. K dispozici pouze pro hraniční zařízení.

properties

TwinProperties

Požadované a hlášené vlastnosti dvojčete.

status enum:
  • disabled
  • enabled

Stav povoleného zařízení. Pokud je tato možnost zakázaná, zařízení se nemůže ke službě připojit.

statusReason

string

Důvod aktuálního stavu zařízení, pokud existuje.

statusUpdateTime

string

Datum a čas poslední aktualizace stavu zařízení.

tags

object

Kolekce párů klíč-hodnota, které back-end řešení načítá a zapisuje. Nejsou viditelné aplikacím zařízení. Jejich klíče jsou kódované UTF-8, rozlišují se velká a malá písmena a mají délku až 1 kB. Povolené znaky nezahrnují řídicí znaky UNICODE (segmenty C0 a C1), ., $a mezeru. Hodnoty jsou objekty JSON o délce až 4 kB.

version

integer

Verze dvojčete zařízení včetně značek a požadovaných vlastností

x509Thumbprint

X509Thumbprint

Kryptografický otisk zařízení X509.

TwinProperties

Požadované a hlášené vlastnosti dvojčete. Maximální hloubka objektu je 10.

Name Typ Description
desired

object

Kolekce požadovaných párů klíč-hodnota vlastnosti. Klíče mají kódování UTF-8, rozlišují se velká a malá písmena a délku až 1 kB. Povolené znaky nezahrnují řídicí znaky UNICODE (segmenty C0 a C1), ., $a mezeru. Požadované hodnoty porperty jsou objekty JSON o délce až 4 kB.

reported

object

Kolekce hlášených párů klíč-hodnota vlastnosti. Klíče mají kódování UTF-8, rozlišují se velká a malá písmena a délku až 1 kB. Povolené znaky nezahrnují řídicí znaky UNICODE (segmenty C0 a C1), ., $a mezeru. Hlášené hodnoty vlastností jsou objekty JSON o délce až 4 kB.

X509Thumbprint

Name Typ Description
primaryThumbprint

string

Primární kryptografický otisk klientského certifikátu X509.

secondaryThumbprint

string

Sekundární kryptografický otisk klientského certifikátu X509.