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