Table of Contents
IoT1ClickDevicesService.
Client
¶A low-level client representing AWS IoT 1-Click Devices Service
Describes all of the AWS IoT 1-Click device-related API operations for the service. Also provides sample requests, responses, and errors for the supported web services protocols.
import boto3
client = boto3.client('iot1click-devices')
These are the available methods:
can_paginate()
claim_devices_by_claim_code()
close()
describe_device()
finalize_device_claim()
get_device_methods()
get_paginator()
get_waiter()
initiate_device_claim()
invoke_device_method()
list_device_events()
list_devices()
list_tags_for_resource()
tag_resource()
unclaim_device()
untag_resource()
update_device_state()
can_paginate
(operation_name)¶Check if an operation can be paginated.
create_foo
, and you'd normally invoke the
operation as client.create_foo(**kwargs)
, if the
create_foo
operation can be paginated, you can use the
call client.get_paginator("create_foo")
.True
if the operation can be paginated,
False
otherwise.claim_devices_by_claim_code
(**kwargs)¶Adds device(s) to your account (i.e., claim one or more devices) if and only if you received a claim code with the device(s).
See also: AWS API Documentation
Request Syntax
response = client.claim_devices_by_claim_code(
ClaimCode='string'
)
[REQUIRED]
The claim code, starting with "C-", as provided by the device manufacturer.
{
'ClaimCode': 'string',
'Total': 123
}
Response Structure
200 response
The claim code provided by the device manufacturer.
The total number of devices associated with the claim code that has been processed in the claim request.
Exceptions
IoT1ClickDevicesService.Client.exceptions.InvalidRequestException
IoT1ClickDevicesService.Client.exceptions.InternalFailureException
IoT1ClickDevicesService.Client.exceptions.ForbiddenException
close
()¶Closes underlying endpoint connections.
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'
)
[REQUIRED]
The unique identifier of the device.
{
'DeviceDescription': {
'Arn': 'string',
'Attributes': {
'string': 'string'
},
'DeviceId': 'string',
'Enabled': True|False,
'RemainingLife': 123.0,
'Type': 'string',
'Tags': {
'string': 'string'
}
}
}
Response Structure
200 response
Device details.
The ARN of the device.
An array of zero or more elements of DeviceAttribute objects providing user specified device attributes.
The unique identifier of the device.
A Boolean value indicating whether or not the device is enabled.
A value between 0 and 1 inclusive, representing the fraction of life remaining for the device.
The type of the device, such as "button".
The tags currently associated with the AWS IoT 1-Click device.
Exceptions
IoT1ClickDevicesService.Client.exceptions.ResourceNotFoundException
IoT1ClickDevicesService.Client.exceptions.InvalidRequestException
IoT1ClickDevicesService.Client.exceptions.InternalFailureException
finalize_device_claim
(**kwargs)¶Given a device ID, finalizes the 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.finalize_device_claim(
DeviceId='string',
Tags={
'string': 'string'
}
)
[REQUIRED]
The unique identifier of the device.
A collection of key/value pairs defining the resource tags. For example, { "tags": {"key1": "value1", "key2": "value2"} }. For more information, see AWS Tagging Strategies .
dict
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.PreconditionFailedException
IoT1ClickDevicesService.Client.exceptions.ResourceConflictException
get_device_methods
(**kwargs)¶Given a device ID, returns the invokable methods associated with the device.
See also: AWS API Documentation
Request Syntax
response = client.get_device_methods(
DeviceId='string'
)
[REQUIRED]
The unique identifier of the device.
{
'DeviceMethods': [
{
'DeviceType': 'string',
'MethodName': 'string'
},
]
}
Response Structure
200 response
List of available device APIs.
The type of the device, such as "button".
The name of the method applicable to the deviceType.
Exceptions
IoT1ClickDevicesService.Client.exceptions.ResourceNotFoundException
IoT1ClickDevicesService.Client.exceptions.InvalidRequestException
IoT1ClickDevicesService.Client.exceptions.InternalFailureException
get_paginator
(operation_name)¶Create a paginator for an operation.
create_foo
, and you'd normally invoke the
operation as client.create_foo(**kwargs)
, if the
create_foo
operation can be paginated, you can use the
call client.get_paginator("create_foo")
.client.can_paginate
method to
check if an operation is pageable.get_waiter
(waiter_name)¶Returns an object that can wait for some condition.
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'
)
[REQUIRED]
The unique identifier of the device.
{
'State': 'string'
}
Response Structure
200 response
The device's final claim state.
Exceptions
IoT1ClickDevicesService.Client.exceptions.ResourceNotFoundException
IoT1ClickDevicesService.Client.exceptions.InvalidRequestException
IoT1ClickDevicesService.Client.exceptions.InternalFailureException
IoT1ClickDevicesService.Client.exceptions.ResourceConflictException
invoke_device_method
(**kwargs)¶Given a device ID, issues a request to invoke a named device method (with possible parameters). See the "Example POST" code snippet below.
See also: AWS API Documentation
Request Syntax
response = client.invoke_device_method(
DeviceId='string',
DeviceMethod={
'DeviceType': 'string',
'MethodName': 'string'
},
DeviceMethodParameters='string'
)
[REQUIRED]
The unique identifier of the device.
The device method to invoke.
The type of the device, such as "button".
The name of the method applicable to the deviceType.
dict
Response Syntax
{
'DeviceMethodResponse': 'string'
}
Response Structure
(dict) --
200 response
DeviceMethodResponse (string) --
A JSON encoded string containing the device method response.
Exceptions
IoT1ClickDevicesService.Client.exceptions.InvalidRequestException
IoT1ClickDevicesService.Client.exceptions.PreconditionFailedException
IoT1ClickDevicesService.Client.exceptions.InternalFailureException
IoT1ClickDevicesService.Client.exceptions.ResourceNotFoundException
IoT1ClickDevicesService.Client.exceptions.RangeNotSatisfiableException
IoT1ClickDevicesService.Client.exceptions.ResourceConflictException
list_device_events
(**kwargs)¶Using a device ID, returns a DeviceEventsResponse object containing an array of events for the device.
See also: AWS API Documentation
Request Syntax
response = client.list_device_events(
DeviceId='string',
FromTimeStamp=datetime(2015, 1, 1),
MaxResults=123,
NextToken='string',
ToTimeStamp=datetime(2015, 1, 1)
)
[REQUIRED]
The unique identifier of the device.
[REQUIRED]
The start date for the device event query, in ISO8061 format. For example, 2018-03-28T15:45:12.880Z
[REQUIRED]
The end date for the device event query, in ISO8061 format. For example, 2018-03-28T15:45:12.880Z
dict
Response Syntax
{
'Events': [
{
'Device': {
'Attributes': {},
'DeviceId': 'string',
'Type': 'string'
},
'StdEvent': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
200 response
Events (list) --
An array of zero or more elements describing the event(s) associated with the device.
(dict) --
Device (dict) --
An object representing the device associated with the event.
Attributes (dict) --
The user specified attributes associated with the device for an event.
DeviceId (string) --
The unique identifier of the device.
Type (string) --
The device type, such as "button".
StdEvent (string) --
A serialized JSON object representing the device-type specific event.
NextToken (string) --
The token to retrieve the next set of results.
Exceptions
IoT1ClickDevicesService.Client.exceptions.ResourceNotFoundException
IoT1ClickDevicesService.Client.exceptions.RangeNotSatisfiableException
IoT1ClickDevicesService.Client.exceptions.InvalidRequestException
IoT1ClickDevicesService.Client.exceptions.InternalFailureException
list_devices
(**kwargs)¶Lists the 1-Click compatible devices associated with your AWS account.
See also: AWS API Documentation
Request Syntax
response = client.list_devices(
DeviceType='string',
MaxResults=123,
NextToken='string'
)
dict
Response Syntax
{
'Devices': [
{
'Arn': 'string',
'Attributes': {
'string': 'string'
},
'DeviceId': 'string',
'Enabled': True|False,
'RemainingLife': 123.0,
'Type': 'string',
'Tags': {
'string': 'string'
}
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
200 response
Devices (list) --
A list of devices.
(dict) --
Arn (string) --
The ARN of the device.
Attributes (dict) --
An array of zero or more elements of DeviceAttribute objects providing user specified device attributes.
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.
NextToken (string) --
The token to retrieve the next set of results.
Exceptions
IoT1ClickDevicesService.Client.exceptions.RangeNotSatisfiableException
IoT1ClickDevicesService.Client.exceptions.InvalidRequestException
IoT1ClickDevicesService.Client.exceptions.InternalFailureException
Lists the tags associated with the specified resource ARN.
See also: AWS API Documentation
Request Syntax
response = client.list_tags_for_resource(
ResourceArn='string'
)
[REQUIRED]
The ARN of the resource.
{
'Tags': {
'string': 'string'
}
}
Response Structure
A collection of key/value pairs defining the resource tags. For example, { "tags": {"key1": "value1", "key2": "value2"} }. For more information, see AWS Tagging Strategies .
Exceptions
IoT1ClickDevicesService.Client.exceptions.ResourceNotFoundException
IoT1ClickDevicesService.Client.exceptions.InternalFailureException
tag_resource
(**kwargs)¶Adds or updates the tags associated with the resource ARN. See AWS IoT 1-Click Service Limits for the maximum number of tags allowed per resource.
See also: AWS API Documentation
Request Syntax
response = client.tag_resource(
ResourceArn='string',
Tags={
'string': 'string'
}
)
[REQUIRED]
The ARN of the resource.
[REQUIRED]
A collection of key/value pairs defining the resource tags. For example, { "tags": {"key1": "value1", "key2": "value2"} }. For more information, see AWS Tagging Strategies .
None
Exceptions
IoT1ClickDevicesService.Client.exceptions.ResourceNotFoundException
IoT1ClickDevicesService.Client.exceptions.InvalidRequestException
IoT1ClickDevicesService.Client.exceptions.InternalFailureException
unclaim_device
(**kwargs)¶Disassociates a device from your AWS account using its device ID.
See also: AWS API Documentation
Request Syntax
response = client.unclaim_device(
DeviceId='string'
)
[REQUIRED]
The unique identifier of the device.
{
'State': 'string'
}
Response Structure
200 response
The device's final claim state.
Exceptions
IoT1ClickDevicesService.Client.exceptions.ResourceNotFoundException
IoT1ClickDevicesService.Client.exceptions.InvalidRequestException
IoT1ClickDevicesService.Client.exceptions.InternalFailureException
untag_resource
(**kwargs)¶Using tag keys, deletes the tags (key/value pairs) associated with the specified resource ARN.
See also: AWS API Documentation
Request Syntax
response = client.untag_resource(
ResourceArn='string',
TagKeys=[
'string',
]
)
[REQUIRED]
The ARN of the resource.
[REQUIRED]
A collections of tag keys. For example, {"key1","key2"}
None
Exceptions
IoT1ClickDevicesService.Client.exceptions.ResourceNotFoundException
IoT1ClickDevicesService.Client.exceptions.InvalidRequestException
IoT1ClickDevicesService.Client.exceptions.InternalFailureException
update_device_state
(**kwargs)¶Using a Boolean value (true or false), this operation enables or disables the device given a device ID.
See also: AWS API Documentation
Request Syntax
response = client.update_device_state(
DeviceId='string',
Enabled=True|False
)
[REQUIRED]
The unique identifier of the device.
dict
Response Syntax
{}
Response Structure
(dict) --
200 response
Exceptions
IoT1ClickDevicesService.Client.exceptions.ResourceNotFoundException
IoT1ClickDevicesService.Client.exceptions.InvalidRequestException
IoT1ClickDevicesService.Client.exceptions.InternalFailureException
The available paginators are:
IoT1ClickDevicesService.Paginator.
ListDeviceEvents
¶paginator = client.get_paginator('list_device_events')
paginate
(**kwargs)¶Creates an iterator that will paginate through responses from IoT1ClickDevicesService.Client.list_device_events()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DeviceId='string',
FromTimeStamp=datetime(2015, 1, 1),
ToTimeStamp=datetime(2015, 1, 1),
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The unique identifier of the device.
[REQUIRED]
The start date for the device event query, in ISO8061 format. For example, 2018-03-28T15:45:12.880Z
[REQUIRED]
The end date for the device event query, in ISO8061 format. For example, 2018-03-28T15:45:12.880Z
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'Events': [
{
'Device': {
'Attributes': {},
'DeviceId': 'string',
'Type': 'string'
},
'StdEvent': 'string'
},
],
}
Response Structure
(dict) --
200 response
Events (list) --
An array of zero or more elements describing the event(s) associated with the device.
(dict) --
Device (dict) --
An object representing the device associated with the event.
Attributes (dict) --
The user specified attributes associated with the device for an event.
DeviceId (string) --
The unique identifier of the device.
Type (string) --
The device type, such as "button".
StdEvent (string) --
A serialized JSON object representing the device-type specific event.
IoT1ClickDevicesService.Paginator.
ListDevices
¶paginator = client.get_paginator('list_devices')
paginate
(**kwargs)¶Creates an iterator that will paginate through responses from IoT1ClickDevicesService.Client.list_devices()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
DeviceType='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'Devices': [
{
'Arn': 'string',
'Attributes': {
'string': 'string'
},
'DeviceId': 'string',
'Enabled': True|False,
'RemainingLife': 123.0,
'Type': 'string',
'Tags': {
'string': 'string'
}
},
],
}
Response Structure
(dict) --
200 response
Devices (list) --
A list of devices.
(dict) --
Arn (string) --
The ARN of the device.
Attributes (dict) --
An array of zero or more elements of DeviceAttribute objects providing user specified device attributes.
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.