사물 그룹 인덱싱 관리

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의 유효한 값은 다음과 같습니다.

OFF

인덱싱이 없거나 인덱스를 삭제합니다.

ON

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

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

aws iot get-indexing-configuration

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

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

그룹 인덱스 설명

하여 현재 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 상태일 경우에는 인덱스에 대한 쿼리를 실행할 수 없습니다.

사물 그룹 인덱스에 대한 쿼리

인덱스의 데이터를 쿼리하려면 search-index CLI 명령을 사용합니다.

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

권한 부여

다음과 같이 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)