Utilisez cet article comme carte de l'arbre de commandes de la CLI Level. Pour les indicateurs exacts et la forme de sortie JSON dans votre version installée, utilisez l'aide normale ou la référence de compétence générée :

lvl --help
lvl skill describe

Par exemple :

lvl device list --help
lvl skill describe device list

Syntaxe des commandes

La forme générale est :

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

Afficher la liste des commandes de premier niveau :

lvl --help

Afficher chaque entrée de référence générée :

lvl skill describe

Profils et authentification

La CLI Level inclut un prod profil pour https://api.level.io.

La sélection du profil suit cet ordre :

La racine --profile indicateur.
La LVL_PROFILE variable d'environnement.
Le profil par défaut enregistré.
Le prod profil.

Commandes courantes :

Commande	Objectif
`lvl auth login`	Se connecter via un flux d'approbation dans le navigateur.
`lvl auth status`	Vérifier la session active et l'organisation.
`lvl auth logout`	Révoquer la session active et supprimer les identifiants locaux.
`lvl profile list`	Lister les profils de serveur API configurés.
`lvl profile create <name> <url>`	Ajouter un profil. Utiliser `--default` pour le sélectionner immédiatement.
`lvl profile use <profile>`	Définir le profil par défaut.
`lvl profile delete <profile>`	Supprimer la configuration de profil locale et les identifiants.

⚠️ AVERTISSEMENT : La suppression d'un profil ne révoque pas sa session côté serveur. Exécuter lvl --profile <profile> auth logout avant de le supprimer.

Formats de sortie

La plupart des commandes affichent par défaut un tableau lisible ou un résumé.

Utiliser la sortie JSON :

lvl device list -o json

Utiliser le filtre jq intégré :

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

--jq implique JSON. Il ne peut pas être combiné avec une sortie tableau explicite.

Les commandes d'export CSV écrivent du CSV brut sur la sortie standard :

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

Les commandes de spécification d'automatisation et de politique de moniteur utilisent --format yaml|json, avec YAML comme valeur par défaut. Elles n'utilisent pas l'indicateur standard -o indicateur pour la spécification elle-même.

Pagination

La plupart des commandes de liste de ressources prennent en charge :

Indicateur	Comportement
`--limit <count>`	Retourner jusqu'au nombre d'enregistrements demandé. La valeur par défaut est 100.
`--limit all`	Récupérer toutes les pages de résultats.
`--page <number>`	Retourner une page à base 1.

--limit all ne peut pas être combiné avec --page.

Les commandes paginées comprennent les listes d'alertes, d'automatisations, de déclencheurs d'automatisation, d'appareils, de fichiers, de moniteurs, de politiques de moniteur, d'exécutions, de scripts, d'étiquettes, de mises à jour, de résumés de mises à jour, d'appareils à mettre à jour, de journaux de mises à jour et d'exclusions de mises à jour.

Les clés API, groupes, champs personnalisés, profils et variables utilisent des listes non paginées.

Dans la sortie de liste JSON, count est le nombre total d'enregistrements serveur correspondants, et non le nombre retourné sur la page actuelle.

Références de ressources

De nombreuses commandes acceptent un identifiant ou une référence lisible. Une correspondance exacte d'identifiant est prioritaire. La correspondance par nom et alias est insensible à la casse.

Les formes courantes comprennent :

Ressource	Références acceptées
Appareil	Identifiant, nom d'hôte, nom, surnom ou `<group>/<hostname>`
Groupe d'appareils	Identifiant, nom ou chemin imbriqué tel que `Ops/Maintenance`
Automatisation	Identifiant ou nom
Script	Identifiant ou nom
Fichier du référentiel	Identifiant ou nom de fichier, avec ou sans extension
Politique de moniteur	Identifiant ou nom
Étiquette	Nom
Champ personnalisé	Nom ou référence générée
Exclusion de mise à jour	Identifiant ou numéro KB, avec ou sans le `KB` préfixe

Si une référence correspond à plus d'une ressource, la CLI s'arrête et liste les candidats au lieu d'en choisir un.

