AWS::IoT::ThingGroup - Amazon CloudFormation
SyntaxPropertiesReturn values
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::IoT::ThingGroup

Creates a new thing group. A dynamic thing group is created if the resource template contains the QueryString attribute. A dynamic thing group will not contain the ParentGroupName attribute. A static thing group and dynamic thing group can't be converted to each other via the addition or removal of the QueryString attribute.

Note

This is a control plane operation. See Authorization for information about authorizing control plane actions.

Requires permission to access the CreateThingGroup action.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::IoT::ThingGroup",
  "Properties" : {
      "ParentGroupName" : String,
      "QueryString" : String,
      "Tags" : [ Tag, ... ],
      "ThingGroupName" : String,
      "ThingGroupProperties" : ThingGroupProperties
    }
}

YAML

Type: AWS::IoT::ThingGroup
Properties: 
  ParentGroupName: String
  QueryString: 
    String
  Tags: 
    - Tag
  ThingGroupName: String
  ThingGroupProperties: 
    ThingGroupProperties

Properties

ParentGroupName

The parent thing group name.

A Dynamic Thing Group does not have parentGroupName defined.

Required: No

Type: String

Update requires: Replacement

QueryString

The dynamic thing group search query string.

The queryString attribute is required for CreateDynamicThingGroup. The queryString attribute is not required for CreateThingGroup.

Required: No

Type: String

Update requires: No interruption

Tags

Metadata which can be used to manage the thing group or dynamic thing group.

Required: No

Type: List of Tag

Update requires: No interruption

ThingGroupName

The thing group name.

Required: No

Type: String

Update requires: Replacement

ThingGroupProperties

Thing group properties.

Required: No

Type: ThingGroupProperties

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Reffunction, Refreturns the thing group id.

For more information about using the Reffunction, see Ref.

Fn::GetAtt

The Fn::GetAttintrinsic 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::GetAttintrinsic function, see Fn::GetAtt.

Arn

The thing group ARN.

Id

The thing group ID.