Modules - Get Identity

Servicio:

IoT Hub

Versión de la API:

2021-04-12

Obtiene una identidad de módulo en el dispositivo.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
id	path	True	string	Identificador único del dispositivo.
mid	path	True	string	Identificador único del módulo.
api-version	query	True	string	Versión de la API.

Respuestas

Nombre	Tipo	Description
200 OK	Module	Aceptar.

Definiciones

Nombre	Description
AuthenticationMechanism
Module	Identidad del módulo en un dispositivo.
SymmetricKey
X509Thumbprint

AuthenticationMechanism

Nombre	Tipo	Description
symmetricKey	SymmetricKey	Claves principales y secundarias usadas para la autenticación basada en SAS.
type	enum: certificateAuthority none sas selfSigned	Tipo de autenticación que se usa para conectarse al servicio.
x509Thumbprint	X509Thumbprint	Las huellas digitales x509 principales y secundarias usadas para la autenticación basada en x509.

Module

Identidad del módulo en un dispositivo.

Nombre	Tipo	Description
authentication	AuthenticationMechanism	Mecanismo de autenticación utilizado por el módulo al conectarse al servicio y al centro perimetral.
cloudToDeviceMessageCount	integer	Número de mensajes de nube a módulo actualmente en cola para enviarse al módulo.
connectionState	enum: Connected Disconnected	Estado de conexión del dispositivo.
connectionStateUpdatedTime	string	Fecha y hora en que se actualizó por última vez el estado de conexión.
deviceId	string	Identificador único del dispositivo.
etag	string	Cadena que representa una ETag débil para la identidad del módulo, según RFC7232.
generationId	string	El IoT Hub genera una cadena con distinción entre mayúsculas y minúsculas de hasta 128 caracteres. Este valor se usa para distinguir los módulos con el mismo moduleId, cuando se han eliminado y vuelto a crear.
lastActivityTime	string	Fecha y hora en que el dispositivo se conectó, recibió o envió un mensaje por última vez.
managedBy	string	Identifica quién administra este módulo. Por ejemplo, este valor es "IotEdge" si el entorno de ejecución perimetral posee este módulo.
moduleId	string	Identificador único del módulo.

SymmetricKey

Nombre	Tipo	Description
primaryKey	string	Clave principal codificada en base64 del dispositivo.
secondaryKey	string	Clave secundaria codificada en base64 del dispositivo.

X509Thumbprint

Nombre	Tipo	Description
primaryThumbprint	string	Huella digital principal del certificado de cliente X509.
secondaryThumbprint	string	Huella digital secundaria del certificado de cliente X509.