Utilice este artículo como mapa del árbol de comandos de la CLI de Level. Para conocer los indicadores exactos y la forma 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 cada entrada de referencia generada:

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:

El --profile indicador.
El LVL_PROFILE variable de entorno.
El perfil predeterminado guardado.
El prod perfil.

Comandos comunes:

Comando	Propósito
`lvl auth login`	Iniciar sesión mediante un flujo de aprobación basado en 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 los perfiles de servidor de API configurados.
`lvl profile create <name> <url>`	Añadir un perfil. Use `--default` para seleccionarlo inmediatamente.
`lvl profile use <profile>`	Establecer el perfil predeterminado.
`lvl profile delete <profile>`	Eliminar la configuración del perfil local y las credenciales.

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

Actualizaciones de la CLI

Las compilaciones de lanzamiento se mantienen actualizadas de forma predeterminada. Cuando ejecuta un lvl comando, la CLI aplica cualquier actualización firmada descubierta anteriormente y vuelve a ejecutar el comando con el nuevo binario. Si no hay ninguna actualización pendiente, busca una en segundo plano y puede aplicarla en la siguiente invocación. Los fallos de actualización automática no detienen el comando que solicitó lvl para ejecutar.

Comando	Propósito
`lvl self-update`	Buscar e instalar la última compilación publicada de inmediato. Esto funciona incluso cuando las actualizaciones automáticas están deshabilitadas.
`lvl self-update --check`	Informar si hay una actualización disponible sin instalarla.
`lvl self-update url`	Mostrar la URL de lanzamiento utilizada actualmente para las actualizaciones.
`lvl self-update url <url>`	Guardar una URL de lanzamiento personalizada en `~/.lvl/config.yaml`.
`lvl self-update url --reset`	Eliminar la URL personalizada y volver a la fuente de producción integrada.

Configure auto_update: false en ~/.lvl/config.yaml para deshabilitar las comprobaciones automáticas y las actualizaciones de inicio. Aún puede ejecutar lvl self-update manualmente.

Formatos de salida

La mayoría de los comandos muestran una tabla o resumen legible por humanos 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 utilizan el -o indicador para la especificación en sí.

Paginación

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

Indicador	Comportamiento
`--limit <count>`	Devolver 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 basada en 1.

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

Los comandos paginados incluyen listas de alerta, automatización, disparador de automatización, dispositivo, archivo, monitor, política de monitor, ejecución, script, etiqueta, actualización, resumen de actualización, dispositivo de actualización, registro de actualización y exclusión de actualización.

Las claves de API, los grupos, los campos personalizados, los perfiles y las variables utilizan listas no paginadas.

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 monitor	ID o nombre
Etiqueta	Nombre
Campo personalizado	Nombre o referencia generada
Exclusión de actualización	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 enumera los candidatos en lugar de elegir uno.

Comandos de alerta

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 clave 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 claves de API de forma permanente.

⚠️ 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 indicadores 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 las propiedades de la 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, añadir, actualizar, eliminar o ejecutar manualmente disparadores.
`automation action ...`	Añadir, actualizar o eliminar acciones.
`automation variable ...`	Gestionar variables de automatización.
`automation group ...`	Gestionar grupos de automatización.

Valores de estado:

automation list informa active cuando una automatización tiene al menos un disparador habilitado, manual cuando no tiene disparadores habilitados, y archived cuando está archivada.
automation trigger list informa active para un disparador habilitado y disabled para un disparador que no está habilitado.
La ejecución de la automatización está controlada por el estado del disparador. El enabled El valor no determina estos estados ni si los disparadores pueden iniciar ejecuciones.

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 compatibles con 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 aplicación

Use estos comandos para revisar el inventario de aplicaciones de toda la organización y profundizar en las versiones o instalaciones individuales.

Comando	Propósito
`app list`	Listar una fila agregada por nombre de aplicación, editor y plataforma. Admite paginación.
`app summary`	Mostrar los recuentos de aplicaciones e instalaciones, incluidos los recuentos de aplicaciones por plataforma, para el ámbito filtrado.
`app versions <app>`	Listar las versiones de una aplicación con los recuentos de instalaciones y dispositivos.
`app installs [<app>]`	Listar instalaciones individuales de una aplicación u omitir `<app>` y pase exactamente un `--device` para listar el inventario completo de aplicaciones de ese dispositivo. Admite paginación.
`app uninstall [<app>...]`	Enviar comandos de desinstalación para instalaciones de aplicaciones seleccionadas. Las referencias de aplicación posicionales son equivalentes a los indicadores repetibles `--app` indicadores.

Cargas de archivos

Cargar uno o más archivos locales en el repositorio de archivos de Level:

lvl file upload <path>...

De forma predeterminada, lvl utiliza el nombre de archivo local. Para elegir un nombre personalizado para un archivo, use --name sin una extensión:

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

La extensión del archivo siempre proviene del archivo local. El --name La opción se aplica solo a un único archivo.

Referencia de la CLI de Level