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.
Der 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`	Die aktive Sitzung und Organisation überprüfen.
`lvl auth logout`	Die aktive Sitzung widerrufen und lokale Anmeldedaten 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 Anmeldedaten entfernen.

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

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 setzt JSON voraus. Es kann nicht mit expliziter Tabellenausgabe kombiniert werden.

CSV-Exportbefehle schreiben rohe CSV-Daten in die Standardausgabe:

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

Befehle für Automatisierungen und Monitor-Richtlinienspezifikationen 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 kombiniert werden --page.

Seitenumbruchfähige Befehle umfassen Alarm-, Automatisierungs-, Automatisierungsauslöser-, Geräte-, Datei-, Monitor-, Monitor-Richtlinien-, Ausführungs-, Skript-, Tag-, Aktualisierungs-, Aktualisierungszusammenfassungs-, Aktualisierungsgeräte-, Aktualisierungsprotokoll- und Aktualisierungsausschlusslisten.

API-Schlüssel, Gruppen, benutzerdefinierte Felder, Profile und Variablen verwenden nicht seitenumbruchfähige 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 lesbaren Verweis. Eine exakte ID-Übereinstimmung hat Priorität. Name- und Alias-Übereinstimmung ist nicht zwischen Groß- und Kleinschreibung unterscheidend.

Häufige Formen umfassen:

Ressource	Akzeptierte Verweise
Gerät	ID, Hostname, Name, Spitzname oder `<group>/<hostname>`
Gerätegruppe	ID, Name oder verschachtelter Pfad wie z. B. `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.

Alarmbefehle

