describe_detector

describe_detector(**kwargs)

Returns information about the specified detector (instance).

See also: AWS API Documentation

Request Syntax

response = client.describe_detector(
    detectorModelName='string',
    keyValue='string'
)

Parameters

• detectorModelName (string) --

  [REQUIRED]

  The name of the detector model whose detectors (instances) you want information about.

• keyValue (string) -- A filter used to limit results to detectors (instances) created because of the given key ID.

Return type

dict

Returns

Response Syntax

{
    'detector': {
        'detectorModelName': 'string',
        'keyValue': 'string',
        'detectorModelVersion': 'string',
        'state': {
            'stateName': 'string',
            'variables': [
                {
                    'name': 'string',
                    'value': 'string'
                },
            ],
            'timers': [
                {
                    'name': 'string',
                    'timestamp': datetime(2015, 1, 1)
                },
            ]
        },
        'creationTime': datetime(2015, 1, 1),
        'lastUpdateTime': datetime(2015, 1, 1)
    }
}

Response Structure

• (dict) --

  • detector (dict) --

    Information about the detector (instance).

    • detectorModelName (string) --

      The name of the detector model that created this detector (instance).

    • keyValue (string) --

      The value of the key (identifying the device or system) that caused the creation of this detector (instance).

    • detectorModelVersion (string) --

      The version of the detector model that created this detector (instance).

    • state (dict) --

      The current state of the detector (instance).

      • stateName (string) --

        The name of the state.

      • variables (list) --

        The current values of the detector's variables.

        • (dict) --

          The current state of the variable.

          • name (string) --

            The name of the variable.

          • value (string) --

            The current value of the variable.

      • timers (list) --

        The current state of the detector's timers.

        • (dict) --

          The current state of a timer.

          • name (string) --

            The name of the timer.

          • timestamp (datetime) --

            The expiration time for the timer.

    • creationTime (datetime) --

      The time the detector (instance) was created.

    • lastUpdateTime (datetime) --

      The time the detector (instance) was last updated.

Exceptions

• IoTEventsData.Client.exceptions.InvalidRequestException
• IoTEventsData.Client.exceptions.ResourceNotFoundException
• IoTEventsData.Client.exceptions.ThrottlingException
• IoTEventsData.Client.exceptions.InternalFailureException
• IoTEventsData.Client.exceptions.ServiceUnavailableException