Udostępnij za pośrednictwem

Devices - Update Twin

  • Odwołanie
Usługa:
IoT Hub
Wersja interfejsu API:
2021-04-12

Aktualizacje tagów i żądanych właściwości bliźniaczej reprezentacji urządzenia. Aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-device-twins.

PATCH https://fully-qualified-iothubname.azure-devices.net/twins/{id}?api-version=2021-04-12

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
id
 path True

string

Unikatowy identyfikator urządzenia.
api-version
 query True

string

Wersja interfejsu API.

Nagłówek żądania

Nazwa Wymagane Typ Opis
If-Match

string

Ciąg reprezentujący słaby element ETag dla bliźniaczej reprezentacji urządzenia zgodnie z RFC7232. Określa, czy należy przeprowadzić operację aktualizacji.

Treść żądania

Nazwa Typ Opis
authenticationType enum:
  • sas
  • selfSigned
  • certificateAuthority
  • none

Typ uwierzytelniania używany przez urządzenie.
capabilities

DeviceCapabilities

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

integer

Liczba wysłanych komunikatów z chmury do urządzenia.
connectionState enum:
  • Disconnected
  • Connected

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 IoT Hub. Jest to ciąg uwzględniający wielkość liter (do 128 znaków długi) znaków ASCII 7-bitowych znaków alfanumerycznych, 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

Data i godzina ostatniego połączenia lub odebrania lub wysłania wiadomości przez urządzenie. Data i godzina są oddzielone ISO8601 formacie daty/godziny 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 IoT Hub. Jest to ciąg uwzględniający wielkość liter (do 128 znaków długi) znaków ASCII 7-bitowych znaków alfanumerycznych, 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.
status enum:
  • enabled
  • disabled

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

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, rozróżniane wielkość liter i długość do 1 KB. Dozwolone znaki wykluczają znaki sterujące UNICODE (segmenty C0 i C1), ".", "$" i spację. Wartości to obiekty JSON o długości do 4 KB.
version

integer

Wersja bliźniaczej reprezentacji urządzenia, w tym tagi i żądane właściwości
x509Thumbprint

X509Thumbprint

Odcisk palca X509 urządzenia.

Odpowiedzi

Nazwa Typ Opis
200 OK

Twin

OK.

Definicje

Nazwa Opis
DeviceCapabilities

Stan możliwości włączonych na urządzeniu.
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 IoT Hub.
TwinProperties

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

DeviceCapabilities

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.

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

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 IoT Hub. Jest to ciąg uwzględniający wielkość liter (do 128 znaków długi) znaków ASCII 7-bitowych znaków alfanumerycznych, 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

Data i godzina ostatniego połączenia lub odebrania lub wysłania wiadomości przez urządzenie. Data i godzina są oddzielone ISO8601 formacie daty/godziny 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 IoT Hub. Jest to ciąg uwzględniający wielkość liter (do 128 znaków długi) znaków ASCII 7-bitowych znaków alfanumerycznych, 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.
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

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, rozróżniane wielkość liter i długość do 1 KB. Dozwolone znaki wykluczają znaki sterujące UNICODE (segmenty C0 i C1), ".", "$" i spację. Wartości to obiekty JSON o długości do 4 KB.
version

integer

Wersja bliźniaczej reprezentacji urządzenia, w tym tagi i żądane właściwości
x509Thumbprint

X509Thumbprint

Odcisk palca X509 urządzenia.

TwinProperties

Żądane i zgłoszone właściwości bliźniaczej reprezentacji. 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, rozróżniane wielkość liter i długość do 1 KB. Dozwolone znaki wykluczają znaki sterujące UNICODE (segmenty C0 i C1), ".", "$" i spację. Żądane wartości porperty to obiekty JSON o długości do 4 KB.
reported

object

Kolekcja zgłoszonych par klucz-wartość właściwości. Klucze są zakodowane w formacie UTF-8, rozróżniane wielkość liter i długość do 1 KB. Dozwolone znaki wykluczają znaki sterujące UNICODE (segmenty C0 i C1), ".", "$" i spację. Zgłoszone wartości właściwości to obiekty JSON o długości do 4 KB.

X509Thumbprint

Nazwa Typ Opis
primaryThumbprint

string

Podstawowy odcisk palca certyfikatu klienta X509.
secondaryThumbprint

string

Pomocniczy odcisk palca certyfikatu klienta X509.