Startseite › Entwickler-Tools › JMESPath Tester

JMESPath Tester

Gib einen JMESPath-Ausdruck ein und sieh das Ergebnis sofort. Probiere es mit realistischer AWS-CLI-Ausgabe (EC2-Instanzen, S3-Objekte) oder füge dein eigenes JSON ein, und kopiere dann einen fertigen --query-Befehl für Bash, PowerShell oder cmd.

Zuletzt aktualisiert:

Anzeige
Anzeige

Anleitung: JMESPath Tester

  1. Wähle Beispieldaten (EC2, S3, Personen oder Bestellungen) oder füge dein eigenes JSON ein, zum Beispiel die Ausgabe eines AWS-CLI-Befehls.
  2. Gib einen JMESPath-Ausdruck in das Abfragefeld ein oder klicke auf einen der Beispiel-Chips.
  3. Lies das Ergebnis rechts ab. Das Badge zeigt Typ und Größe; null bedeutet, dass nichts gefunden wurde.
  4. Sieh dir den Tab „Parse-Baum“ an, wenn dich das Ergebnis überrascht, um zu sehen, wie Projektionen und Pipes gruppiert wurden.
  5. Öffne den Tab „AWS CLI“ und kopiere den --query-Befehl mit den passenden Anführungszeichen für deine Shell.

JMESPath-Syntax-Spickzettel

SyntaxWas es machtBeispiel
a.bUnterausdruck: der Schlüssel b innerhalb von a; fehlende Schlüssel ergeben nullState.Name
"key-name"Bezeichner in Anführungszeichen für Schlüssel mit Leerzeichen, Bindestrichen oder führenden Ziffern"first-name"
[0], [-1]Index in eine Liste; negative Werte zählen vom EndeContents[-1]
[start:stop:step]Slice; stop ist exklusiv, jeder Teil optionalpeople[:2], items[::-1]
[*]Listenprojektion: den Rest des Ausdrucks auf jedes Element anwendenpeople[*].name
[]Eine Ebene abflachen, dann projizierenReservations[].Instances[]
.*Objektprojektion über alle Werte eines Objektsregions.*.endpoint
[?expr]Filterprojektion: Elemente behalten, bei denen expr wahr ist[?Size > `1000`]
== != < <= > >=Vergleiche; Ordnung funktioniert nur mit Zahlen[?age >= `18`]
&& || !Und, oder (liefert den ersten wahren Wert), nichtcity || 'unknown'
[a, b]Multiselect-Liste: ein Array pro Element bilden[InstanceId, State.Name]
{k: a}Multiselect-Hash: ein Objekt mit neuen Schlüsselnamen bilden{ID: InstanceId}
|Pipe: die Projektion beenden und die rechte Seite auf das gesamte Ergebnis anwendenpeople[*].name | [0]
@Der aktuelle Knotenlength(@)
`json`, 'raw'JSON-Literal und Raw-String-Literal`30`, `true`, 'prod'
&exprAusdrucksreferenz, wird an sort_by, max_by, min_by, map übergebensort_by(Contents, &Size)

Eingebaute Funktionen

FunktionLiefert
length(x)Zeichen in einem String, Elemente in einer Liste oder Schlüssel in einem Objekt
sort(list), sort_by(list, &key)Sortierte Liste (nur Zahlen oder Strings; sort_by ist stabil)
max, min, max_by, min_byGrößter oder kleinster Wert bzw. größtes oder kleinstes Element (null bei leerer Liste)
sum(list), avg(list)Summe und Mittelwert einer Zahlenliste
contains(list|string, value)True, wenn die Liste den Wert oder der String den Teilstring enthält
starts_with, ends_withPräfix- und Suffixprüfung bei Strings
join(sep, list)Eine Liste von Strings zu einem String verbinden
keys(obj), values(obj), merge(a, b, …)Objektschlüssel, Werte und ein flaches Zusammenführen (spätere gewinnen)
map(&expr, list)Einen Ausdruck auf jedes Element anwenden, null-Werte bleiben erhalten
not_null(a, b, …)Erstes Argument, das nicht null ist
to_string, to_number, to_array, typeUmwandlungen und der Typname
abs, ceil, floor, reverseMathe-Helfer und Umkehren einer Liste oder eines Strings

