翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# モノのグループのインデックス作成の管理
<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
```

次のように、1 つのコマンドでモノとモノのグループのインデックス作成の両方の設定を更新することもできます。

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

次に示すのは、`thingGroupIndexingMode` の有効な値です。

VOFF  
インデックスの作成/インデックスの削除がありません。

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`)。  |