사물 쿼리 예 - AWS IoT Core

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

사물 쿼리 예

쿼리 구문을 사용하여 쿼리 문자열에서 쿼리를 지정합니다. 쿼리가 SearchIndex API에 전달됩니다. 다음은 쿼리 문자열의 몇 가지 예를 나열한 표입니다.

쿼리 문자열 Result
abc

레지스트리, 섀도우(명명되지 않은 클래식 섀도우와 명명된 섀도우) 또는 Device Defender 위반 필드에서 "abc"를 쿼리합니다.

thingName:myThingName

이름이 myThingName "“인 사물에 대한 쿼리

thingName:my*

이름이 "my"로 시작하는 사물에 대한 쿼리를 실행합니다.

thingName:ab?

'ab'에 문자 1개가 추가된 이름(예: 'aba', 'abb', 'abc' 등)의 사물에 대한 쿼리를 실행합니다.

thingTypeName:aa

유형 "aa"와 연결된 사물에 대한 쿼리를 실행합니다.

thingGroupNames:a 상위 사물 그룹 또는 청구 그룹 이름이 “a”인 사물에 대한 쿼리
thingGroupNames:a* 상위 사물 그룹 또는 청구 그룹 이름이 패턴 “a*”와 일치하는 사물에 대한 쿼리
attributes.myAttribute:75

"myAttribute" 속성 값이 75인 사물에 대한 쿼리를 실행합니다.

attributes.myAttribute:[75 TO 80]

"myAttribute" 속성 값이 숫자 범위(75~80, 두 값 모두 포함)에 해당하는 사물에 대한 쿼리를 실행합니다.

attributes.myAttribute:{75 TO 80]

"myAttribute" 속성 값이 숫자 범위(>75 및 <=80)에 해당하는 사물에 대한 쿼리를 실행합니다.

attributes.serialNumber:["abcd" TO "abcf"]

"serialNumber" 속성 값이 영숫자 문자열 범위에 속하는 사물에 대한 쿼리를 실행합니다. 이 쿼리는 "serialNumber" 속성 값이 "abcd", "abce" 또는 "abcf"인 사물을 반환합니다.

attributes.myAttribute:i*t

"myAttribute" 속성 값이 'i'부터 시작하여 개수에 제한 없이 문자가 중간에 오고 마지막에 't'로 끝나는 사물에 대한 쿼리를 실행합니다.

attributes.attr1:abc AND attributes.attr2<5 NOT attributes.attr3>10

부울 표현식을 사용하여 용어가 결합되어 있는 사물에 대한 쿼리를 실행합니다. 이 쿼리는 속성 값이 'abc'이고 속성 이름이 'attr1'인 사물, 5보다 작으며 속성 이름이 'attr2'인 사물, 10 이하이며 속성 이름이 'attr3'인 사물을 반환합니다.

shadow.hasDelta:true

델타 요소가 있는 명명되지 않은 섀도우가 있는 항목을 쿼리합니다.

NOT attributes.model:legacy

속성 "모델"이 "legacy"가 아닌 사물에 대한 쿼리를 실행합니다.

shadow.reported.stats.battery:{70 TO 100} (v2 OR v3) NOT attributes.model:legacy

다음과 같은 사물에 대한 쿼리를 실행합니다.

  • 사물의 섀도우 stats.battery 속성 값이 70~100인 경우

  • 텍스트 "v2" 또는 "v3"이 사물 이름, 유형 이름 또는 속성 값에 포함되는 경우

  • 사물의 model 속성이 "legacy"로 설정되지 않은 경우

shadow.reported.myvalues:2

섀도우의 보고 섹션에 있는 myvalues 어레이에 2의 값이 포함된 사물에 대한 쿼리를 실행합니다.

shadow.reported.location:* NOT shadow.desired.stats.battery:*

다음과 같은 사물에 대한 쿼리를 실행합니다.

  • location 속성이 섀도우의 reported 섹션에 있는 경우

  • stats.battery 속성이 섀도우의 desired 섹션에 없는 경우

shadow.name.<shadowName>.hasDelta:true

주어진 이름의 섀도우와 델타 요소가 있는 사물에 대한 쿼리입니다.

shadow.name.<shadowName>.desired.filament:*

주어진 이름의 섀도우와 원하는 필라멘트 속성이 있는 사물에 대한 쿼리입니다.

shadow.name.<shadowName>.reported.location:*

지정된 이름의 섀도우가 있고 명명된 섀도우의 보고된 섹션에 location 속성이 존재하는 사물에 대한 쿼리입니다.

connectivity.connected:true

연결된 모든 디바이스를 쿼리합니다.

connectivity.connected:false 연결이 끊긴 모든 디바이스를 쿼리합니다.
connectivity.connected:true AND connectivity.timestamp : [1557651600000 TO 1557867600000] 연결 타임스탬프가 >= 1557651600000이고, <= 1557867600000인 연결된 디바이스를 모두 쿼리합니다. 타임스탬프는 Epoch 이후 밀리초 단위로 제공됩니다.
connectivity.connected:false AND connectivity.timestamp : [1557651600000 TO 1557867600000] 연결 해제 타임스탬프가 >= 1557651600000이고, <= 1557867600000인 연결이 끊긴 디바이스를 모두 쿼리합니다. 타임스탬프는 Epoch 이후 밀리초 단위로 제공됩니다.
connectivity.connected:true AND connectivity.timestamp > 1557651600000 연결 타임스탬프가 > 1508972224인 연결된 디바이스를 모두 쿼리합니다. 타임스탬프는 Epoch 이후 밀리초 단위로 제공됩니다.
connectivity.connected:* 연결 정보가 있는 모든 디바이스를 쿼리합니다.
connectivity.disconnectReason:* 연결 disconnectReason이 있는 모든 디바이스 쿼리에 대한 쿼리를 실행합니다.
connectivity.disconnectReason:CLIENT_INITIATED_DISCONNECT CLIENT_INITIATED_DISCONNECT로 인해 연결이 해제된 모든 디바이스에 대한 쿼리입니다.
deviceDefender.violationCount:[0 TO 100] Device Defender 위반 개수 값이 숫자 범위(0~100, 두 값 모두 포함)에 속하는 사물에 대한 쿼리입니다.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.inViolation:true 보안 프로파일 device-SecurityProfile에 정의된 동작 disconnectBehavior를 위반하는 사물에 대한 쿼리입니다. inViolation:false는 유효한 쿼리가 아닙니다.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationValue.number>2 보안 프로필 장치에 정의된 동작을 disconnectBehavior 위반하고 마지막 위반 이벤트 값이 2보다 큰 항목에 대한 쿼리 SecurityProfile
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationTime>1634227200000

보안 프로필 장치에 정의된 동작 disconnectBehavior (지정된 에포크 타임 이후 마지막 위반 이벤트가 발생한 동작) 을 위반하는 항목에 대한 쿼리 SecurityProfile

shadow.name.gps-tracker.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km 좌표 47.6204, -122.3491으로부터 반경 방향 거리 15.5km 내에 있는 사물에 대한 쿼리 이 쿼리 문자열은 위치 데이터가 네임드 섀도우에 저장되는 경우에 적용됩니다.
shadow.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km 좌표 47.6204, -122.3491으로부터 반경 방향 거리 15.5km 내에 있는 사물을 쿼리합니다. 이 쿼리 문자열은 위치 데이터가 클래식한 그림자에 저장되는 경우에 적용됩니다.