describe_device

describe_device(**kwargs)

Given a device ID, returns a DescribeDeviceResponse object describing the details of the device.

See also: AWS API Documentation

Request Syntax

response = client.describe_device(
    DeviceId='string'
)

Parameters

DeviceId (string) --

[REQUIRED]

The unique identifier of the device.

Return type

dict

Returns

Response Syntax

{
    'DeviceDescription': {
        'Arn': 'string',
        'Attributes': {
            'string': 'string'
        },
        'DeviceId': 'string',
        'Enabled': True|False,
        'RemainingLife': 123.0,
        'Type': 'string',
        'Tags': {
            'string': 'string'
        }
    }
}

Response Structure

• (dict) --

  200 response

  • DeviceDescription (dict) --

    Device details.

    • Arn (string) --

      The ARN of the device.

    • Attributes (dict) --

      An array of zero or more elements of DeviceAttribute objects providing user specified device attributes.

      • (string) --
        • (string) --
    • DeviceId (string) --

      The unique identifier of the device.

    • Enabled (boolean) --

      A Boolean value indicating whether or not the device is enabled.

    • RemainingLife (float) --

      A value between 0 and 1 inclusive, representing the fraction of life remaining for the device.

    • Type (string) --

      The type of the device, such as "button".

    • Tags (dict) --

      The tags currently associated with the AWS IoT 1-Click device.

      • (string) --
        • (string) --

Exceptions

• IoT1ClickDevicesService.Client.exceptions.ResourceNotFoundException
• IoT1ClickDevicesService.Client.exceptions.InvalidRequestException
• IoT1ClickDevicesService.Client.exceptions.InternalFailureException