Utilice este artículo como mapa del árbol de comandos de la CLI de Level. Para obtener las opciones exactas y la estructura de salida JSON de su versión instalada, use la ayuda normal o la referencia de habilidades generada:

lvl --help
lvl skill describe

Por ejemplo:

lvl device list --help
lvl skill describe device list

Sintaxis de comandos

La forma general es:

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

Mostrar la lista de comandos de nivel superior:

lvl --help

Mostrar todas las entradas de referencia generadas:

lvl skill describe

Perfiles y autenticación

La CLI de Level incluye un prod perfil para https://api.level.io.

La selección de perfil sigue este orden:

La raíz --profile bandera.
La LVL_PROFILE variable de entorno.
El perfil predeterminado guardado.
El integrado prod perfil.

Comandos comunes:

Comando	Propósito
`lvl auth login`	Iniciar sesión mediante un flujo de aprobación basado en el navegador.
`lvl auth status`	Verificar la sesión activa y la organización.
`lvl auth logout`	Revocar la sesión activa y eliminar las credenciales locales.
`lvl profile list`	Listar perfiles del servidor de API configurados.
`lvl profile create <name> <url>`	Agregar un perfil. Use `--default` para seleccionarlo de inmediato.
`lvl profile use <profile>`	Establecer el perfil predeterminado.
`lvl profile delete <profile>`	Eliminar la configuración y las credenciales del perfil local.

⚠️ ADVERTENCIA: Eliminar un perfil no revoca su sesión del lado del servidor. Ejecute lvl --profile <profile> auth logout antes de eliminarlo.

Formatos de salida

La mayoría de los comandos muestran una tabla legible o un resumen de forma predeterminada.

Usar salida JSON:

lvl device list -o json

Usar el filtro jq integrado:

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

--jq implica JSON. No se puede combinar con salida de tabla explícita.

Los comandos de exportación CSV escriben CSV sin procesar en la salida estándar:

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

Los comandos de especificación de automatización y política de monitores usan --format yaml|json, con YAML como valor predeterminado. No usan la -o bandera para la especificación en sí.

Paginación

La mayoría de los comandos de lista de recursos admiten:

Bandera	Comportamiento
`--limit <count>`	Devuelve hasta el número de registros solicitado. El valor predeterminado es 100.
`--limit all`	Obtener todas las páginas de resultados.
`--page <number>`	Devolver una página con base 1.

--limit all no se puede combinar con --page.

Los comandos paginados incluyen listas de alert, automation, automation-trigger, device, file, monitor, monitor-policy, run, script, tag, update, update-summary, update-device, update-log y update-exclusion.

Las claves de API, grupos, campos personalizados, perfiles y variables usan listas sin paginar.

En la salida de lista JSON, count es el número total de registros del servidor que coinciden, no el número devuelto en la página actual.

Referencias de recursos

Muchos comandos aceptan un ID o una referencia legible por humanos. Una coincidencia exacta de ID tiene prioridad. La coincidencia por nombre y alias no distingue entre mayúsculas y minúsculas.

Las formas comunes incluyen:

Recurso	Referencias aceptadas
Dispositivo	ID, nombre de host, nombre, apodo o `<group>/<hostname>`
Grupo de dispositivos	ID, nombre o ruta anidada como `Ops/Maintenance`
Automatización	ID o nombre
Script	ID o nombre
Archivo del repositorio	ID o nombre de archivo, con o sin su extensión
Política de monitores	ID o nombre
Etiqueta	Nombre
Campo personalizado	Nombre o referencia generada
Exclusión de actualizaciones	ID o número de KB, con o sin el `KB` prefijo

Si una referencia coincide con más de un recurso, la CLI se detiene y lista los candidatos en lugar de elegir uno.

Comandos de alertas

Comando	Propósito
`alert list`	Listar alertas activas, resueltas o todas.
`alert get <alert-id>`	Obtener una alerta.
`alert resolve`	Resolver alertas por ID o filtros.
`alert unresolve <alert-id>...`	Reabrir alertas resueltas por ID.
`alert export`	Exportar alertas coincidentes como CSV.

Comandos de claves de API

Comando	Propósito
`apikey list`	Listar claves de API.
`apikey get <api-key>`	Obtener una clave de API. Use `--reveal` para mostrar el token completo en la salida de tabla.
`apikey create`	Crear una clave de API de solo lectura o de lectura y escritura.
`apikey update <api-key>`	Actualizar una clave de API.
`apikey delete <api-key>...`	Eliminar permanentemente claves de API.

⚠️ ADVERTENCIA: La salida JSON de la clave de API contiene el token completo. Proteja la salida del terminal, los archivos exportados y los registros de CI.

Comandos de automatización

