Modules - Get Identity
Obtient une identité de module sur l’appareil.
GET https://fully-qualified-iothubname.azure-devices.net/devices/{id}/modules/{mid}?api-version=2021-04-12
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
id
|
path | True |
string |
Identificateur unique de l’appareil. |
|
mid
|
path | True |
string |
Identificateur unique du module. |
|
api-version
|
query | True |
string |
Version de l’API. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
D’ACCORD. |
Définitions
| Nom | Description |
|---|---|
|
Authentication |
|
| Module |
Identité du module sur un appareil. |
|
Symmetric |
|
| X509Thumbprint |
AuthenticationMechanism
| Nom | Type | Description |
|---|---|---|
| symmetricKey |
Clés primaires et secondaires utilisées pour l’authentification basée sur SAP. |
|
| type |
enum:
|
Type d’authentification utilisé pour se connecter au service. |
| x509Thumbprint |
Empreintes principales et secondaires x509 utilisées pour l’authentification basée sur x509. |
Module
Identité du module sur un appareil.
| Nom | Type | Description |
|---|---|---|
| authentication |
Mécanisme d’authentification utilisé par le module lors de la connexion au service et au hub edge. |
|
| cloudToDeviceMessageCount |
integer (int32) |
Nombre de messages cloud-à-module actuellement mis en file d’attente à envoyer au module. |
| connectionState |
enum:
|
État de connexion de l’appareil. |
| connectionStateUpdatedTime |
string (date-time) |
Date et heure de la dernière mise à jour de l’état de connexion. |
| deviceId |
string |
Identificateur unique de l’appareil. |
| etag |
string |
Chaîne représentant un ETag faible pour l’identité du module, conformément à RFC7232. |
| generationId |
string |
Chaîne sensible à la casse générée par IoT Hub jusqu’à 128 caractères. Cette valeur est utilisée pour distinguer les modules avec le même moduleId, lorsqu’ils ont été supprimés et recréés. |
| lastActivityTime |
string (date-time) |
Date et heure de la dernière connexion, réception ou envoi d’un message sur l’appareil. |
| managedBy |
string |
Identifie qui gère ce module. Par exemple, cette valeur est « IotEdge » si le runtime edge possède ce module. |
| moduleId |
string |
Identificateur unique du module. |
SymmetricKey
| Nom | Type | Description |
|---|---|---|
| primaryKey |
string |
Clé primaire encodée en base64 de l’appareil. |
| secondaryKey |
string |
Clé secondaire encodée en base64 de l’appareil. |
X509Thumbprint
| Nom | Type | Description |
|---|---|---|
| primaryThumbprint |
string |
Empreinte numérique principale du certificat client X509. |
| secondaryThumbprint |
string |
Empreinte numérique secondaire du certificat client X509. |