Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Manage thing group indexing

Focus mode
Manage thing group indexing - AWS IoT Core

AWS_ThingGroups is the index that contains all of your thing groups. You can use this index to search for groups based on group name, description, attributes, and all parent group names.

Enabling thing group indexing

You can use the thing-group-indexing-configuration setting in the UpdateIndexingConfiguration API to create the AWS_ThingGroups index and control its configuration. You can use the GetIndexingConfiguration API to retrieve the current indexing configuration.

To update the thing group indexing configurations, run the update-indexing-configuration CLI command:

aws iot update-indexing-configuration --thing-group-indexing-configuration thingGroupIndexingMode=ON

You can also update configurations for both thing and thing group indexing in a single command, as follows:

aws iot update-indexing-configuration --thing-indexing-configuration thingIndexingMode=REGISTRY --thing-group-indexing-configuration thingGroupIndexingMode=ON

The following are valid values for thingGroupIndexingMode.

OFF

No indexing/delete index.

ON

Create or configure the AWS_ThingGroups index.

To retrieve the current thing and thing group indexing configurations, run the get-indexing-configuration CLI command:

aws iot get-indexing-configuration

The response of the command looks like the following:

{ "thingGroupIndexingConfiguration": { "thingGroupIndexingMode": "ON" } }

Describing group indexes

To retrieve the current status of the AWS_ThingGroups index, use the describe-index CLI command:

aws iot describe-index --index-name "AWS_ThingGroups"

The response of the command looks like the following:

{ "indexStatus": "ACTIVE", "indexName": "AWS_ThingGroups", "schema": "THING_GROUPS" }

AWS IoT builds your index the first time that you indexing. You can't query the index if the indexStatus is BUILDING.

Querying a thing group index

To query data in the index, use the search-index CLI command:

aws iot search-index --index-name "AWS_ThingGroups" --query-string "thingGroupName:mythinggroup*"

Authorization

You can specify the thing groups index as a resource ARN in an AWS IoT policy action, as follows.

Action Resource

iot:SearchIndex

An index ARN (for example, arn:aws:iot:your-aws-region:index/AWS_ThingGroups).

iot:DescribeIndex

An index ARN (for example, arn:aws:iot:your-aws-region:index/AWS_ThingGroups).

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.