Ces recettes présentent les méthodes courantes d'utilisation de Level CLI depuis un terminal. Remplacez les exemples de noms tels que web-01, Laptops, et Disk cleanup avec des ressources de votre compte Level.

Démarrer la connexion via le navigateur :

Confirmer la session active :

La commande de connexion affiche un code à usage unique et une URL de vérification. Après avoir approuvé l'accès dans votre navigateur, la CLI enregistre la session pour le profil actif.

Rechercher des noms d'appareils et retourner chaque page correspondante :

Retourner les mêmes résultats au format JSON :

Utiliser le filtre jq intégré pour sélectionner des champs spécifiques :

--jq implique une sortie JSON. Les résultats sous forme de chaîne s'affichent en texte brut. Les objets et autres valeurs s'affichent en JSON compact, un résultat par ligne.

Exporter les appareils d'un groupe :

L'exportation écrit le CSV brut sur la sortie standard. Redirigez-la vers un fichier plutôt que d'ajouter -o json.

Vous pouvez utiliser le même modèle pour les alertes et les exécutions d'automatisation :

L'exemple suivant vérifie l'utilisation du système de fichiers sur un appareil Linux ou macOS :

Cette commande crée une exécution de script ad hoc. --wait interroge régulièrement jusqu'à la fin de l'exécution et inclut la sortie des étapes dans le résultat.

Si vous omettez --wait, la CLI retourne les identifiants d'exécution découverts. Vérifiez une exécution ultérieurement avec :

Si vous disposez déjà d'un script Bash vérifié dans os-info.sh, enregistrez-le dans Level :

Exécuter le script enregistré par son nom :

Remplacer les valeurs de variables enregistrées pour une seule exécution :

--variable est disponible uniquement lorsque vous exécutez un script enregistré. Répétez --variable <name>=<value> pour chaque remplacement. Vous pouvez identifier une variable par son nom, son identifiant ou {{reference}}. Les variables que vous ne spécifiez pas utilisent leurs valeurs par défaut enregistrées. Chaque valeur est conservée exactement telle quelle, y compris une valeur vide, les virgules et les = signes.

Un script enregistré conserve son interpréteur de commandes configuré, son délai d'expiration et son paramètre d'exécution. Lorsque vous exécutez un script enregistré par nom ou par identifiant, n'ajoutez pas de remplacements pour l'interpréteur de commandes ou le paramètre d'exécution.

Utilisez un identifiant de script lorsque plusieurs scripts portent le même nom.

Exporter une automatisation existante au format YAML :

Par défaut, les références à d'autres enregistrements utilisent des identifiants, afin de continuer à identifier les mêmes enregistrements après un renommage. Pour rendre les références de ressources prises en charge plus faciles à lire ou à modifier, ajoutez --names:

La CLI utilise un nom d'affichage uniquement s'il est résolu vers le même enregistrement. Si le nom est manquant, ambigu ou résolu vers un enregistrement différent, l'identifiant reste dans l'exportation.

Tous les identifiants ne sont pas remplacés. Les références aux actions et variables locales à l'automatisation peuvent rester des identifiants. Utilisez cette recette pour examiner ou mettre à jour l'automatisation existante, et non comme recette complète de clonage ou de migration inter-comptes.

Prévisualiser comment cette spécification modifierait l'automatisation en cours :

Une simulation à blanc affiche les modifications planifiées sans les appliquer.

Après avoir examiné le fichier et le résultat de la simulation, appliquez-le avec :

Lister les politiques de surveillance :

Obtenir une politique par identifiant ou par nom :

Exporter sa spécification :

L'exportation par défaut utilise des identifiants pour les références à d'autres enregistrements, préservant ainsi les mêmes cibles après un renommage. Pour utiliser des noms lisibles pour les références prises en charge à la place, ajoutez --names:

Un nom n'est utilisé que s'il est résolu vers le même enregistrement. Les noms manquants ou ambigus, ou les noms résolus vers un enregistrement différent, laissent l'identifiant inchangé ; ainsi, une exportation nommée peut encore contenir des identifiants.

Prévisualiser une spécification avant de l'appliquer :

Comme pour l'application d'une automatisation, l'application d'une politique de surveillance reconcilie la ressource en cours et n'est pas transactionnelle.

Les références d'appareils peuvent utiliser un identifiant, un nom d'hôte, un nom, un surnom ou un nom d'hôte qualifié par groupe :

Les références qualifiées par groupe sont utiles lorsque différents groupes d'appareils contiennent le même nom d'hôte. Si une référence est toujours ambiguë, la CLI s'arrête et liste les correspondances au lieu d'en choisir une.

Afficher l'aide normale d'une commande :

Afficher la référence générée, y compris le format de sortie JSON :

Afficher toutes les commandes d'un groupe :

La CLI installée est la source de vérité pour ses options et définitions de sortie actuelles.

Avant d'exécuter une commande qui modifie Level ou un appareil géré :

Les commandes de suppression définitive nécessitent une confirmation dans un terminal interactif et requièrent --yes lors d'une exécution non interactive. Certaines commandes, notamment le redémarrage et l'arrêt des appareils, déclenchent l'action immédiatement sans invite de confirmation.