Beispiel für Objektabfragen - AWS IoT Core

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Beispiel für Objektabfragen

Geben Sie Abfragen mithilfe einer Abfragesyntax in einer Abfragezeichenfolge an. Die Abfragen werden an die SearchIndexAPI übergeben. Die folgende Tabelle enthält einige Beispiele für Abfragezeichenfolgen.

Abfragezeichenfolge Ergebnis
abc

Abfragen nach „abc“ in beliebigen Registry-, Schatten- (klassischer unbenannter Shadow und benannter Shadow) oder Device Defender-Verstößen.
thingName:myThingName

Fragt nach einem Ding mit dem Namen "myThingName" ab.
thingName:my*

Abfragen von Objekten mit Namen, die mit „my” beginnen.
thingName:ab?

Abfragen von Objekten mit Namen, die "ab" sowie ein zusätzliches Zeichen enthalten, zum Beispiel: "aba", "abb", "abc" usw.
thingTypeName:aa

Abfragen für Objekte, die dem Typ aa zugeordnet sind.
thingGroupNames:a Abfragen für Dinge mit dem Namen „a“ als übergeordneter Sachgruppe oder Abrechnungsgruppe.
thingGroupNames:a* Abfragen für Dinge, bei denen der Name einer übergeordneten Sachgruppe oder einer Abrechnungsgruppe dem Muster „a*“ entspricht.
attributes.myAttribute:75

Abfragen von Objekten mit einem Attribut namens "myAttribute" mit dem Wert 75.
attributes.myAttribute:[75 TO 80]

Abfragen von Objekten mit einem Attribut namens "myAttribute", dessen Wert innerhalb eines numerischen Bereichs liegt (7580, einschließlich).
attributes.myAttribute:{75 TO 80]

Abfragen von Objekten mit einem Attribut namens "myAttribute", dessen Wert innerhalb des numerischen Bereichs liegt (>75 und<=80).
attributes.serialNumber:["abcd" TO "abcf"]

Abfragen von Objekten mit einem Attribut namens "serialNumber", dessen Wert innerhalb eines alphanumerischen Zeichenfolgebereichs liegt. Diese Abfrage gibt Objekte mit einem "serialNumber"-Attribut mit den Werten "abcd", "abce" oder "abcf" zurück.
attributes.myAttribute:i*t

Abfragen von Objekten mit einem Attribut namens "myAttribute" mit dem Wert "i", gefolgt von einer beliebigen Anzahl von Zeichen, gefolgt von "t".
attributes.attr1:abc AND attributes.attr2<5 NOT attributes.attr3>10

Abfragen mit booleschen Ausdrücken von Objekten, die Begriffe kombinieren. Diese Abfrage gibt Objekte zurück, die ein Attribut mit dem Namen "attr1" mit dem Wert "abc", ein Attribut mit dem Namen "attr2", das kleiner als 5 ist, und ein Attribut mit dem Namen "attr3", das nicht größer als 10 ist, aufweisen.
shadow.hasDelta:true

Abfragen nach Objekten mit einem unbenannten Schatten, der ein Deltaelement enthält.
NOT attributes.model:legacy

Abfragen von Objekten, bei denen das Attribut namens "model" nicht "legacy" ist.
shadow.reported.stats.battery:{70 TO 100} (v2 OR v3) NOT attributes.model:legacy

Abfragen von Objekten, für die Folgendes gilt:

  • Das Schattenattribut stats.battery des Objekts enthält einen Wert zwischen 70 und 100.

  • Der Text „v2” oder „v3” ist im Namen, im Typnamen oder in den Attributwerten eines Objekts enthalten.

  • Das Attribut model des Objekts ist nicht auf „legacy” festgelegt.
shadow.reported.myvalues:2

Abfragen von Objekten, bei denen das Array myvalues im Abschnitt Gemeldete des Schattens den Wert 2 enthält.
shadow.reported.location:* NOT shadow.desired.stats.battery:*

