AWS Fundamentals Logo
AWS Fundamentals
L1 ConstructAWS::IoT::ThingGroup

CfnThingGroup

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. > This is a control plane operation. See [Authorization](https://docs.aws.amazon.com/iot/latest/developerguide/iot-authorization.html) for information about authorizing control plane actions. Requires permission to access the [CreateThingGroup](https://docs.aws.amazon.com//service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

Import

import { CfnThingGroup } from 'aws-cdk-lib/aws-iot';

Or use the module namespace:

import * as iot from 'aws-cdk-lib/aws-iot';
// iot.CfnThingGroup

Properties

Configuration passed to the constructor as CfnThingGroupProps.

parentGroupNameOptional
string

The parent thing group name. A Dynamic Thing Group does not have `parentGroupName` defined.

queryStringOptional
string

The dynamic thing group search query string. The `queryString` attribute *is* required for `CreateDynamicThingGroup` . The `queryString` attribute *is not* required for `CreateThingGroup` .

tagsOptional
CfnTag[]

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

thingGroupNameOptional
string

The thing group name.

thingGroupPropertiesOptional
IResolvable | ThingGroupPropertiesProperty

Thing group properties.

CloudFormation Resource

This L1 construct maps directly to the following CloudFormation resource type.

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter