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

# 사물 쿼리 예
<a name="example-queries"></a>

쿼리 구문을 사용하여 쿼리 문자열에서 쿼리를 지정합니다. 쿼리가 [https://docs.aws.amazon.com/iot/latest/apireference/API_SearchIndex.html](https://docs.aws.amazon.com/iot/latest/apireference/API_SearchIndex.html) API에 전달됩니다. 다음은 쿼리 문자열의 몇 가지 예를 나열한 표입니다.


| 쿼리 문자열 | 결과 | 
| --- | --- | 
|  abc  |  레지스트리, 섀도우(명명되지 않은 클래식 섀도우와 명명된 섀도우) 또는 Device Defender 위반 필드에서 "abc"를 쿼리합니다.  | 
|  thingName:myThingName  |  이름이 "myThingName"인 사물에 대한 쿼리를 실행합니다.  | 
|  thingName:my\$1  |  이름이 "my"로 시작하는 사물에 대한 쿼리를 실행합니다.  | 
|  thingName:\$1my  |  이름이 "my"로 끝나는 사물에 대한 쿼리를 실행합니다. 선행 와일드카드 사용은 쿼리당 쿼리 용어 1개로 제한됩니다. 선행 와일드카드가 포함된 쿼리의 최대 쿼리 길이는 100자입니다.  | 
|  thingName:\$1my\$1  |  하위 문자열 "my"가 포함된 사물에 대한 쿼리입니다. 선행 와일드카드 사용은 쿼리당 쿼리 용어 1개로 제한됩니다. 선행 와일드카드가 포함된 쿼리의 최대 쿼리 길이는 100자입니다.  | 
|  thingName:ab?  |  'ab'에 문자 1개가 추가된 이름(예: 'aba', 'abb', 'abc' 등)의 사물에 대한 쿼리를 실행합니다.  | 
|  thingTypeName:aa  |  유형 "aa"와 연결된 사물에 대한 쿼리를 실행합니다.  | 
|  thingGroupNames:a  | 상위 사물 그룹 또는 청구 그룹 이름이 ‘a’인 사물에 대한 쿼리입니다. | 
|  thingGroupNames:a\$1  | 상위 사물 그룹 또는 청구 그룹 이름이 패턴 ‘a’와 일치하는 사물에 대한 쿼리입니다. | 
|  attributes.myAttribute:75  |  "myAttribute" 속성 값이 75인 사물에 대한 쿼리를 실행합니다.  | 
|  attributes.myAttribute:[75 TO 80]  |  "myAttribute" 속성 값이 숫자 범위(75\$180, 두 값 모두 포함)에 해당하는 사물에 대한 쿼리를 실행합니다.  | 
|  attributes.myAttribute:\$175 TO 80]  |  "myAttribute" 속성 값이 숫자 범위(>75 및 <=80)에 해당하는 사물에 대한 쿼리를 실행합니다.  | 
|  attributes.serialNumber:["abcd" TO "abcf"]  |  "serialNumber" 속성 값이 영숫자 문자열 범위에 속하는 사물에 대한 쿼리를 실행합니다. 이 쿼리는 "serialNumber" 속성 값이 "abcd", "abce" 또는 "abcf"인 사물을 반환합니다.  | 
|  attributes.myAttribute:i\$1t |  "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:\$170 TO 100\$1 (v2 OR v3) NOT attributes.model:legacy  |  다음과 같은 사물에 대한 쿼리를 실행합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot/latest/developerguide/example-queries.html)  | 
|  shadow.reported.myvalues:2  |  섀도우의 보고 섹션에 있는 `myvalues` 어레이에 2의 값이 포함된 사물에 대한 쿼리를 실행합니다.  | 
|  shadow.reported.location:\$1 NOT shadow.desired.stats.battery:\$1  |  다음과 같은 사물에 대한 쿼리를 실행합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot/latest/developerguide/example-queries.html)  | 
|  shadow.name.<shadowName>.hasDelta:true  |  주어진 이름의 섀도우와 델타 요소가 있는 사물에 대한 쿼리입니다.  | 
|  shadow.name.<shadowName>.desired.filament:\$1  |  주어진 이름의 섀도우와 원하는 필라멘트 속성이 있는 사물에 대한 쿼리입니다.  | 
|  shadow.name.<shadowName>.reported.location:\$1  |  지정된 이름의 섀도우가 있고 명명된 섀도우의 보고된 섹션에 `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:\$1  | 연결 정보가 있는 모든 디바이스를 쿼리합니다. | 
|  connectivity.disconnectReason:\$1  | 연결 disconnectReason이 있는 모든 디바이스 쿼리에 대한 쿼리를 실행합니다. | 
|  connectivity.disconnectReason:CLIENT\$1INITIATED\$1DISCONNECT  | CLIENT\$1INITIATED\$1DISCONNECT로 인해 연결이 해제된 모든 디바이스에 대한 쿼리입니다. | 
|  deviceDefender.violationCount:[0 TO 100]  | Device Defender 위반 개수 값이 숫자 범위(0\$1100, 두 값 모두 포함)에 속하는 사물에 대한 쿼리입니다. | 
|  deviceDefender.<device-SecurityProfile>.disconnectBehavior.inViolation:true  | 보안 프로파일 device-SecurityProfile에 정의된 동작 disconnectBehavior를 위반하는 사물에 대한 쿼리입니다. inViolation:false는 유효한 쿼리가 아닙니다. | 
|  deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationValue.number>2  | 마지막 위반 이벤트 값이 2보다 큰 보안 프로파일 device-SecurityProfile에 정의된 동작 disconnectBehavior를 위반하는 사물에 대한 쿼리입니다. | 
|  deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationTime>1634227200000  |  마지막 위반 이벤트가 지정된 epoch 시간 이후인 보안 프로필 device-SecurityProfile에 정의된 동작 `disconnectBehavior`를 위반하는 사물에 대한 쿼리입니다.  | 
|  shadow.name.gps-tracker.reported.coordinates:geo\$1distance,47.6204,-122.3491,15.5km | 좌표 47.6204,-122.3491에서 방사상 거리 15.5km 내에 있는 사물에 대한 쿼리입니다. 이 쿼리 문자열은 위치 데이터가 명명된 섀도에 저장될 때 적용됩니다. | 
|  shadow.reported.coordinates:geo\$1distance,47.6204,-122.3491,15.5km | 좌표 47.6204,-122.3491에서 방사상 거리 15.5km 내에 있는 사물에 대한 쿼리입니다. 이 쿼리 문자열은 위치 데이터가 클래식 섀도에 저장될 때 적용됩니다. |