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

사물 그룹 인덱싱 관리

AWS_ThingGroups는 모든 사물 그룹을 포함하는 인덱스입니다. 이 인덱스를 사용하여 그룹 이름, 설명, 속성 및 모든 상위 그룹 이름을 기반으로 그룹을 검색할 수 있습니다.

사물 그룹 인덱싱 활성화

의 thing-group-indexing-configuration 설정을 사용하여 AWS_ThingGroups 인덱스UpdateIndexingConfigurationAPI를 생성하고 구성을 제어할 수 있습니다. 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-index CLI 명령을 사용합니다.

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에서 사물 그룹 인덱스를 리소스로 지정할 수 있습니다.