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

# 管理事物组索引
<a name="thinggroup-index"></a>

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

## 启用事物组索引
<a name="enable-group-index"></a>

您可以使用 [UpdateIndexingConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateIndexingConfiguration.html)API 中的`thing-group-indexing-configuration`设置来创建`AWS_ThingGroups`索引并控制其配置。您可以使用 [GetIndexingConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_GetIndexingConfiguration.html)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` 的有效值如下所示。

OFF  
没有 indexing/delete 索引。

ON  
创建或配置 `AWS_ThingGroups` 索引。

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

```
aws iot get-indexing-configuration
```

命令的响应如下所示：

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

## 描述组索引
<a name="describe-group-index"></a>

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

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

命令的响应如下所示：

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

 AWS IoT 在你第一次编制索引时会生成你的索引。如果 `indexStatus` 为 `BUILDING`，则您无法查询索引。

## 查询事物组索引
<a name="search-group-index"></a>

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

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

## Authorization
<a name="query-thinggroup-auth"></a>

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


****  

| Action | 资源 | 
| --- | --- | 
|  `iot:SearchIndex`  |  索引 ARN（例如，`arn:aws:iot:your-aws-region:index/AWS_ThingGroups`）。  | 
|  `iot:DescribeIndex`  |  索引 ARN（例如，`arn:aws:iot:your-aws-region:index/AWS_ThingGroups`）。  |