翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# モノのクエリの例
<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  |  レジストリ、シャドウ (従来の名前のないシャドウと名前付きシャドウ)、またはデバイスディフェンダー違反フィールドで「abc」をクエリします。  | 
|  thingName:myThingName  |  「myThingName」という名前のモノをクエリします｡  | 
|  thingName:my\$1  |  「my」で始まる名前のモノをクエリします｡  | 
|  thingName:\$1my  |  「my」で終わる名前のモノをクエリします｡ 先頭ワイルドカードの使用は、1 つのクエリにつき 1 つのクエリ用語に制限されます。先頭ワイルドカードを含むクエリの最大クエリ長は 100 文字です。  | 
|  thingName:\$1my\$1  |  部分文字列「my」を含むモノをクエリします。先頭ワイルドカードの使用は、1 つのクエリにつき 1 つのクエリ用語に制限されます。先頭ワイルドカードを含むクエリの最大クエリ長は 100 文字です。  | 
|  thingName:ab?  |  「aba」、「abb」、「abc」など、名前に「ab」と追加で 1 つの文字を加えたモノをクエリします。  | 
|  thingTypeName:aa  |  「aa」タイプに関連付けられているモノをクエリします。  | 
|  thingGroupNames:a  | 親モノグループまたは請求グループ名「a」を持つモノのクエリ。 | 
|  thingGroupNames:a\$1  | パターン「a\$1」に一致する親モノグループまたは請求グループ名を持つモノのクエリ。 | 
|  attributes.myAttribute:75  |  値が 75 の「myAttribute」という属性を持つモノをクエリします。  | 
|  attributes.myAttribute:[75 TO 80]  |  値が数値範囲 (75—80) 内にある「myAttribute」という属性を持つモノをクエリします。  | 
|  attributes.myAttribute:\$175 TO 80]  |  値が数値範囲 (>75 および <=80) 内にある「myAttribute」という属性を持つモノをクエリします。  | 
|  attributes.serialNumber:["abcd" TO "abcf"]  |  値が英数字の文字列範囲内にある「serialNumber」という属性を持つモノをクエリします。このクエリは、値が「abcd」、「abce」、または「abcf」の「serialNumber」属性を持つモノを返します。  | 
|  attributes.myAttribute:i\$1t |  値が「i」で、その後に任意の文字数、そして「t」が続く「myAttribute」という属性を持つモノをクエリします。  | 
|  attributes.attr1:abc AND attributes.attr2<5 NOT attributes.attr3>10  |  ブール式を使用して､用語の組み合わせとなるモノをクエリします。このクエリは、値が「abc」の属性「attr1」、値が 5 未満の属性「attr2」､および値が 10 以下の属性「attr3」のモノを返します。  | 
|  shadow.hasDelta:true  |  デルタ要素を持つ名前のないシャドウを持つモノをクエリします。  | 
|  NOT attributes.model:legacy  |  「model」という属性が「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/ja_jp/iot/latest/developerguide/example-queries.html)  | 
|  shadow.reported.myvalues:2  |  Shadow の reported セクションの `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/ja_jp/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) 内の接続タイムスタンプを持つ、接続されているすべてのデバイスに対するクエリです。タイムスタンプはエポックからのミリ秒単位で指定されます。 | 
|  connectivity.connected:false AND connectivity.timestamp : [1557651600000 TO 1557867600000]  | 特定の範囲 (1557651600000 ～ 1557867600000) 内の切断タイムスタンプを持つ、切断されているすべてのデバイスに対するクエリです。タイムスタンプはエポックからのミリ秒単位で指定されます。 | 
|  connectivity.connected:true AND connectivity.timestamp > 1557651600000  | 特定の範囲 (1557651600000 より大) 内の接続タイムスタンプを持つ、接続されているすべてのデバイスに対するクエリです。タイムスタンプはエポックからのミリ秒単位で指定されます。 | 
|  connectivity.connected:\$1  | 接続情報があるすべてのデバイスに対するクエリです。 | 
|  connectivity.disconnectReason:\$1  | connectivity.disconnectReason のあるすべてのデバイスに対するクエリです。 | 
|  connectivity.disconnectReason:CLIENT\$1INITIATED\$1DISCONNECT  | CLIENT\$1INITIATED\$1DISCONNECTが原因で切断されたすべてのデバイスのクエリです。 | 
|  deviceDefender.violationCount:[0 TO 100]  | 数値範囲 (0—100) 内の Device Defender 違反のカウント値を持つモノをクエリします。 | 
|  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  |  指定したエポックタイムの後に最新の違反イベントがあり、セキュリティプロファイル device-SecurityProfile で定義されているように動作 `disconnectBehavior` に違反しているモノをクエリします。  | 
|  shadow.name.gps-tracker.reported.coordinates:geo\$1distance,47.6204,-122.3491,15.5km | 47.6204,-122.3491 の座標から 15.5 km の半径距離内にあるモノをクエリします。このクエリ文字列は、位置データが名前付きシャドウに保存されている場合に適用されます。 | 
|  shadow.reported.coordinates:geo\$1distance,47.6204,-122.3491,15.5km | 47.6204,-122.3491 の座標から 15.5 km の半径距離内にあるモノをクエリします。このクエリ文字列は、位置データがクラシックシャドウに保存されている場合に適用されます。 |