Tipps für AWS-CLI-Abfragen

  • Projektionen enden an einer Pipe. Reservations[].Instances[].Tags[0] liefert das erste Tag jeder Instanz, während Reservations[].Instances[].Tags | [0] nur die gesamte Tag-Liste der ersten Instanz liefert.
  • Tags auslesen: Tags[?Key=='Name'].Value | [0] macht aus der AWS-Key/Value-Tag-Liste einen einzelnen Namen.
  • Wahrheitswerte: false, null, leere Strings, leere Listen und leere Objekte sind falsch; die Zahl 0 ist wahr.
  • Serverseitig oder clientseitig: --query filtert erst, nachdem die Antwort angekommen ist. Um zu reduzieren, was AWS zurückgibt, kombiniere es mit --filters oder den serverseitigen Optionen des Befehls.
  • Ausgabe als Tabelle: Ein Multiselect-Hash wie {ID: InstanceId, Type: InstanceType} ergibt mit --output table schön beschriftete Spalten.

Häufige Fragen

Was ist JMESPath?

JMESPath (ausgesprochen „James Path“) ist eine Abfragesprache für JSON mit formaler Spezifikation und einer Konformitäts-Testsuite, sodass derselbe Ausdruck in Python, JavaScript, Go, Java und anderen Implementierungen dasselbe Ergebnis liefert. Sie ist die Sprache hinter der Option --query der AWS CLI und der Azure CLI.

Wie verwende ich JMESPath mit der AWS CLI?

Füge --query gefolgt vom Ausdruck hinzu, zum Beispiel aws ec2 describe-instances --query 'Reservations[].Instances[].InstanceId'. Die CLI wendet den Ausdruck auf deinem Rechner auf die JSON-Antwort an, bevor sie sie ausgibt, sodass du ihn mit --output table oder --output text kombinieren kannst. Teste den Ausdruck zuerst hier und kopiere ihn dann aus dem Tab „AWS CLI“.

Warum brauche ich Backticks um Zahlen?

In JMESPath ist eine nackte Zahl kein Wert, daher ist [?age > 30] ein Syntaxfehler. JSON-Literale gehören in Backticks: [?age > `30`]. Strings können stattdessen Raw-String-Anführungszeichen verwenden: [?name == 'Ava']. Doppelte Anführungszeichen sind für Bezeichner mit Sonderzeichen, wie "first-name".

Was ist der Unterschied zwischen [*] und []?

Beide erzeugen eine Projektion über eine Liste. [*] behält die Struktur bei, daher liefert Reservations[*].Instances[*].InstanceId eine Liste von Listen. [] flacht zusätzlich eine Ebene ab, daher liefert Reservations[].Instances[].InstanceId eine einzige flache Liste von IDs – meist das, was du bei AWS-Ausgaben willst.

Warum liefert mein Filter eine leere Liste oder null?

Ein fehlender Schlüssel liefert null statt eines Fehlers, und Ordnungsvergleiche wie < funktionieren nur mit Zahlen. Häufige Ursachen: ein Tippfehler oder falsche Groß-/Kleinschreibung im Schlüsselnamen, der Vergleich einer Zahl mit einem String wie `"30"`, ein Filter auf ein Objekt statt auf eine Liste oder fehlende Backticks um eine Zahl.

Wie unterscheidet sich JMESPath von JSONPath und jq?

JSONPath wählt nur vorhandene Werte aus, und sein Verhalten unterscheidet sich je nach Bibliothek (es wurde spät als RFC 9535 standardisiert). JMESPath kann Ergebnisse zusätzlich mit Multiselect-Hashes und eingebauten Funktionen umformen, und jede Implementierung folgt einer Spezifikation. jq ist eine vollständige Programmiersprache mit Variablen und Arithmetik, aber ein separates Kommandozeilen-Tool und nicht in die AWS- und Azure-CLIs eingebaut.

Wird mein JSON irgendwohin gesendet?

Nein. Die JMESPath-Engine ist reines JavaScript, das in dieser Seite läuft. Dein JSON, einschließlich aller AWS-Ressourcendetails, bleibt in deinem Browser.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Code-Playgrounds & Tester ansehen →