Поделиться через

Devices - Update Twin

  • Ссылка
Служба:
IoT Hub
Версия API:
2021-04-12

Обновляет теги и требуемые свойства двойника устройства. См. 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

Параметры URI

Имя В Обязательно Тип Описание
id
 path True

string

Уникальный идентификатор устройства.
api-version
 query True

string

Версия API.

Заголовок запроса

Имя Обязательно Тип Описание
If-Match

string

Строка, представляющая слабый ETag для двойника устройства, как по RFC7232. Он определяет, должна ли выполняться операция обновления.

Текст запроса

Имя Тип Описание
authenticationType enum:
  • sas
  • selfSigned
  • certificateAuthority
  • none

Тип проверки подлинности, используемый устройством.
capabilities

DeviceCapabilities

Состояние возможностей, включенных на устройстве.
cloudToDeviceMessageCount

integer (int32)

Количество отправленных сообщений из облака на устройство.
connectionState enum:
  • Disconnected
  • Connected

Состояние подключения устройства.
deviceEtag

string

Строка, представляющая ETag для устройства, как по RFC7232.
deviceId

string

Уникальный идентификатор устройства в реестре удостоверений Центра Интернета вещей. Это строка с учетом регистра (до 128 символов длиной) 7-разрядной буквенно-цифровых символов ASCII, и следующие специальные символы {'-", ":", ".", "+", "%", "_", "#", "#", "?", "!", "(", ")", ",", "=", "@", "@", "$", "$", ""}.
deviceScope

string

Область действия устройства.
etag

string

Строка, представляющая ETag для двойника устройства, как по RFC7232.
lastActivityTime

string (date-time)

Дата и время последнего подключения или получения или отправки сообщения устройства. Дата и время задается в формате даты и времени ISO8601 в формате UTC, например 2015-01-28T16:24:48.789Z. Это значение не обновляется, если устройство использует протокол HTTP/1 для выполнения операций обмена сообщениями.
moduleId

string

Уникальный идентификатор модуля в реестре удостоверений Центра Интернета вещей. Это строка с учетом регистра (до 128 символов длиной) 7-разрядной буквенно-цифровых символов ASCII, и следующие специальные символы {'-", ":", ".", "+", "%", "_", "#", "#", "?", "!", "(", ")", ",", "=", "@", "@", "$", "$", ""}.
parentScopes

string[]

Области пограничных устройств верхнего уровня, если это применимо. Доступно только для пограничных устройств.
properties

TwinProperties

Требуемые и сообщаемые свойства двойника.
status enum:
  • enabled
  • disabled

Состояние включенного устройства. Если устройство отключено, устройство не может подключиться к службе.
statusReason

string

Причина текущего состояния устройства, если она есть.
statusUpdateTime

string (date-time)

Дата и время последнего обновления состояния устройства.
tags

object

Коллекция пар "ключ-значение" считывает и записывается внутренним приложением решения. Они не видны приложениям устройств. Эти ключи кодируются в кодировке UTF-8, учитывает регистр и up-to 1 КБ длиной. Допустимые символы исключают символы элемента управления ЮНИКОД (сегменты C0 и C1), ".", "$" и пробелы. Значения — это объекты JSON, up-to 4 КБ в длину.
version

integer (int64)

Версия для двойника устройства, включая теги и требуемые свойства
x509Thumbprint

X509Thumbprint

Отпечаток X509 устройства.

Ответы

Имя Тип Описание
200 OK

Twin

ХОРОШО.

Определения

Имя Описание
DeviceCapabilities

Состояние возможностей, включенных на устройстве.
Twin

Сведения о состоянии устройства или модуля. Это неявно создается и удаляется при создании или удалении соответствующего удостоверения устройства или модуля в Центре Интернета вещей.
TwinProperties

Требуемые и сообщаемые свойства двойника. Максимальная глубина объекта составляет 10.
X509Thumbprint

DeviceCapabilities

Object

Состояние возможностей, включенных на устройстве.

Имя Тип Описание
iotEdge

boolean

Свойство, определяющее, является ли устройство пограничным устройством или нет.

Twin

Object

Сведения о состоянии устройства или модуля. Это неявно создается и удаляется при создании или удалении соответствующего удостоверения устройства или модуля в Центре Интернета вещей.

Имя Тип Описание
authenticationType enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned

Тип проверки подлинности, используемый устройством.
capabilities

DeviceCapabilities

Состояние возможностей, включенных на устройстве.
cloudToDeviceMessageCount

integer (int32)

Количество отправленных сообщений из облака на устройство.
connectionState enum:
  • Connected
  • Disconnected

Состояние подключения устройства.
deviceEtag

string

Строка, представляющая ETag для устройства, как по RFC7232.
deviceId

string

Уникальный идентификатор устройства в реестре удостоверений Центра Интернета вещей. Это строка с учетом регистра (до 128 символов длиной) 7-разрядной буквенно-цифровых символов ASCII, и следующие специальные символы {'-", ":", ".", "+", "%", "_", "#", "#", "?", "!", "(", ")", ",", "=", "@", "@", "$", "$", ""}.
deviceScope

string

Область действия устройства.
etag

string

Строка, представляющая ETag для двойника устройства, как по RFC7232.
lastActivityTime

string (date-time)

Дата и время последнего подключения или получения или отправки сообщения устройства. Дата и время задается в формате даты и времени ISO8601 в формате UTC, например 2015-01-28T16:24:48.789Z. Это значение не обновляется, если устройство использует протокол HTTP/1 для выполнения операций обмена сообщениями.
moduleId

string

Уникальный идентификатор модуля в реестре удостоверений Центра Интернета вещей. Это строка с учетом регистра (до 128 символов длиной) 7-разрядной буквенно-цифровых символов ASCII, и следующие специальные символы {'-", ":", ".", "+", "%", "_", "#", "#", "?", "!", "(", ")", ",", "=", "@", "@", "$", "$", ""}.
parentScopes

string[]

Области пограничных устройств верхнего уровня, если это применимо. Доступно только для пограничных устройств.
properties

TwinProperties

Требуемые и сообщаемые свойства двойника.
status enum:
  • disabled
  • enabled

Состояние включенного устройства. Если устройство отключено, устройство не может подключиться к службе.
statusReason

string

Причина текущего состояния устройства, если она есть.
statusUpdateTime

string (date-time)

Дата и время последнего обновления состояния устройства.
tags

object

Коллекция пар "ключ-значение" считывает и записывается внутренним приложением решения. Они не видны приложениям устройств. Эти ключи кодируются в кодировке UTF-8, учитывает регистр и up-to 1 КБ длиной. Допустимые символы исключают символы элемента управления ЮНИКОД (сегменты C0 и C1), ".", "$" и пробелы. Значения — это объекты JSON, up-to 4 КБ в длину.
version

integer (int64)

Версия для двойника устройства, включая теги и требуемые свойства
x509Thumbprint

X509Thumbprint

Отпечаток X509 устройства.

TwinProperties

Object

Требуемые и сообщаемые свойства двойника. Максимальная глубина объекта составляет 10.

Имя Тип Описание
desired

object

Коллекция пар "ключ-значение" требуемого свойства. Ключи кодируются в кодировке UTF-8, учитывает регистр и up-to 1 КБ длиной. Допустимые символы исключают символы элемента управления ЮНИКОД (сегменты C0 и C1), ".", "$" и пробелы. Требуемые значения порперти — это объекты JSON, up-to 4 КБ в длину.
reported

object

Коллекция пар "ключ-значение" свойства. Ключи кодируются в кодировке UTF-8, учитывает регистр и up-to 1 КБ длиной. Допустимые символы исключают символы элемента управления ЮНИКОД (сегменты C0 и C1), ".", "$" и пробелы. Указанные значения свойств — это объекты JSON, up-to 4 КБ в длину.

X509Thumbprint

Object
Имя Тип Описание
primaryThumbprint

string

Основной отпечаток сертификата клиента X509.
secondaryThumbprint

string

Вторичный отпечаток сертификата клиента X509.