AWS::IoT1Click::Device
Important
AWS IoT 1-Click was discontinued on Dec 16, 2024. For more information, see AWS IoT 1-Click.
The AWS::IoT1Click::Device
resource controls the enabled state of an AWS IoT 1-Click compatible device. For more information,
see Device in the
AWS IoT 1-Click Devices API Reference.
Syntax
To declare this entity in your AWS CloudFormation template, use the following syntax:
JSON
{ "Type" : "AWS::IoT1Click::Device", "Properties" : { "DeviceId" :
String
, "Enabled" :Boolean
} }
Properties
DeviceId
-
The ID of the device, such as
G030PX0312744DWM
.Required: Yes
Type: String
Update requires: Replacement
Enabled
-
A Boolean value indicating whether the device is enabled (
true
) or not (false
).Required: Yes
Type: Boolean
Update requires: No interruption
Return values
Ref
When you pass the logical ID of this resource to the intrinsic Ref
function, Ref
returns the device ARN, such as arn:aws:iot1click:us-west-2:123456789012:devices/G030PX0312744DWM
.
For more information about using the Ref
function, see Ref
.
Fn::GetAtt
The Fn::GetAtt
intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.
For more information about using the Fn::GetAtt
intrinsic function, see Fn::GetAtt
.
Arn
-
The ARN of the device, such as
arn:aws:iot1click:us-west-2:123456789012:devices/G030PX0312744DWM
. DeviceId
-
The unique identifier of the device.
Enabled
-
A Boolean value indicating whether the device is enabled (
true
) or not (false
).
Examples
Enable a device
JSON
{ "SampleDevice": { "Type": "AWS::IoT1Click::Device", "Properties": { "DeviceId": "G030PX0312744DWM", "Enabled": true } } }
YAML
SampleDevice: Type: "AWS::IoT1Click::Device" Properties: DeviceId: G030PX0312744DWM Enabled: True