Service - Get Device

Retrieve a device from the identity registry of an IoT hub.

GET https://fully-qualified-iothubname.azure-devices.net/devices/{id}?api-version=2018-06-30

URI Parameters

Name In Required Type Description
id
path True
  • string

Device ID.

api-version
query True
  • string

Version of the Api.

Responses

Name Type Description
200 OK

Returns the Device object

Definitions

AuthenticationMechanism
Device
DeviceCapabilities

Status of Capabilities enabled on the device

SymmetricKey
X509Thumbprint

AuthenticationMechanism

Name Type Description
symmetricKey
type enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned
x509Thumbprint

Device

Name Type Description
authentication
capabilities

Status of Capabilities enabled on the device

cloudToDeviceMessageCount
  • integer
connectionState enum:
  • Connected
  • Disconnected
connectionStateUpdatedTime
  • string
deviceId
  • string
etag
  • string
generationId
  • string
lastActivityTime
  • string
status enum:
  • disabled
  • enabled
statusReason
  • string
statusUpdatedTime
  • string

DeviceCapabilities

Status of Capabilities enabled on the device

Name Type Description
iotEdge
  • boolean

SymmetricKey

Name Type Description
primaryKey
  • string
secondaryKey
  • string

X509Thumbprint

Name Type Description
primaryThumbprint
  • string
secondaryThumbprint
  • string