Modules - Create Or Update Identity

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

Создает или обновляет удостоверение модуля для устройства в Центре Интернета вещей. Идентификатор модуля и generationId нельзя обновить пользователем.

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

Параметры URI

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

string

Уникальный идентификатор устройства.
mid
 path True

string

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

string

Версия API.

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

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

string

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

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

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

AuthenticationMechanism

Механизм проверки подлинности, используемый модулем при подключении к службе и пограничному концентратору.
cloudToDeviceMessageCount

integer (int32)

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

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

string (date-time)

Дата и время последнего обновления состояния подключения.
deviceId

string

Уникальный идентификатор устройства.
etag

string

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

string

Центр Интернета вещей создал строку с учетом регистра до 128 символов. Это значение используется для различения модулей с тем же идентификатором модуля, когда они были удалены и повторно созданы.
lastActivityTime

string (date-time)

Дата и время последнего подключения, получения или отправки сообщения устройства.
managedBy

string

Определяет, кто управляет этим модулем. Например, это значение имеет значение IotEdge, если среда выполнения edge владеет этим модулем.
moduleId

string

Уникальный идентификатор модуля.

Ответы

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

Module

ХОРОШО.
201 Created

Module

Созданный.

Определения

Имя Описание
AuthenticationMechanism
Module

Удостоверение модуля на устройстве.
SymmetricKey
X509Thumbprint

AuthenticationMechanism

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

SymmetricKey

Первичные и вторичные ключи, используемые для проверки подлинности на основе SAS.
type enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned

Тип проверки подлинности, используемый для подключения к службе.
x509Thumbprint

X509Thumbprint

Первичные и вторичные отпечатки x509, используемые для проверки подлинности на основе x509.

Module

Object

Удостоверение модуля на устройстве.

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

AuthenticationMechanism

Механизм проверки подлинности, используемый модулем при подключении к службе и пограничному концентратору.
cloudToDeviceMessageCount

integer (int32)

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

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

string (date-time)

Дата и время последнего обновления состояния подключения.
deviceId

string

Уникальный идентификатор устройства.
etag

string

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

string

Центр Интернета вещей создал строку с учетом регистра до 128 символов. Это значение используется для различения модулей с тем же идентификатором модуля, когда они были удалены и повторно созданы.
lastActivityTime

string (date-time)

Дата и время последнего подключения, получения или отправки сообщения устройства.
managedBy

string

Определяет, кто управляет этим модулем. Например, это значение имеет значение IotEdge, если среда выполнения edge владеет этим модулем.
moduleId

string

Уникальный идентификатор модуля.

SymmetricKey

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

string

Первичный ключ устройства в кодировке Base64.
secondaryKey

string

Вторичный ключ устройства в кодировке Base64.

X509Thumbprint

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

string

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

string

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