Compartir a través de


Modules - Get Identity

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.