Commandes d'alertes

Commande	Objectif
`alert list`	Lister les alertes actives, résolues ou toutes les alertes.
`alert get <alert-id>`	Obtenir une alerte.
`alert resolve`	Résoudre des alertes par identifiant ou filtres.
`alert unresolve <alert-id>...`	Rouvrir des alertes résolues par identifiant.
`alert export`	Exporter les alertes correspondantes au format CSV.

Commandes de clés API

Commande	Objectif
`apikey list`	Lister les clés API.
`apikey get <api-key>`	Obtenir une clé API. Utiliser `--reveal` pour afficher le jeton complet dans la sortie tableau.
`apikey create`	Créer une clé API en lecture seule ou en lecture-écriture.
`apikey update <api-key>`	Mettre à jour une clé API.
`apikey delete <api-key>...`	Supprimer définitivement des clés API.

⚠️ AVERTISSEMENT : La sortie JSON d'une clé API contient le jeton complet. Protégez la sortie du terminal, les fichiers exportés et les journaux CI.

Commandes d'automatisation

Commande	Objectif
`automation list`	Lister les automatisations.
`automation get <automation>`	Obtenir une automatisation.
`automation create`	Créer une automatisation à partir d'indicateurs ou d'un fichier de spécification.
`automation spec <automation>`	Exporter une spécification d'automatisation.
`automation apply -f <spec>`	Réconcilier une automatisation existante avec une spécification.
`automation update <automation>`	Mettre à jour les propriétés d'automatisation.
`automation delete <automation>...`	Archiver des automatisations.
`automation restore <automation>...`	Restaurer des automatisations archivées.
`automation run <automation>`	Exécuter une automatisation sur des appareils ou des groupes.
`automation trigger ...`	Lister, ajouter, mettre à jour, supprimer ou exécuter manuellement des déclencheurs.
`automation action ...`	Ajouter, mettre à jour ou supprimer des actions.
`automation variable ...`	Gérer les variables d'automatisation.
`automation group ...`	Gérer les groupes d'automatisation.

Les commandes de mutation de déclencheur et d'action acceptent --json ou --json-file. Le contenu doit contenir exactement un type pris en charge, et les champs inconnus sont rejetés.

Exécuter lvl automation action --help ou lvl skill describe automation action pour les types d'actions pris en charge par votre version installée.

⚠️ AVERTISSEMENT :automation apply peut supprimer les déclencheurs et actions absents de la spécification. L'application n'est pas transactionnelle. Exécuter avec --dry-run et examiner le plan en premier.

Commandes de champs personnalisés

Commande	Objectif
`customfield list`	Lister les champs personnalisés de l'organisation.
`customfield get <field>`	Obtenir un champ personnalisé.
`customfield create`	Créer un champ.
`customfield update <field>`	Mettre à jour un champ.
`customfield delete <field>...`	Supprimer des champs.
`customfield set <field> <value>`	Définir une valeur au niveau de l'organisation.
`customfield clear <field>`	Effacer une valeur au niveau de l'organisation.
`device customfield ...`	Lister, définir ou effacer des valeurs au niveau de l'appareil.
`device group customfield ...`	Lister, définir ou effacer des valeurs de groupe d'appareils.

Les valeurs des champs personnalisés héritent de l'organisation vers le groupe d'appareils puis vers l'appareil. Les opérations de définition ou d'effacement en cascade peuvent écraser ou supprimer les valeurs des descendants.

Commandes d'appareils

Commande	Objectif
`device list`	Lister et filtrer les appareils.
`device get <device>`	Obtenir les détails d'un appareil.
`device restart <device>...`	Demander un redémarrage.
`device shutdown <device>...`	Demander un arrêt.
`device maintenance enable\|disable <device>...`	Changer le mode de maintenance.
`device update <device>`	Mettre à jour les propriétés modifiables d'un appareil.
`device delete <device>...`	Supprimer définitivement des appareils.
`device favorite\|unfavorite <device>...`	Changer le statut de favori.
`device flag\|unflag <device>...`	Changer le statut d'indicateur.
`device export`	Exporter des appareils au format CSV.
`device install-key`	Afficher une clé d'installation d'agent pour le provisionnement.
`device group ...`	Gérer les groupes d'appareils et les affectations.
`device customfield ...`	Gérer les valeurs de champs personnalisés des appareils.

