initiate_device_claim

initiate_device_claim(**kwargs)

Given a device ID, initiates a claim request for the associated device.

Note

Claiming a device consists of initiating a claim, then publishing a device event, and finalizing the claim. For a device of type button, a device event can be published by simply clicking the device.

See also: AWS API Documentation

Request Syntax

response = client.initiate_device_claim(
    DeviceId='string'
)
Parameters
DeviceId (string) --

[REQUIRED]

The unique identifier of the device.

Return type
dict
Returns
Response Syntax
{
    'State': 'string'
}

Response Structure

  • (dict) --

    200 response

    • State (string) --

      The device's final claim state.

Exceptions

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