Comando	Propósito
`automation list`	Listar automatizaciones.
`automation get <automation>`	Obtener una automatización.
`automation create`	Crear una automatización a partir de banderas o un archivo de especificación.
`automation spec <automation>`	Exportar una especificación de automatización.
`automation apply -f <spec>`	Reconciliar una automatización existente con una especificación.
`automation update <automation>`	Actualizar propiedades de automatización.
`automation delete <automation>...`	Archivar automatizaciones.
`automation restore <automation>...`	Restaurar automatizaciones archivadas.
`automation run <automation>`	Ejecutar una automatización en dispositivos o grupos.
`automation trigger ...`	Listar, agregar, actualizar, eliminar o ejecutar manualmente disparadores.
`automation action ...`	Agregar, actualizar o eliminar acciones.
`automation variable ...`	Gestionar variables de automatización.
`automation group ...`	Gestionar grupos de automatización.

Los comandos de mutación de disparadores y acciones aceptan --json o --json-file. El payload debe contener exactamente un tipo compatible, y los campos desconocidos son rechazados.

Ejecute lvl automation action --help o lvl skill describe automation action para los tipos de acción admitidos por su versión instalada.

⚠️ ADVERTENCIA:automation apply puede eliminar disparadores y acciones que están ausentes de la especificación. La aplicación no es transaccional. Ejecute con --dry-run y revise el plan primero.

Comandos de campos personalizados

Comando	Propósito
`customfield list`	Listar campos personalizados de la organización.
`customfield get <field>`	Obtener un campo personalizado.
`customfield create`	Crear un campo.
`customfield update <field>`	Actualizar un campo.
`customfield delete <field>...`	Eliminar campos.
`customfield set <field> <value>`	Establecer un valor a nivel de organización.
`customfield clear <field>`	Borrar un valor a nivel de organización.
`device customfield ...`	Listar, establecer o borrar valores a nivel de dispositivo.
`device group customfield ...`	Listar, establecer o borrar valores de grupo de dispositivos.

Los valores de campos personalizados se heredan de la organización al grupo de dispositivos y luego al dispositivo. Las operaciones de establecimiento o borrado en cascada pueden sobrescribir o eliminar valores de descendientes.

Comandos de dispositivos

Comando	Propósito
`device list`	Listar y filtrar dispositivos.
`device get <device>`	Obtener detalles del dispositivo.
`device restart <device>...`	Solicitar un reinicio.
`device shutdown <device>...`	Solicitar un apagado.
`device maintenance enable\|disable <device>...`	Cambiar el modo de mantenimiento.
`device update <device>`	Actualizar propiedades editables del dispositivo.
`device delete <device>...`	Eliminar permanentemente dispositivos.
`device favorite\|unfavorite <device>...`	Cambiar el estado de favorito.
`device flag\|unflag <device>...`	Cambiar el estado de marcador.
`device export`	Exportar dispositivos como CSV.
`device install-key`	Imprimir una clave de instalación del agente para el aprovisionamiento.
`device group ...`	Gestionar grupos de dispositivos y asignaciones.
`device customfield ...`	Gestionar valores de campos personalizados del dispositivo.

El reinicio y el apagado solicitan la acción de inmediato y no esperan a que el dispositivo la complete.

⚠️ ADVERTENCIA:device install-key imprime una credencial de aprovisionamiento en la salida estándar. Evite exponerla en el historial del shell, terminales compartidas o registros de CI.

Comandos de archivos

Comando	Propósito
`file list`	Listar archivos del repositorio.
`file get <file>`	Obtener metadatos de archivos.
`file upload <path>...`	Cargar archivos locales.
`file download <file> [<dest>]`	Descargar un archivo. Use `-` como destino para la salida estándar.
`file rename <file> <filename>`	Renombrar un archivo del repositorio.
`file replace <file> <path>`	Reemplazar el contenido del archivo conservando el ID del archivo del repositorio.
`file delete <file>...`	Eliminar permanentemente archivos.
`file storage`	Mostrar el uso del almacenamiento.
`file group ...`	Gestionar grupos de archivos del repositorio.

file download --overwrite puede reemplazar un archivo local existente. Reemplazar un archivo del repositorio cambia el contenido utilizado por las automatizaciones que hacen referencia a ese ID de archivo.

Comandos de monitores

Comando	Propósito
`monitor list`	Listar monitores en todas las políticas.
`monitor get <monitor>`	Obtener un monitor.
`monitor add <policy>`	Agregar un monitor a una política a partir de un payload JSON.
`monitor update <monitor>`	Actualizar un monitor con un payload JSON.
`monitor delete <monitor>...`	Eliminar monitores.
`monitor enable\|disable <monitor>... --device <device>`	Anular monitores para un dispositivo.
`monitor policy list`	Listar políticas de monitores.
`monitor policy get <policy>`	Obtener una política.
`monitor policy create`	Crear una política a partir de banderas o una especificación.
`monitor policy spec <policy>`	Exportar una especificación de política.
`monitor policy apply -f <spec>`	Reconciliar una política con una especificación.
`monitor policy target\|untarget <policy>`	Gestionar etiquetas de destino.

Los comandos de payload de monitores aceptan --json o --json-file. Ejecute lvl monitor add --help para los tipos de monitor admitidos.

La aplicación de política de monitores puede eliminar monitores ausentes del archivo y no es transaccional. Use --dry-run primero.

Comandos de ejecuciones

