Verwenden Sie diesen Artikel als Übersicht des Level CLI-Befehlsbaums. Für die genauen Flags und die JSON-Ausgabestruktur Ihrer installierten Version verwenden Sie die integrierte Hilfe oder die generierte Skill-Referenz:

lvl --help
lvl skill describe

Zum Beispiel:

lvl device list --help
lvl skill describe device list

Befehlssyntax

Die allgemeine Form lautet:

lvl [--profile ] [arguments] [flags]

Oberste Befehlsliste anzeigen:

lvl --help

Alle generierten Referenzeinträge anzeigen:

lvl skill describe

Profile und Authentifizierung

Level CLI enthält ein integriertes prod Profil für https://api.level.io.

Die Profilauswahl erfolgt in dieser Reihenfolge:

Der Stamm- --profile Flag.
Die LVL_PROFILE Umgebungsvariable.
Das gespeicherte Standardprofil.
Das integrierte prod Profil.

Häufige Befehle:

Befehl	Zweck
`lvl auth login`	Anmeldung über einen browserbasierten Genehmigungsablauf.
`lvl auth status`	Aktive Sitzung und Organisation überprüfen.
`lvl auth logout`	Aktive Sitzung widerrufen und lokale Anmeldeinformationen entfernen.
`lvl profile list`	Konfigurierte API-Server-Profile auflisten.
`lvl profile create <name> <url>`	Ein Profil hinzufügen. Verwenden Sie `--default` um es sofort auszuwählen.
`lvl profile use <profile>`	Das Standardprofil festlegen.
`lvl profile delete <profile>`	Lokale Profilkonfiguration und Anmeldeinformationen entfernen.

⚠️ WARNUNG: Das Löschen eines Profils widerruft nicht die serverseitige Sitzung. Führen Sie lvl --profile <profile> auth logout vor dem Löschen.

CLI-Aktualisierungen

Release-Builds halten sich standardmäßig aktuell. Wenn Sie einen normalen lvl Befehl wendet die CLI alle zuvor entdeckten signierten Aktualisierungen an und führt den Befehl mit der neuen Binärdatei erneut aus. Wenn keine Aktualisierung aussteht, wird im Hintergrund nach einer gesucht und diese kann beim nächsten Aufruf angewendet werden. Fehlgeschlagene automatische Aktualisierungen stoppen den von Ihnen angeforderten Befehl nicht lvl zum Ausführen.

Befehl	Zweck
`lvl self-update`	Sofort nach dem neuesten veröffentlichten Build suchen und diesen installieren. Dies funktioniert auch, wenn automatische Aktualisierungen deaktiviert sind.
`lvl self-update --check`	Melden, ob eine Aktualisierung verfügbar ist, ohne sie zu installieren.
`lvl self-update url`	Die aktuell für Aktualisierungen verwendete Release-URL anzeigen.
`lvl self-update url <url>`	Eine benutzerdefinierte Release-URL in `~/.lvl/config.yaml`.
`lvl self-update url --reset`	Die benutzerdefinierte URL entfernen und zur integrierten Produktionsquelle zurückkehren.

Setzen Sie auto_update: false in ~/.lvl/config.yaml um automatische Prüfungen und Startzeitaktualisierungen zu deaktivieren. Sie können weiterhin lvl self-update manuell.

Ausgabeformate

Die meisten Befehle zeigen standardmäßig eine lesbare Tabelle oder Zusammenfassung an.

JSON-Ausgabe verwenden:

lvl device list -o json

Den integrierten jq-Filter verwenden:

lvl device list --jq '.list[] | {id, name, online}'

--jq impliziert JSON. Es kann nicht mit expliziter Tabellenausgabe kombiniert werden.

CSV-Exportbefehle schreiben rohes CSV in die Standardausgabe:

lvl device export > devices.csv
lvl alert export > alerts.csv
lvl run export > runs.csv

Automatisierungs- und Monitor-Richtlinien-Spezifikationsbefehle verwenden --format yaml|json, wobei YAML der Standard ist. Sie verwenden nicht das Standard- -o Flag für die Spezifikation selbst.

Seitenumbruch

Die meisten Ressourcenlistenbefehle unterstützen:

Flag	Verhalten
`--limit <count>`	Bis zur angeforderten Anzahl von Datensätzen zurückgeben. Der Standardwert ist 100.
`--limit all`	Alle Ergebnisseiten abrufen.
`--page <number>`	Eine 1-basierte Seite zurückgeben.

--limit all kann nicht mit --page.

Zu den paginierten Befehlen gehören Benachrichtigungs-, Automatisierungs-, Automatisierungs-Trigger-, Geräte-, Datei-, Monitor-, Monitor-Richtlinien-, Ausführungs-, Skript-, Tag-, Aktualisierungs-, Aktualisierungszusammenfassungs-, Geräteaktualisierungs-, Aktualisierungsprotokoll- und Aktualisierungsausschlusslisten.

API-Schlüssel, Gruppen, benutzerdefinierte Felder, Profile und Variablen verwenden nicht paginierte Listen.

In der JSON-Listenausgabe ist count ist die Gesamtzahl der übereinstimmenden Serverdatensätze, nicht die Anzahl der auf der aktuellen Seite zurückgegebenen.

Ressourcenverweise

Viele Befehle akzeptieren eine ID oder einen menschenlesbaren Verweis. Eine exakte ID-Übereinstimmung hat Vorrang. Name- und Alias-Abgleich ist nicht von Groß-/Kleinschreibung abhängig.

Häufige Formen sind:

