Dela via


Modules - Get Identity

Hämtar en modulidentitet på enheten.

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

URI-parametrar

Name I Obligatorisk Typ Description
id
path True

string

Enhetens unika identifierare.

mid
path True

string

Den unika identifieraren för modulen.

api-version
query True

string

Version av API:et.

Svar

Name Typ Description
200 OK

Module

OK.

Definitioner

Name Description
AuthenticationMechanism
Module

Modulidentiteten på en enhet.

SymmetricKey
X509Thumbprint

AuthenticationMechanism

Name Typ Description
symmetricKey

SymmetricKey

De primära och sekundära nycklar som används för SAS-baserad autentisering.

type enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned

Den typ av autentisering som används för att ansluta till tjänsten.

x509Thumbprint

X509Thumbprint

De primära och sekundära x509-tumavtrycken som används för x509-baserad autentisering.

Module

Modulidentiteten på en enhet.

Name Typ Description
authentication

AuthenticationMechanism

Autentiseringsmekanismen som används av modulen vid anslutning till tjänsten och gränshubben.

cloudToDeviceMessageCount

integer

Antalet moln-till-modul-meddelanden som för närvarande placeras i kö för att skickas till modulen.

connectionState enum:
  • Connected
  • Disconnected

Enhetens anslutningstillstånd.

connectionStateUpdatedTime

string

Datum och tid då anslutningstillståndet senast uppdaterades.

deviceId

string

Enhetens unika identifierare.

etag

string

Strängen som representerar en svag ETag för modulidentiteten enligt RFC7232.

generationId

string

Den IoT Hub genererade skiftlägeskänsliga strängen upp till 128 tecken lång. Det här värdet används för att skilja moduler med samma moduleId när de har tagits bort och återskapats.

lastActivityTime

string

Datum och tid då enheten senast anslöt, tog emot eller skickade ett meddelande.

managedBy

string

Identifierar vem som hanterar den här modulen. Det här värdet är till exempel "IotEdge" om edge-körningen äger den här modulen.

moduleId

string

Den unika identifieraren för modulen.

SymmetricKey

Name Typ Description
primaryKey

string

Den base64-kodade primärnyckeln för enheten.

secondaryKey

string

Enhetens base64-kodade sekundära nyckel.

X509Thumbprint

Name Typ Description
primaryThumbprint

string

X509-klientcertifikatets primära tumavtryck.

secondaryThumbprint

string

X509-klientcertifikatets sekundära tumavtryck.