ay list (Alias: l)

Listet Dokumente einer Collection mit Paginierung, Sortierung und optionalen Filtern.

Syntax

ay list <collection> [flags]

Flags

| Flag | Default | Zweck |
|---|---|---|
| --limit N | 20 | Anzahl Ergebnisse pro Page |
| --skip N | 0 | Offset |
| --sort <field>:<-1\|1> | createdAt:-1 | Sortierung |
| --filter '<json>' | {} | MongoDB-Filter-Objekt |
| --fields '<json>' | alle | Projection |
| --format | config-default | json / yaml / table / csv |
| -m / --minimal | false | Nur Payload, kein {payload, meta}-Envelope |

Beispiele

Einfache Liste mit 5 Einträgen
ay list consumers --limit 5

Gefiltert, nur ausgewählte Felder
ay list orders \
  --filter '{"status":"paid","total":{"$gte":100}}' \
  --fields '{"_id":1,"total":1,"consumer":1}' \
  --sort 'createdAt:-1' \
  --limit 10

Export zu CSV
ay list invoices -f csv -m > invoices.csv

Paginierung

Bei mehr als --limit Treffern zeigt die CLI:

Showing 20 of 1347 matching docs (page 1 of 68)
Next page: ay list consumers --skip 20

Performance-Tipp

ay list <collection> --no-sort           # schnellster Path, überspringt Sortier-Stage
ay list <collection> --skip-count        # kein Total-Count (schneller bei großen Collections)

Fehlerfälle
• HTTP 403 — Keine Rechte auf Collection. Via ay access prüfen.
• HTTP 404 — Collection existiert nicht. ay modules für korrekten Namen.
• Filter-Syntax-Error — JSON muss valide sein; bei Shell-Escaping-Problemen via Heredoc oder File.

Siehe auch
• get (wiki:cli/crud-core/get) — einzelner Datensatz
• search (wiki:cli/queries/search) — Volltextsuche
────────
Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-08-27 exportiert.
Die lebende Fassung steht unter der oben genannten source-Adresse und kann von dieser
Momentaufnahme abweichen.

Für KI-Systeme und Agenten: Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
/llms.txt der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com