Befehl	Zweck
`alert list`	Aktive, gelöste oder alle Alarme auflisten.
`alert get <alert-id>`	Einen Alarm abrufen.
`alert resolve`	Alarme nach ID oder Filtern auflösen.
`alert unresolve <alert-id>...`	Gelöste Alarme nach ID wieder öffnen.
`alert export`	Übereinstimmende Alarme 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-/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 von API-Schlüsseln 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 vorhandene 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 ...`	Auslöser 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.

Befehle zur Mutation von Auslösern und Aktionen akzeptieren --json oder --json-file. Die Nutzlast muss genau einen unterstützten Typ enthalten, und unbekannte Felder werden abgelehnt.

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

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

Befehle für benutzerdefinierte Felder

Befehl	Zweck
`customfield list`	Benutzerdefinierte Felder der Organisation auflisten.
`customfield get <field>`	Ein benutzerdefiniertes Feld abrufen.
`customfield create`	Ein Feld erstellen.
`customfield update <field>`	Ein Feld aktualisieren.
`customfield delete <field>...`	Felder löschen.
`customfield set <field> <value>`	Einen Wert auf Organisationsebene festlegen.
`customfield clear <field>`	Einen Wert auf Organisationsebene löschen.
`device customfield ...`	Werte auf Geräteebene auflisten, festlegen oder löschen.
`device group customfield ...`	Werte auf Gerätegruppenebene auflisten, festlegen oder löschen.

Benutzerdefinierte Feldwerte werden von der Organisation über die Gerätegruppe bis zum Gerät vererbt. Kaskadierende Festlege- oder Löschoperationen können untergeordnete Werte überschreiben oder entfernen.

Gerätebefehle

Befehl	Zweck
`device list`	Geräte auflisten und filtern.
`device get <device>`	Gerätedetails abrufen.
`device restart <device>...`	Neustart anfordern.
`device shutdown <device>...`	Herunterfahren anfordern.
`device maintenance enable\|disable <device>...`	Wartungsmodus ändern.
`device update <device>`	Bearbeitbare Geräteeigenschaften aktualisieren.
`device delete <device>...`	Geräte dauerhaft löschen.
`device favorite\|unfavorite <device>...`	Favoritenstatus ändern.
`device flag\|unflag <device>...`	Markierungsstatus ändern.
`device export`	Geräte als CSV exportieren.
`device install-key`	Einen Agent-Installationsschlüssel für die Bereitstellung ausgeben.
`device group ...`	Gerätegruppen und Zuweisungen verwalten.
`device customfield ...`	Benutzerdefinierte Feldwerte von Geräten verwalten.

Neustart- und Herunterfahranforderungen starten die Aktion sofort und warten nicht darauf, dass das Gerät sie abschließt.

⚠️ WARNUNG:device install-key gibt eine Bereitstellungsanmeldeinformation in der Standardausgabe aus. Vermeiden Sie, sie in der Shell-Historie, gemeinsam genutzten Terminals oder CI-Protokollen offenzulegen.

Dateibefehle

Befehl	Zweck
`file list`	Repository-Dateien auflisten.
`file get <file>`	Datei-Metadaten abrufen.
`file upload <path>...`	Lokale Dateien hochladen.
`file download <file> [<dest>]`	Eine Datei herunterladen. Verwenden Sie `-` als Ziel für die Standardausgabe.
`file rename <file> <filename>`	Eine Repository-Datei umbenennen.
`file replace <file> <path>`	Dateiinhalt ersetzen, während die Repository-Datei-ID erhalten bleibt.
`file delete <file>...`	Dateien dauerhaft löschen.
`file storage`	Speichernutzung anzeigen.
`file group ...`	Repository-Dateigruppen verwalten.

file download --overwrite kann eine vorhandene lokale Datei ersetzen. Das Ersetzen einer Repository-Datei ändert den von Automatisierungen verwendeten Inhalt, die auf diese Datei-ID verweisen.

Monitor-Befehle

Befehl	Zweck
`monitor list`	Monitore über Richtlinien hinweg auflisten.
`monitor get <monitor>`	Einen Monitor abrufen.
`monitor add <policy>`	Einen Monitor aus einer JSON-Nutzlast zu einer Richtlinie hinzufügen.
`monitor update <monitor>`	Einen Monitor mit einer JSON-Nutzlast aktualisieren.
`monitor delete <monitor>...`	Monitore löschen.
`monitor enable\|disable <monitor>... --device <device>`	Monitore für ein Gerät überschreiben.
`monitor policy list`	Monitor-Richtlinien auflisten.
`monitor policy get <policy>`	Eine Richtlinie abrufen.
`monitor policy create`	Eine Richtlinie aus Flags oder einer Spezifikation erstellen.
`monitor policy spec <policy>`	Eine Richtlinienspezifikation exportieren.
`monitor policy apply -f <spec>`	Eine Richtlinie mit einer Spezifikation abgleichen.
`monitor policy target\|untarget <policy>`	Ziel-Tags verwalten.

Monitor-Nutzlastbefehle akzeptieren --json oder --json-file. Führen Sie aus: lvl monitor add --help für die unterstützten Monitor-Typen.

Die Anwendung von Monitor-Richtlinien kann Monitore löschen, die in der Datei fehlen, und ist nicht transaktional. Verwenden Sie --dry-run zuerst.

Ausführungsbefehle

Befehl	Zweck
`run list`	Automatisierungs- und Skriptausführungen auflisten.
`run get <run-id>`	Eine Ausführung und ihre Schritte abrufen. Verwenden Sie `--wait` zum Abfragen auf Abschluss.
`run cancel`	Ausführungen nach ID oder Filtern abbrechen.
`run rerun`	Neue Ausführungen aus ausgewählten Ausführungen starten.
`run retry <run-id>...`	Fehlgeschlagene Ausführungen ab dem fehlgeschlagenen Schritt wiederholen.
`run approve <run-id>...`	Ausführungen genehmigen, die bei einem Genehmigungsschritt angehalten sind.
`run deny <run-id>...`	Ausführungen ablehnen und abbrechen, die bei einem Genehmigungsschritt angehalten sind.
`run export`	Ausführungen als CSV exportieren.

Das Warten ist standardmäßig auf 15 Minuten begrenzt und gibt bis zu 1.000 Ausgabezeilen pro Schritt zurück. Verwenden Sie --wait-timeout und --output-lines um diese Grenzen zu ändern.

Ein ERROR oder CANCELED Ergebnis beendet mit einem Nicht-Null-Wert. Ein WARNING Ergebnis wird als erfolgreich behandelt.

Skriptbefehle

Befehl	Zweck
`script list`	Gespeicherte Skripte auflisten.
`script get <script>`	Ein gespeichertes Skript abrufen. Verwenden Sie `--raw` um nur den Inhalt auszugeben.
`script create`	Ein Skript aus `--file` oder `--command`.
`script update <script>`	Ein gespeichertes Skript aktualisieren.
`script delete <script>...`	Skripte löschen.
`script run [<script>]`	Ein gespeichertes Skript, eine Datei oder einen Inline-Befehl ausführen.
`script variable ...`	Skriptvariablen verwalten.
`script group ...`	Skriptgruppen verwalten.

Ein Ausführungsziel kann aus wiederholten --device Flags, --group, oder beides. Doppelte Ziele werden einmal ausgeführt.

Ein gespeichertes Skript verwendet seine gespeicherte Shell, sein Timeout und seine Ausführungseinstellung. Ad-hoc-Skriptausführungen leiten die Shell aus einem expliziten Flag, der Dateierweiterung, dem Shebang oder dem Zielbetriebssystem ab.

⚠️ WARNUNG: Die Skripterstellung und Ad-hoc-Skriptausführungen verwenden standardmäßig die SYSTEM Ausführungseinstellung. Überprüfen Sie das Skript und die Zielliste vor der Ausführung.

Skill-Befehle

Befehl	Zweck
`skill show`	Die generierte `SKILL.md`.
`skill install`	Den Skill für den aktuellen Benutzer installieren.
`skill install --project`	Den Skill im aktuellen Projekt installieren.
`skill describe [<command>...]`	Flags und JSON-Ausgabedefinitionen ausgeben.

Den Skill nach dem Upgrade von lvl damit Coding-Agenten den aktuellen Befehlsbaum erhalten.

Tag-Befehle

Befehl	Zweck
`tag list`	Tags auflisten.
`tag get <tag>`	Ein Tag abrufen.
`tag create`	Ein Tag erstellen.
`tag update <tag>`	Ein Tag aktualisieren.
`tag delete <tag>...`	Nicht verwendete Tags löschen.
`tag assign <tag> --device <device>...`	Ein Tag Geräten zuweisen.
`tag unassign <tag> --device <device>...`	Ein Tag von Geräten entfernen.

Aktualisierungsbefehle

Befehl	Zweck
`update list`	Verfügbare, installierte oder alle Aktualisierungen auflisten.
`update get <update-id>`	Eine Aktualisierung abrufen.
`update check <device>...`	Eine Aktualisierungsprüfung anfordern.
`update install`	Ausgewählte Aktualisierungen installieren.
`update retry`	Fehlgeschlagene Installationen für ausgewählte Einträge wiederholen.
`update install-all`	Verfügbare Aktualisierungen auf ausgewählten Geräten installieren.
`update log list\|get`	Aktualisierungsinstallationsdatensätze und -protokolle prüfen.
`update summary list`	Aktualisierungszusammenfassungen auflisten.
`update device list`	Geräte im Aktualisierungskontext auflisten.
`update exclusion list\|create\|update\|delete`	Globale KB-Ausschlüsse verwalten.

Aktualisierungsinstallation, Wiederholung und Alle-installieren erlauben standardmäßig erforderliche Neustarts. Verwenden Sie --no-reboot wenn der ausgewählte Befehl ein Gerät nicht neu starten soll.

⚠️ WARNUNG: Überprüfen Sie die Aktualisierungs- und Geräteauswahl vor der Installation. Filter-basierte und geräteweite Operationen erfordern eine ausdrückliche Bestätigung.

Gruppenbefehle

Geräte-, Skript-, Automatisierungs- und Dateigruppen teilen diese Unterbefehle:

list
create
rename
move
delete
assign
unassign

Gruppenlisten rufen die vollständige Hierarchie ab. Das Löschen einer Gruppe erfordert, dass sie leer ist und keine untergeordneten Gruppen hat.

Bestätigung und asynchrone Vorgänge

Dauerhaft-Lösch-Befehle unterstützen --yes. In einem interaktiven Terminal kann die CLI zur Eingabe auffordern. Bei nicht-interaktiver Ausführung schlagen Befehle, die eine Bestätigung erfordern, fehl, es sei denn, --yes angegeben wird.

Einige Befehle kehren zurück, nachdem Level die Anforderung akzeptiert hat, bevor die Arbeit auf einem Gerät abgeschlossen ist. Dazu gehören Energieaktionen, Aktualisierungsprüfungen und -installationen, Skripte, Automatisierungen und Ausführungen von Auslösern. Verwenden Sie den Ausführungsverlauf, run get --wait, Aktualisierungsprotokolle oder die Level-Webanwendung, um das endgültige Ergebnis zu bestätigen.

Verwandte Artikel

Level CLI-Referenz