管理事物组索引 - Amazon IoT Core
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

管理事物组索引

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

启用事物组索引

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

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

关闭

无索引/删除索引。

创建或配置 AWS_ThingGroups 索引。

要检索当前的事物和事物组索引配置,运行 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" }

Amazon IoT 在你第一次编制索引时会生成你的索引。如果 indexStatusBUILDING,则您无法查询索引。

查询事物组索引

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

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

授权

您可以在 Amazon 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)。