ManagedintegrationsforIoTDeviceManagement / Client / start_device_discovery

start_device_discovery#

ManagedintegrationsforIoTDeviceManagement.Client.start_device_discovery(**kwargs)#

During user-guided setup, this is used to start device discovery. The authentication material (install code) is passed as a message to the controller telling it to start the discovery.

See also: AWS API Documentation

Request Syntax

response = client.start_device_discovery(
    DiscoveryType='ZWAVE'|'ZIGBEE'|'CLOUD',
    ControllerIdentifier='string',
    ConnectorAssociationIdentifier='string',
    AuthenticationMaterial='string',
    AuthenticationMaterialType='ZWAVE_INSTALL_CODE',
    ClientToken='string',
    Tags={
        'string': 'string'
    }
)
Parameters:

  • DiscoveryType (string) –

    [REQUIRED]

    The discovery type supporting the type of device to be discovered in the device discovery job request.

  • ControllerIdentifier (string) – The id of the end-user’s IoT hub.

  • ConnectorAssociationIdentifier (string) – The id of the connector association.

  • AuthenticationMaterial (string) – The authentication material required to start the local device discovery job request.

  • AuthenticationMaterialType (string) – The type of authentication material used for device discovery jobs.

  • ClientToken (string) – An idempotency token. If you retry a request that completed successfully initially using the same client token and parameters, then the retry attempt will succeed without performing any further actions.

  • Tags (dict) –

    A set of key/value pairs that are used to manage the device discovery request.

    • (string) –

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'Id': 'string',
    'StartedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) –

    • Id (string) –

      The id of the device discovery job request.

    • StartedAt (datetime) –

      The timestamp value for the start time of the device discovery.

Exceptions