기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
사물 쿼리 예
쿼리 구문을 사용하여 쿼리 문자열에서 쿼리를 지정합니다. 쿼리가 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
|
다음과 같은 사물에 대한 쿼리를 실행합니다.
|
shadow.reported.myvalues:2
|
섀도우의 보고 섹션에 있는 |
shadow.reported.location:* NOT shadow.desired.stats.battery:*
|
다음과 같은 사물에 대한 쿼리를 실행합니다.
|
shadow.name.<shadowName>.hasDelta:true
|
주어진 이름의 섀도우와 델타 요소가 있는 사물에 대한 쿼리입니다. |
shadow.name.<shadowName>.desired.filament:*
|
주어진 이름의 섀도우와 원하는 필라멘트 속성이 있는 사물에 대한 쿼리입니다. |
shadow.name.<shadowName>.reported.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
|
보안 프로필 장치에 정의된 동작 |
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 내에 있는 사물을 쿼리합니다. 이 쿼리 문자열은 위치 데이터가 클래식한 그림자에 저장되는 경우에 적용됩니다. |