Le redémarrage et l'arrêt demandent l'action immédiatement et n'attendent pas que l'appareil la termine.

⚠️ AVERTISSEMENT :device install-key affiche un identifiant de provisionnement sur la sortie standard. Évitez de l'exposer dans l'historique du shell, les terminaux partagés ou les journaux CI.

Commandes de fichiers

Commande	Objectif
`file list`	Lister les fichiers du référentiel.
`file get <file>`	Obtenir les métadonnées d'un fichier.
`file upload <path>...`	Téléverser des fichiers locaux.
`file download <file> [<dest>]`	Télécharger un fichier. Utiliser `-` comme destination pour la sortie standard.
`file rename <file> <filename>`	Renommer un fichier du référentiel.
`file replace <file> <path>`	Remplacer le contenu d'un fichier tout en préservant l'identifiant du fichier du référentiel.
`file delete <file>...`	Supprimer définitivement des fichiers.
`file storage`	Afficher l'utilisation du stockage.
`file group ...`	Gérer les groupes de fichiers du référentiel.

file download --overwrite peut remplacer un fichier local existant. Remplacer un fichier du référentiel modifie le contenu utilisé par les automatisations qui référencent cet identifiant de fichier.

Commandes de moniteurs

Commande	Objectif
`monitor list`	Lister les moniteurs à travers les politiques.
`monitor get <monitor>`	Obtenir un moniteur.
`monitor add <policy>`	Ajouter un moniteur à une politique à partir d'un contenu JSON.
`monitor update <monitor>`	Mettre à jour un moniteur avec un contenu JSON.
`monitor delete <monitor>...`	Supprimer des moniteurs.
`monitor enable\|disable <monitor>... --device <device>`	Remplacer les moniteurs pour un appareil.
`monitor policy list`	Lister les politiques de moniteur.
`monitor policy get <policy>`	Obtenir une politique.
`monitor policy create`	Créer une politique à partir d'indicateurs ou d'une spécification.
`monitor policy spec <policy>`	Exporter une spécification de politique.
`monitor policy apply -f <spec>`	Réconcilier une politique avec une spécification.
`monitor policy target\|untarget <policy>`	Gérer les étiquettes cibles.

Les commandes de contenu de moniteur acceptent --json ou --json-file. Exécuter lvl monitor add --help pour les types de moniteurs pris en charge.

L'application d'une politique de moniteur peut supprimer les moniteurs absents du fichier et n'est pas transactionnelle. Utiliser --dry-run en premier.

Commandes d'exécution

Commande	Objectif
`run list`	Lister les exécutions d'automatisation et de script.
`run get <run-id>`	Obtenir une exécution et ses étapes. Utiliser `--wait` pour interroger jusqu'à la fin.
`run cancel`	Annuler des exécutions par identifiant ou filtres.
`run rerun`	Démarrer de nouvelles exécutions à partir d'exécutions sélectionnées.
`run retry <run-id>...`	Relancer les exécutions échouées depuis l'étape en échec.
`run approve <run-id>...`	Approuver les exécutions en pause à une étape d'approbation.
`run deny <run-id>...`	Refuser et annuler les exécutions en pause à une étape d'approbation.
`run export`	Exporter des exécutions au format CSV.

L'attente est par défaut de 15 minutes et retourne jusqu'à 1 000 lignes de sortie par étape. Utiliser --wait-timeout et --output-lines pour modifier ces limites.

Un ERROR ou CANCELED le résultat quitte avec un code non nul. Un résultat WARNING le résultat est traité comme réussi.

Commandes de scripts