Comando	Propósito
`run list`	Listar ejecuciones de automatizaciones y scripts.
`run get <run-id>`	Obtener una ejecución y sus pasos. Use `--wait` para sondear hasta la finalización.
`run cancel`	Cancelar ejecuciones por ID o filtros.
`run rerun`	Iniciar nuevas ejecuciones a partir de ejecuciones seleccionadas.
`run retry <run-id>...`	Reintentar ejecuciones fallidas desde el paso fallido.
`run approve <run-id>...`	Aprobar ejecuciones pausadas en un paso de aprobación.
`run deny <run-id>...`	Denegar y cancelar ejecuciones pausadas en un paso de aprobación.
`run export`	Exportar ejecuciones como CSV.

La espera tiene un valor predeterminado de 15 minutos y devuelve hasta 1.000 líneas de salida por paso. Use --wait-timeout y --output-lines para cambiar esos límites.

Un ERROR o CANCELED el resultado sale con código distinto de cero. Un resultado WARNING el resultado se trata como exitoso.

Comandos de scripts

Comando	Propósito
`script list`	Listar scripts guardados.
`script get <script>`	Obtener un script guardado. Use `--raw` para imprimir solo su cuerpo.
`script create`	Crear un script desde `--file` o `--command`.
`script update <script>`	Actualizar un script guardado.
`script delete <script>...`	Eliminar scripts.
`script run [<script>]`	Ejecutar un script guardado, un archivo o un comando en línea.
`script variable ...`	Gestionar variables de scripts.
`script group ...`	Gestionar grupos de scripts.

El destino de ejecución puede provenir de banderas repetidas de --device banderas, --group, o ambos. Los destinos duplicados se ejecutan una vez.

Un script guardado usa su shell almacenado, tiempo de espera y configuración de ejecución como. Las ejecuciones de scripts ad-hoc infieren el shell a partir de una bandera explícita, extensión de archivo, shebang o sistema operativo de destino.

⚠️ ADVERTENCIA: La creación de scripts y las ejecuciones de scripts ad-hoc utilizan de forma predeterminada la configuración SYSTEM configuración de ejecución como. Revise el script y la lista de destinos antes de la ejecución.

Comandos de habilidades

Comando	Propósito
`skill show`	Imprimir la `SKILL.md`.
`skill install`	Instalar la habilidad para el usuario actual.
`skill install --project`	Instalar la habilidad en el proyecto actual.
`skill describe [<command>...]`	Imprimir banderas y definiciones de salida JSON.

Reinstalar la habilidad después de actualizar lvl para que los agentes de codificación reciban el árbol de comandos actual.

Comandos de etiquetas

Comando	Propósito
`tag list`	Listar etiquetas.
`tag get <tag>`	Obtener una etiqueta.
`tag create`	Crear una etiqueta.
`tag update <tag>`	Actualizar una etiqueta.
`tag delete <tag>...`	Eliminar etiquetas no utilizadas.
`tag assign <tag> --device <device>...`	Asignar una etiqueta a dispositivos.
`tag unassign <tag> --device <device>...`	Eliminar una etiqueta de dispositivos.

Comandos de actualizaciones

Comando	Propósito
`update list`	Listar actualizaciones disponibles, instaladas o todas.
`update get <update-id>`	Obtener una actualización.
`update check <device>...`	Solicitar un análisis de actualizaciones.
`update install`	Instalar actualizaciones seleccionadas.
`update retry`	Reintentar instalaciones fallidas seleccionadas.
`update install-all`	Instalar actualizaciones disponibles en dispositivos seleccionados.
`update log list\|get`	Revisar registros e historial de instalación de actualizaciones.
`update summary list`	Listar resúmenes de actualizaciones.
`update device list`	Listar dispositivos en contexto de actualización.
`update exclusion list\|create\|update\|delete`	Gestionar exclusiones globales de KB.

La instalación de actualizaciones, el reintento y la instalación de todas permiten reinicios requeridos de forma predeterminada. Use --no-reboot cuando el comando seleccionado no debe reiniciar un dispositivo.

⚠️ ADVERTENCIA: Revise las selecciones de actualizaciones y dispositivos antes de la instalación. Las operaciones basadas en filtros y de todos los dispositivos requieren confirmación explícita.

Comandos de grupos

Los grupos de dispositivos, scripts, automatizaciones y archivos comparten estos subcomandos:

list
create
rename
move
delete
assign
unassign

Las listas de grupos obtienen la jerarquía completa. Eliminar un grupo requiere que esté vacío y no tenga grupos secundarios.

Confirmación y trabajo asíncrono

Los comandos de eliminación permanente admiten --yes. En un terminal interactivo, la CLI puede solicitar confirmación. En ejecuciones no interactivas, los comandos que requieren confirmación fallan a menos que --yes está presente.

Algunos comandos regresan después de que Level acepta la solicitud, antes de que el trabajo finalice en un dispositivo. Esto incluye acciones de energía, comprobaciones e instalaciones de actualizaciones, scripts, automatizaciones y ejecuciones de disparadores. Use el historial de ejecuciones, run get --wait, registros de actualizaciones o la aplicación web de Level para confirmar el resultado final.

Referencia de la CLI de Level