Diccionario de Errores API
Este documento contiene el registro oficial de códigos de error retornados por la API REST y el motor transaccional de SentinelOS.
Nomenclatura
Todos los errores siguen un formato estructurado: ERR_[CATEGORIA]_[TIPO][ID]
- 1: Errores de sintaxis, formato o bad request.
- 2: Lógica de red, semántica o errores de validación de conflictos.
- 3: Estado, sesión o errores del motor transaccional.
- 4: Errores a nivel de SO, hardware o kernel.
- 5: Errores de seguridad, autenticación o permisos.
Invalid IP or CIDR format
La dirección IP enviada en el JSON no cumple con el estándar de parseo de red.
192.168.1.999/24Resource not found
El recurso solicitado no existe en la config
Missing required field
La petición no incluye un campo obligatorio para crear el recurso.
zone name is requiredInterface acts as parent for VLANs and cannot have IP
Intento de asignar una IP de Capa 3 a una interfaz física que actualmente opera en Capa 2 como troncal de VLANs.
enp0s8Parent interface cannot be down while child VLAN is up
Conflicto de estado administrativo. Una interfaz no puede apagarse si sus subinterfaces están encendidas.
parent: enp0s8, vlan: vlan10Resource references unknown entity
El recurso intenta vincularse a otro que no existe en la candidate config actual.
unknown zone: LANInvalid JSON payload
El cuerpo de la peticion tiene un formato JSON invalido o con tipos incorrectos.
Duplicate IP address detected
Se detecto la misma IP asignada a mas de una interfaz fisica o virtual.
Vlan references unknown parent interface
La vlan intenta anclarse a una interfaz fisica que no existe.
Invalid zone type
El tipo de zona enviado no es reconocido por el sistema.
Use l2 or l3Resource already exists
Intento de crear un recurso con un identificador (nombre o ID) que ya está en uso en la configuración candidata.
zone LAN already existsInvalid protocol
El protocolo especificado no es válido. Solo se permite tcp o udp.
protocol: icmpInvalid subnet mask
La máscara de red proporcionada no es válida para el formato IPv4.
invalid mask in address LAN_NETInvalid port number
El puerto especificado está fuera del rango válido (1-65535) o es <= 0.
invalid port in service HTTPMethod not allowed
Se intentó acceder a un endpoint con un verbo HTTP incorrecto.
Invalid NAT action
La acción enviada no está soportada. Solo se permite masquerade, snat o dnat.
action: dropInvalid policy action
La acción de la política no es reconocida. Solo se permite allow o deny.
action: bypassMissing authorization token
La petición no incluye el header de Authorization con el token JWT.
Invalid token format
El header de Authorization no cumple con el esquema 'Bearer <token>'.
expected Bearer tokenInvalid or expired token
El token JWT no superó la validación criptográfica o su tiempo de vida expiró.
token is expired by 10mUser account disabled
Intento de login de un usuario que existe pero tiene la bandera Enabled en false.
Invalid credentials
Las credenciales no coinciden o el usuario no existe en la base de datos local.
Invalid policy reference
La política hace referencia a un objeto nulo o inválido en la memoria.
policy has nil serviceFailed to generate token
Error interno del servidor al intentar firmar criptográficamente el JWT.
No active config session
Intento de editar recursos o hacer commit sin haber iniciado sesión con /api/config/begin primero.
Config already locked by another user
Intento de iniciar una sesión de configuración cuando otro administrador ya tiene el candado.
owner: adminInternal server error
Fallo generico del sistema, lectura de kernel o bd.
Failed to apply runtime configuration
En engine fallo al intentar aplicar la configuracion al sistema operativo.
Failed to create config backup
Error al clonar la configuracion para el rollback.