Commande	Objectif
`script list`	Lister les scripts enregistrés.
`script get <script>`	Obtenir un script enregistré. Utiliser `--raw` pour n'afficher que son corps.
`script create`	Créer un script à partir de `--file` ou `--command`.
`script update <script>`	Mettre à jour un script enregistré.
`script delete <script>...`	Supprimer des scripts.
`script run [<script>]`	Exécuter un script enregistré, un fichier ou une commande en ligne.
`script variable ...`	Gérer les variables de script.
`script group ...`	Gérer les groupes de scripts.

Une cible d'exécution peut provenir d'indicateurs --device indicateurs, --group, ou les deux. Les cibles dupliquées ne sont exécutées qu'une seule fois.

Un script enregistré utilise son shell, son délai d'expiration et son paramètre d'exécution stockés. Les exécutions de scripts ad hoc déduisent le shell à partir d'un indicateur explicite, de l'extension du fichier, du shebang ou du système d'exploitation cible.

⚠️ AVERTISSEMENT : La création de script et les exécutions de scripts ad hoc utilisent par défaut le paramètre SYSTEM paramètre d'exécution. Vérifiez le script et la liste des cibles avant l'exécution.

Commandes de compétences

Commande	Objectif
`skill show`	Afficher la `SKILL.md`.
`skill install`	Installer la compétence pour l'utilisateur actuel.
`skill install --project`	Installer la compétence dans le projet actuel.
`skill describe [<command>...]`	Afficher les indicateurs et les définitions de sortie JSON.

Réinstaller la compétence après la mise à niveau de lvl afin que les agents de codage reçoivent l'arbre de commandes actuel.

Commandes d'étiquettes

Commande	Objectif
`tag list`	Lister les étiquettes.
`tag get <tag>`	Obtenir une étiquette.
`tag create`	Créer une étiquette.
`tag update <tag>`	Mettre à jour une étiquette.
`tag delete <tag>...`	Supprimer les étiquettes inutilisées.
`tag assign <tag> --device <device>...`	Attribuer une étiquette à des appareils.
`tag unassign <tag> --device <device>...`	Retirer une étiquette d'appareils.

Commandes de mises à jour

Commande	Objectif
`update list`	Lister les mises à jour disponibles, installées ou toutes les mises à jour.
`update get <update-id>`	Obtenir une mise à jour.
`update check <device>...`	Demander une analyse des mises à jour.
`update install`	Installer les mises à jour sélectionnées.
`update retry`	Relancer les installations échouées sélectionnées.
`update install-all`	Installer les mises à jour disponibles sur les appareils sélectionnés.
`update log list\|get`	Examiner les enregistrements et journaux d'installation de mises à jour.
`update summary list`	Lister les résumés de mises à jour.
`update device list`	Lister les appareils dans le contexte de mise à jour.
`update exclusion list\|create\|update\|delete`	Gérer les exclusions KB globales.

L'installation de mises à jour, la nouvelle tentative et l'installation globale autorisent les redémarrages requis par défaut. Utiliser --no-reboot lorsque la commande sélectionnée ne doit pas redémarrer un appareil.

⚠️ AVERTISSEMENT : Vérifiez les sélections de mises à jour et d'appareils avant l'installation. Les opérations basées sur des filtres et sur tous les appareils nécessitent une confirmation explicite.

Commandes de groupes

Les groupes d'appareils, de scripts, d'automatisations et de fichiers partagent ces sous-commandes :

list
create
rename
move
delete
assign
unassign

Les listes de groupes récupèrent la hiérarchie complète. La suppression d'un groupe nécessite qu'il soit vide et sans groupes enfants.

Confirmation et travail asynchrone

Les commandes de suppression définitive prennent en charge --yes. Dans un terminal interactif, la CLI peut demander une confirmation. Dans une exécution non interactive, les commandes nécessitant une confirmation échouent sauf si --yes est fourni.

Certaines commandes reviennent après que Level a accepté la demande, avant que le travail ne soit terminé sur un appareil. Cela inclut les actions d'alimentation, les vérifications et installations de mises à jour, les scripts, les automatisations et les exécutions de déclencheurs. Utilisez l'historique des exécutions, run get --wait, les journaux de mises à jour ou l'application Web Level pour confirmer le résultat final.

Référence de la CLI Level