기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 사물 그룹 인덱싱 관리
<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  
인덱싱이 없거나 인덱스를 삭제합니다.

ON  
`AWS_ThingGroups` 인덱스를 생성하거나 구성합니다.

현재 사물 및 사물 그룹 인덱싱 구성을 검색하려면 **get-indexing-configuration** CLI 명령을 사용합니다.

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

명령의 응답은 다음과 같습니다.

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

## 그룹 인덱스 설명
<a name="describe-group-index"></a>

하여 현재 **describe-index** 인덱스 상태를 검색하려면 `AWS_ThingGroups` 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*"
```

## 권한 부여
<a name="query-thinggroup-auth"></a>

다음과 같이 AWS IoT 정책 작업에서 사물 그룹 인덱스를 리소스 ARN으로 지정할 수 있습니다.


****  

| 작업 | Resource | 
| --- | --- | 
|  `iot:SearchIndex`  |  인덱스 ARN(예: `arn:aws:iot:your-aws-region:index/AWS_ThingGroups`)  | 
|  `iot:DescribeIndex`  |  인덱스 ARN(예: `arn:aws:iot:your-aws-region:index/AWS_ThingGroups`)  |