Ressource	Akzeptierte Verweise
Gerät	ID, Hostname, Name, Spitzname oder `<group>/<hostname>`
Gerätegruppe	ID, Name oder verschachtelter Pfad wie `Ops/Maintenance`
Automatisierung	ID oder Name
Skript	ID oder Name
Repository-Datei	ID oder Dateiname, mit oder ohne Erweiterung
Monitor-Richtlinie	ID oder Name
Tag	Name
Benutzerdefiniertes Feld	Name oder generierter Verweis
Aktualisierungsausschluss	ID oder KB-Nummer, mit oder ohne das `KB` Präfix

Wenn ein Verweis auf mehr als eine Ressource zutrifft, hält die CLI an und listet die Kandidaten auf, anstatt einen auszuwählen.

Benachrichtigungsbefehle

Befehl	Zweck
`alert list`	Aktive, gelöste oder alle Benachrichtigungen auflisten.
`alert get <alert-id>`	Eine Benachrichtigung abrufen.
`alert resolve`	Benachrichtigungen nach ID oder Filtern lösen.
`alert unresolve <alert-id>...`	Gelöste Benachrichtigungen nach ID erneut öffnen.
`alert export`	Übereinstimmende Benachrichtigungen als CSV exportieren.

API-Schlüsselbefehle

Befehl	Zweck
`apikey list`	API-Schlüssel auflisten.
`apikey get <api-key>`	Einen API-Schlüssel abrufen. Verwenden Sie `--reveal` um das vollständige Token in der Tabellenausgabe anzuzeigen.
`apikey create`	Einen schreibgeschützten oder lese- und schreibfähigen API-Schlüssel erstellen.
`apikey update <api-key>`	Einen API-Schlüssel aktualisieren.
`apikey delete <api-key>...`	API-Schlüssel dauerhaft löschen.

⚠️ WARNUNG: Die JSON-Ausgabe des API-Schlüssels enthält das vollständige Token. Schützen Sie die Terminalausgabe, exportierte Dateien und CI-Protokolle.

Automatisierungsbefehle

Befehl	Zweck
`automation list`	Automatisierungen auflisten.
`automation get <automation>`	Eine Automatisierung abrufen.
`automation create`	Eine Automatisierung aus Flags oder einer Spezifikationsdatei erstellen.
`automation spec <automation>`	Eine Automatisierungsspezifikation exportieren.
`automation apply -f <spec>`	Eine bestehende Automatisierung mit einer Spezifikation abgleichen.
`automation update <automation>`	Automatisierungseigenschaften aktualisieren.
`automation delete <automation>...`	Automatisierungen archivieren.
`automation restore <automation>...`	Archivierte Automatisierungen wiederherstellen.
`automation run <automation>`	Eine Automatisierung auf Geräten oder Gruppen ausführen.
`automation trigger ...`	Trigger auflisten, hinzufügen, aktualisieren, löschen oder manuell ausführen.
`automation action ...`	Aktionen hinzufügen, aktualisieren oder löschen.
`automation variable ...`	Automatisierungsvariablen verwalten.
`automation group ...`	Automatisierungsgruppen verwalten.

Statuswerte:

automation list meldet active wenn eine Automatisierung mindestens einen aktivierten Trigger hat, manual wenn sie keine aktivierten Trigger hat, und archived wenn sie archiviert ist.
automation trigger list meldet active für einen aktivierten Trigger und disabled für einen Trigger, der nicht aktiviert ist.
Die Automatisierungsausführung wird durch den Trigger-Status gesteuert. Der veraltete automatisierungsweite enabled Wert bestimmt diese Status nicht oder ob Trigger Ausführungen starten können.

Trigger- und Aktionsmutationsbefehle akzeptieren --json oder --json-file. Die Nutzlast muss genau einen unterstützten Typ enthalten, und unbekannte Felder werden abgelehnt.

Führen Sie lvl automation action --help oder lvl skill describe automation action für die von Ihrer installierten Version unterstützten Aktionstypen.

⚠️ WARNUNG:automation apply kann Trigger und Aktionen löschen, die in der Spezifikation fehlen. Die Anwendung ist nicht transaktional. Ausführen mit --dry-run aus und überprüfen Sie zuerst den Plan.

Anwendungsbefehle

Verwenden Sie diese Befehle, um das organisationsweite Anwendungsinventar zu überprüfen und einen Drilldown zu Versionen oder einzelnen Installationen durchzuführen.

Befehl	Zweck
`app list`	Eine aggregierte Zeile pro Anwendungsname, Herausgeber und Plattform auflisten. Unterstützt Seitenumbruch.
`app summary`	Anwendungs- und Installationszähler anzeigen, einschließlich Anwendungszähler nach Plattform, für den gefilterten Bereich.
`app versions <app>`	Versionen einer Anwendung mit Installations- und Gerätezählern auflisten.
`app installs [<app>]`	Einzelne Installationen einer Anwendung auflisten oder `<app>` und genau eine `--device` um das vollständige Anwendungsinventar dieses Geräts aufzulisten. Unterstützt Seitenumbruch.
`app uninstall [<app>...]`	Deinstallationsbefehle für ausgewählte Anwendungsinstallationen senden. Positionelle Anwendungsverweise sind äquivalent zu wiederholbaren `--app` Flags.

Datei-Uploads

Eine oder mehrere lokale Dateien in das Level-Dateirepository hochladen:

lvl file upload <path>...

Standardmäßig verwendet lvl verwendet den lokalen Dateinamen. Um einen benutzerdefinierten Namen für eine Datei zu wählen, verwenden Sie --name ohne Erweiterung:

lvl file upload <path> --name <name>

Die Dateierweiterung stammt immer aus der lokalen Datei. Die --name Option gilt nur für eine einzelne Datei.

Verwandte Artikel

Level CLI-Referenz