Abfragen von Objekten, für die Folgendes gilt:

  • Das Attribut location ist im Abschnitt reported des Schattens vorhanden.

  • Das Attribut stats.battery ist nicht im Abschnitt desired des Schattens vorhanden.
shadow.name.<shadowName>.hasDelta:true

Abfragen nach Objekten, die einen Schatten mit dem angegebenen Namen und auch ein Delta-Element haben.

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

Fragt nach Objekten ab, die einen Schatten mit dem angegebenen Namen und auch einer gewünschten Filamenteigenschaft haben.

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

Fragt nach Objekten, die einen Schatten mit dem angegebenen Namen haben und bei denen das location Attribut im Berichtsbereich des benannten Schattens vorhanden ist.
connectivity.connected:true

Abfragen für alle angeschlossenen Geräte.
connectivity.connected:false Abfrage für alle nicht verbundenen Geräte.
connectivity.connected:true AND connectivity.timestamp : [1557651600000 TO 1557867600000] Abfragen für alle verbundenen Geräte mit einem Verbindungszeitstempel >= 1557651600000 und <= 1557867600000. Zeitstempel werden in Millisekunden seit der Epoche angegeben.
connectivity.connected:false AND connectivity.timestamp : [1557651600000 TO 1557867600000] Abfragen für alle getrennten Geräte mit einem Trennungszeitstempel >= 1557651600000 und <= 1557867600000. Zeitstempel werden in Millisekunden seit der Epoche angegeben.
connectivity.connected:true AND connectivity.timestamp > 1557651600000 Abfragen für alle verbundenen Geräte mit einem Verbindungszeitstempel > 1557651600000. Zeitstempel werden in Millisekunden seit der Epoche angegeben.
connectivity.connected:* Abfragen für alle Geräte mit vorhandenen Verbindungsinformationen.
connectivity.disconnectReason:* Abfragen für alle Geräte mit vorhandenen Verbindungsinformationen.
connectivity.disconnectReason:CLIENT_INITIATED_DISCONNECT Abfragen für alle Geräte, die aufgrund von CLIENT_INITIATED_DISCONNECT getrennt wurden.
deviceDefender.violationCount:[0 TO 100] Abfragen nach Objekten, bei denen Device Defender einen Zählwert verletzt, der innerhalb des numerischen Bereichs (0-100, einschließlich) liegt.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.inViolation:true Abfragen nach Objekten, die gegen das im Sicherheitsprofil device-SecurityProfile definierte Verhalten disconnectBehavior verstoßen. Beachten Sie, dass inviolation:False keine gültige Abfrage ist.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationValue.number>2 Abfragen nach Dingen, die gegen das im Sicherheitsprofil des Geräts definierte Verhalten disconnectBehavior verstoßen, SecurityProfile wobei der Wert für das letzte Verstoßereignis größer als 2 ist.
deviceDefender.<device-SecurityProfile>.disconnectBehavior.lastViolationTime>1634227200000

Abfragen nach Dingen, die gegen das im Sicherheitsprofilgerät definierte Verhalten disconnectBehavior verstoßen, SecurityProfile wobei der letzte Verstoß erst nach einer bestimmten Epoche aufgetreten ist.

shadow.name.gps-tracker.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km Abfragen nach Objekten, die sich innerhalb einer radialen Entfernung von 15,5 km von den Koordinaten 47.6204, -122.3491 befinden. Diese Abfragezeichenfolge gilt für den Fall, dass Ihre Standortdaten in einem benannten Schatten gespeichert werden.
shadow.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km Abfragen für Objekte, die sich innerhalb einer radialen Entfernung von 15,5 km von den Koordinaten 47,6204, -122,3491 befinden. Diese Abfragezeichenfolge gilt für den Fall, dass Ihre Standortdaten in einem klassischen Schatten gespeichert werden.