AWS::IoT::Thing - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::IoT::Thing

使用 AWS::IoT::Thing 资源声明 AWS IoT 事务。

有关使用事务的信息,请参阅 AWS IoT 开发人员指南 中的 AWS IoT 工作原理AWS IoT 设备注册表

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::IoT::Thing", "Properties" : { "AttributePayload" : AttributePayload, "ThingName" : String } }

YAML

Type: AWS::IoT::Thing Properties: AttributePayload: AttributePayload ThingName: String

属性

AttributePayload

一个包含最多三个键值对的字符串。长度上限为 800。不允许使用重复项。

必需:否

类型AttributePayload

Update requires: No interruption

ThingName

要更新的事物的名称。

您无法更改事物的名称。要更改事物的名称,您必须创建一个新事物,为其指定新名称,然后删除旧事物。

必需:否

类型:字符串

Update requires: Replacement

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回事物名称。例如:

{ "Ref": "MyThing" }

对于名为 MyStack 的堆栈,将返回与以下值类似的值:

MyStack-MyThing-AB1CDEFGHIJK

For more information about using the Ref function, see Ref.

示例

以下示例将声明事务及其属性的值。

JSON

{ "AWSTemplateFormatVersion": "2010-09-09", "Resources": { "MyThing": { "Type": "AWS::IoT::Thing", "Properties": { "ThingName": { "Ref": "NameParameter" }, "AttributePayload": { "Attributes": { "myAttributeA": { "Ref": "MyAttributeValueA" }, "myAttributeB": { "Ref": "MyAttributeValueB" }, "myAttributeC": { "Ref": "MyAttributeValueC" } } } } } }, "Parameters": { "NameParameter": { "Type": "String" }, "MyAttributeValueA": { "Type": "String", "Default": "myStringA123" }, "MyAttributeValueB": { "Type": "String", "Default": "myStringB123" }, "MyAttributeValueC": { "Type": "String", "Default": "myStringC123" } } }

YAML

AWSTemplateFormatVersion: "2010-09-09" Resources: MyThing: Type: AWS::IoT::Thing Properties: ThingName: Ref: "NameParameter" AttributePayload: Attributes: myAttributeA: Ref: "MyAttributeValueA" myAttributeB: Ref: "MyAttributeValueB" myAttributeC: Ref: "MyAttributeValueC" Parameters: NameParameter: Type: "String" MyAttributeValueA: Type: "String" Default: "myStringA123" MyAttributeValueB: Type: "String" Default: "myStringB123" MyAttributeValueC: Type: "String" Default: "myStringC123"