AWS IoT
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

管理事物组索引

AWS_ThingGroups 是包含所有事物组的索引。您可以使用此索引基于组名称、描述、属性和所有父组名称搜索事物组。

启用事物组索引

您可以创建 AWS_ThingGroups 索引并使用 UpdateIndexingConfiguration API 中的 thing-group-indexing-configuration 设置来控制其配置。您可以使用 GetIndexingConfiguration API 检索当前索引配置。

使用 get-indexing-configuration CLI 命令检索当前的事物和事物组索引配置。

aws iot get-indexing-configuration { "thingGroupIndexingConfiguration": { "thingGroupIndexingMode": "ON" } }

使用 update-indexing-configuration CLI 命令更新事物组索引配置。

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

注意

您还可以在单个命令中更新事物和事物组索引的配置,如下所示。

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

thingGroupIndexingMode 的有效值如下所示。

OFF

无索引/删除索引。

创建或配置 AWS_ThingGroups 索引。

描述组索引

使用 describe-index CLI 命令检索 AWS_ThingGroups 索引的当前状态。

aws iot describe-index --index-name "AWS_ThingGroups" { "indexStatus": "ACTIVE", "indexName": "AWS_ThingGroups", "schema": "THING_GROUPS" }

首次启用索引时,AWS IoT 将构建您的索引。如果 indexStatusBUILDING,则您无法查询索引。

查询事物组索引

使用 search-index CLI 命令可查询索引中的数据:

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

授权

您可以指定事物组索引作为 AWS IoT 策略操作中的资源 ARN,如下所示:

操作 资源

iot:SearchIndex

索引 ARN(例如,arn:aws:iot:<your-aws-region>:index/AWS_ThingGroups)。

iot:DescribeIndex

索引 ARN(例如,arn:aws:iot:<your-aws-region>:index/AWS_ThingGroups)。