Query - Get Twins

Usługa:

IoT Hub

Wersja interfejsu API:

2021-04-12

Wykonaj zapytanie względem usługi IoT Hub, aby pobrać informacje dotyczące bliźniaczych reprezentacji urządzeń przy użyciu języka przypominającego sql. Aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language. Stronicowanie jest obsługiwane. Zwraca to tylko informacje o bliźniaczych reprezentacjach urządzeń.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
api-version	query	True	string	Wersja interfejsu API.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
x-ms-continuation		string	Token kontynuacji używany do uzyskiwania następnej strony wyników.
x-ms-max-item-count		string	Maksymalna liczba zwracanych elementów na stronę. Usługa może użyć innej wartości, jeśli określona wartość nie jest akceptowalna.

Treść żądania

Nazwa	Typ	Opis
query	string	Ciąg zapytania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Twin[]	OK. Nagłówki x-ms-item-type: string x-ms-continuation: string

Definicje

Nazwa	Opis
DeviceCapabilities	Stan możliwości włączonych na urządzeniu.
QuerySpecification	Żądanie zapytania Json.
Twin	Informacje o stanie urządzenia lub modułu. Jest to niejawnie tworzone i usuwane po utworzeniu lub usunięciu odpowiedniej tożsamości urządzenia/modułu w usłudze IoT Hub.
TwinProperties	Żądane i zgłoszone właściwości bliźniaczej reprezentacji bliźniaczej. Maksymalna głębokość obiektu wynosi 10.
X509Thumbprint

DeviceCapabilities

Objekt

Stan możliwości włączonych na urządzeniu.

Nazwa	Typ	Opis
iotEdge	boolean	Właściwość określająca, czy urządzenie jest urządzeniem brzegowym, czy nie.

QuerySpecification

Objekt

Żądanie zapytania Json.

Nazwa	Typ	Opis
query	string	Ciąg zapytania.

Twin

Objekt

Informacje o stanie urządzenia lub modułu. Jest to niejawnie tworzone i usuwane po utworzeniu lub usunięciu odpowiedniej tożsamości urządzenia/modułu w usłudze IoT Hub.

Nazwa	Typ	Opis
authenticationType	enum: certificateAuthority none sas selfSigned	Typ uwierzytelniania używany przez urządzenie.
capabilities	DeviceCapabilities	Stan możliwości włączonych na urządzeniu.
cloudToDeviceMessageCount	integer (int32)	Liczba wysłanych komunikatów z chmury do urządzenia.
connectionState	enum: Connected Disconnected	Stan połączenia urządzenia.
deviceEtag	string	Ciąg reprezentujący element ETag dla urządzenia zgodnie z RFC7232.
deviceId	string	Unikatowy identyfikator urządzenia w rejestrze tożsamości usługi IoT Hub. Jest to ciąg uwzględniający wielkość liter (do 128 znaków długości) znaków alfanumerycznych ASCII 7-bitowych, i następujące znaki specjalne {'-', ':', '.', '+', '%', '_', '#', '*', '?', '!', '(', ')', ',', '=', '@', ';', '$', ''}.
deviceScope	string	Zakres urządzenia.
etag	string	Ciąg reprezentujący element ETag dla bliźniaczej reprezentacji urządzenia zgodnie z RFC7232.
lastActivityTime	string (date-time)	Data i godzina ostatniego połączenia lub odebrania lub wysłania komunikatu przez urządzenie. Data i godzina są oddzielone w formacie ISO8601 data/godzina w formacie UTC, na przykład 2015-01-28T16:24:48.789Z. Ta wartość nie jest aktualizowana, jeśli urządzenie używa protokołu HTTP/1 do wykonywania operacji obsługi komunikatów.
moduleId	string	Unikatowy identyfikator modułu w rejestrze tożsamości usługi IoT Hub. Jest to ciąg uwzględniający wielkość liter (do 128 znaków długości) znaków alfanumerycznych ASCII 7-bitowych, i następujące znaki specjalne {'-', ':', '.', '+', '%', '_', '#', '*', '?', '!', '(', ')', ',', '=', '@', ';', '$', ''}.
parentScopes	string[]	Zakresy urządzeń brzegowych najwyższego poziomu, jeśli ma to zastosowanie. Dostępne tylko dla urządzeń brzegowych.
properties	TwinProperties	Żądane i zgłoszone właściwości bliźniaczej reprezentacji bliźniaczej.
status	enum: disabled enabled	Stan włączonego urządzenia. Jeśli to ustawienie jest wyłączone, urządzenie nie może nawiązać połączenia z usługą.
statusReason	string	Przyczyna bieżącego stanu urządzenia, jeśli istnieje.
statusUpdateTime	string (date-time)	Data i godzina ostatniej aktualizacji stanu urządzenia.
tags	object	Kolekcja par klucz-wartość odczytanych i zapisanych przez zaplecze rozwiązania. Nie są one widoczne dla aplikacji urządzeń. Klucze są zakodowane w formacie UTF-8, z uwzględnieniem wielkości liter i up-to długości 1 KB. Dozwolone znaki wykluczają znaki sterujące UNICODE (segmenty C0 i C1), '.', '$' i spacji. Wartości to obiekty JSON, up-to długości 4 KB.
version	integer (int64)	Wersja bliźniaczej reprezentacji urządzenia, w tym tagi i żądane właściwości
x509Thumbprint	X509Thumbprint	Odcisk palca X509 urządzenia.

TwinProperties

Objekt

Żądane i zgłoszone właściwości bliźniaczej reprezentacji bliźniaczej. Maksymalna głębokość obiektu wynosi 10.

Nazwa	Typ	Opis
desired	object	Kolekcja par klucz-wartość żądanej właściwości. Klucze są zakodowane w formacie UTF-8, z uwzględnieniem wielkości liter i up-to długości 1 KB. Dozwolone znaki wykluczają znaki sterujące UNICODE (segmenty C0 i C1), '.', '$' i spacji. Żądane wartości porperty to obiekty JSON, up-to długości 4 KB.
reported	object	Kolekcja zgłoszonych par klucz-wartość właściwości. Klucze są zakodowane w formacie UTF-8, z uwzględnieniem wielkości liter i up-to długości 1 KB. Dozwolone znaki wykluczają znaki sterujące UNICODE (segmenty C0 i C1), '.', '$' i spacji. Zgłoszone wartości właściwości to obiekty JSON, up-to długości 4 KB.

X509Thumbprint

Objekt

Nazwa	Typ	Opis
primaryThumbprint	string	Podstawowy odcisk palca certyfikatu klienta X509.
secondaryThumbprint	string	Pomocniczy odcisk palca certyfikatu klienta X509.