管理事物组索引

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

启用事物组索引

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

要更新对象组索引配置，请运行 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 的有效值如下所示。

要检索当前的事物和事物组索引配置，运行 get-indexing-configuration CLI 命令。

aws iot get-indexing-configuration

命令的响应如下所示：

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

描述组索引

要检索 AWS_ThingGroups 索引的当前状态，使用describe-indexCLI 命令。

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

命令的响应如下所示：

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

首次编制索引时，AWS IoT 将构建您的索引。如果 indexStatus 为 BUILDING，则您无法查询索引。

查询事物组索引

要查询索引中的数据，使用 search-index CLI 命令：

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

授权

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