--- title: "Posibles errores en las ejecuciones de comandos" url: https://docs.catalyst.zoho.com/es/cli/v1/context-sensitive-help/possible-errors/ description: "Catalyst proporciona ayuda contextual cuando encuentras un error durante la ejecución de un comando del CLI." last_updated: 2026-08-06T05:54:02Z service: All Services type: general --- # Lista de posibles errores en las ejecuciones de comandos A continuación se presentan algunos posibles errores comunes que podrías encontrar en tu CLI durante las ejecuciones de comandos, y las acciones que puedes tomar para resolverlos:
| Comando/Componente | Errores | Soluciones |
|---|---|---|
| Autenticación | Contenedor de tokens vacío | [Genera un nuevo token](https://docs.catalyst.zoho.com/es/cli/v1/working-with-tokens/generate-token/) |
| Error al recuperar el token | [Usa un token válido de la lista](https://docs.catalyst.zoho.com/es/cli/v1/working-with-tokens/list-tokens/) | |
| Sesión cerrada del CLI | [Inicia sesión en el CLI](https://docs.catalyst.zoho.com/es/cli/v1/login/login-from-cli/) | |
| Error al recuperar el Refresh Token o Access Token | [Inicia sesión en el CLI usando `--no-localhost`](https://docs.catalyst.zoho.com/es/cli/v1/login/options) | |
| Error al generar el token | [Genera un nuevo token](https://docs.catalyst.zoho.com/es/cli/v1/working-with-tokens/generate-token/) | |
| Token inválido proporcionado con la opción `--token` | [Proporciona un token válido con la opción](https://docs.catalyst.zoho.com/es/cli/v1/cli-options/#--token-lttokengt) | |
| Error de autenticación | [Vuelve a iniciar sesión con la opción `--force`](https://docs.catalyst.zoho.com/es/cli/v1/login/options/#--force) | |
| Centro de datos | Entrada inválida para la opción `--dc` | [Especifica una entrada válida e intenta de nuevo](https://docs.catalyst.zoho.com/es/cli/v1/cli-options/#--dcuseuin) |
| Proyecto | Primer proyecto de Catalyst no creado | [Crea un nuevo proyecto](https://docs.catalyst.zoho.com/es/getting-started/catalyst-projects/) |
| Proyecto proporcionado con la opción `-p` no encontrado | [Selecciona un proyecto existente de la lista](https://docs.catalyst.zoho.com/es/cli/v1/cli-options/#-p----project-name_or_project_id) | |
| Archivo faltante en el directorio del proyecto | [Inicializa el proyecto](https://docs.catalyst.zoho.com/es/cli/v1/initialize-resources/introduction/) o configura el [componente faltante](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/introduction/) | |
| Recurso no encontrado en el directorio del proyecto | [Inicializa el proyecto](https://docs.catalyst.zoho.com/es/cli/v1/initialize-resources/introduction/) o configura el [componente faltante](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/introduction/) | |
| Proyecto no encontrado en la consola remota | [Usa un proyecto disponible de la lista](https://docs.catalyst.zoho.com/es/cli/v1/working-with-projects/use-catalyst-project/) | |
| Archivo corrupto en el directorio del proyecto | Elimina el archivo corrupto e [inicializa el proyecto de nuevo](https://docs.catalyst.zoho.com/es/cli/v1/initialize-resources/initialize-options/) | |
| Proyecto activo no encontrado en la consola remota | [Cambia el proyecto activo existente a uno disponible](https://docs.catalyst.zoho.com/es/cli/v1/working-with-projects/use-catalyst-project/) | |
| API Gateway | Error al habilitar APIG: Programador de APIG en progreso | [Verifica el estado del trabajo programado](https://docs.catalyst.zoho.com/es/cli/v1/working-with-api-gateway/obtain-api-gateway-status/) e intenta de nuevo después de un momento |
| Informes de APIG no encontrados | [Despliega las reglas de APIG desde el CLI](https://docs.catalyst.zoho.com/es/cli/v1/deploy-resources/deploy-api-gateway/) | |
| Error al deshabilitar APIG: Programador de APIG en progreso | [Verifica el estado del trabajo programado](https://docs.catalyst.zoho.com/es/cli/v1/working-with-api-gateway/obtain-api-gateway-status/) e intenta de nuevo después de un momento | |
| No se puede leer el archivo de reglas de APIG | Rectifica los errores especificados e intenta de nuevo | |
| Archivo de reglas de APIG faltante | [Crea el archivo faltante o especifica un nombre de archivo válido](https://docs.catalyst.zoho.com/es/cli/v1/working-with-api-gateway/api-gateway-json-file/) | |
| Nombre faltante en la regla de APIG | [Proporciona un nombre para la regla de APIG](https://docs.catalyst.zoho.com/es/cli/v1/working-with-api-gateway/api-gateway-json-file/) | |
| Nombre duplicado en la regla de APIG | [Cambia el nombre o elimina la regla de APIG](https://docs.catalyst.zoho.com/es/cli/v1/working-with-api-gateway/api-gateway-json-file/) | |
| Valores obligatorios faltantes en la regla de APIG | [Agrega los valores obligatorios especificados a la regla de APIG](https://docs.catalyst.zoho.com/es/cloud-scale/help/api-gateway/key-concepts/#routing) | |
| Valores duplicados en la regla de APIG | [Modifica la regla de APIG y resuelve el conflicto](https://docs.catalyst.zoho.com/es/cloud-scale/help/api-gateway/key-concepts/#routing) | |
| Client inválido especificado en la regla de APIG | Rectifica los errores especificados en el Client e intenta de nuevo | |
| No se puede autenticar la regla de APIG con destino Client | [Elimina la clave especificada de la regla de APIG](https://docs.catalyst.zoho.com/es/cloud-scale/help/api-gateway/key-concepts/#authentication-request-processor) | |
| RegEx inválida en la regla de APIG | [Rectifica el error de RegEx especificado](https://docs.catalyst.zoho.com/es/cloud-scale/help/api-gateway/key-concepts/#routing) | |
| Parámetros inválidos en la regla de APIG | [Rectifica el error especificado para continuar](https://docs.catalyst.zoho.com/es/cloud-scale/help/api-gateway/key-concepts/#routing) | |
| URL de solicitud o destino inválida en la regla de APIG | [Proporciona una URL de destino válida en la regla de APIG](https://docs.catalyst.zoho.com/es/cloud-scale/help/api-gateway/key-concepts/#routing) | |
| Data Store | Identificador de tabla faltante en la operación de exportación/importación | [Proporciona el identificador de tabla en el comando o archivo de configuración](https://docs.catalyst.zoho.com/es/cli/v1/data-store-import-and-export/introduction/) |
| Archivo fuente faltante en la operación de importación | [Proporciona la ruta del archivo CSV en la máquina local con el comando](https://docs.catalyst.zoho.com/es/cli/v1/data-store-import-and-export/import-operation/#input-csv-file) | |
| Client | Client web no encontrado en la máquina local | [Crea un nuevo Client web](https://docs.catalyst.zoho.com/es/cli/v1/working-with-the-client/set-up-client/) |
| Client web no encontrado en la consola remota | [Despliega un Client web desde el CLI](https://docs.catalyst.zoho.com/es/cli/v1/deploy-resources/deploy-client/) | |
| Versión del Client web no encontrada en la máquina local/consola remota para eliminar | [Elimina una versión de la lista de versiones disponibles](https://docs.catalyst.zoho.com/es/cli/v1/working-with-the-client/delete-client/) | |
| La versión del Client web está en producción y no se puede eliminar | [Cambia la versión en producción a una diferente](https://docs.catalyst.zoho.com/es/cloud-scale/help/web-client-hosting/implementation/#deploy-an-older-version-of-a-web-application) o [despliega una nueva versión del Client web](https://docs.catalyst.zoho.com/es/cli/v1/deploy-resources/deploy-client/) | |
| No se pueden usar las opciones `--local` y `--remote` simultáneamente para eliminar | [Usa solo una de las opciones a la vez](https://docs.catalyst.zoho.com/es/cli/v1/working-with-the-client/delete-client/#delete-client-options) | |
| No se puede analizar el archivo del Client | Rectifica el error especificado e intenta de nuevo | |
| Archivo faltante en el directorio del Client | [Crea el archivo especificado en el directorio fuente del Client](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/client-directory/) | |
| Archivo corrupto en el directorio del Client | [Rectifica el error especificado o proporciona destinos válidos](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/client-directory/) | |
| Functions | No hay Functions en la consola remota para configurar o usar la funcionalidad | [Crea una nueva función en la consola](https://docs.catalyst.zoho.com/es/serverless/help/functions/implementation/) o [despliega una función en la consola](https://docs.catalyst.zoho.com/es/cli/v1/deploy-resources/deploy-functions/) |
| Valor inválido con la opción `--memory` al configurar | [Proporciona un número válido con la opción](https://docs.catalyst.zoho.com/es/cli/v1/working-with-functions/configure-function-memory/) | |
| Función no encontrada en la máquina local para eliminar | [Selecciona una función disponible de la lista para eliminar](https://docs.catalyst.zoho.com/es/cli/v1/working-with-functions/delete-functions/) | |
| No hay Functions en la máquina local para eliminar | [Crea una nueva función en el directorio del proyecto](https://docs.catalyst.zoho.com/es/cli/v1/working-with-functions/add-functions/) | |
| Función no encontrada en la consola remota para eliminar | [Selecciona una función disponible de la lista para eliminar](https://docs.catalyst.zoho.com/es/cli/v1/working-with-functions/delete-functions/) | |
| No hay Functions en la consola remota para eliminar | [Crea una nueva función en la consola](https://docs.catalyst.zoho.com/es/cli/v1/working-with-functions/add-functions/) o [despliega una función en la consola](https://docs.catalyst.zoho.com/es/cli/v1/deploy-resources/deploy-functions/) | |
| No se puede usar el ID de función en la máquina local para eliminar | [Usa el nombre de la función o ejecuta el comando sin especificar identificadores de función](https://docs.catalyst.zoho.com/es/cli/v1/working-with-functions/delete-functions/) | |
| No se pueden usar las opciones `--local` y `--remote` simultáneamente para eliminar | [Usa solo una de las opciones a la vez](https://docs.catalyst.zoho.com/es/cli/v1/working-with-functions/delete-functions/#delete-functions-options) | |
| Archivos de configuración | Functions especificadas en el archivo de configuración no encontradas | [Especifica nombres de función válidos bajo la clave `functions`](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/catalyst-json/) |
| Client especificado en el archivo de configuración no encontrado | [Especifica un directorio fuente de Client válido bajo la clave `client`](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/catalyst-json/) | |
| Directorio especificado en el archivo de configuración no encontrado | [Especifica un nombre de directorio válido que esté disponible en el directorio del proyecto](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/introduction/) | |
| Destinos inválidos en el archivo de configuración | [Especifica valores válidos como `targets` en el archivo de configuración](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/catalyst-json/) | |
| Archivo faltante en el directorio raíz del proyecto | [Inicializa el proyecto de nuevo](https://docs.catalyst.zoho.com/es/cli/v1/initialize-resources/introduction/) | |
| Scripts | Comando de script inválido | [Especifica el comando en un formato válido](https://docs.catalyst.zoho.com/es/cli/v1/scripts/introduction/) |
| Funcionalidad especificada inválida | [Especifica una funcionalidad válida para ejecutar el script](https://docs.catalyst.zoho.com/es/cli/v1/scripts/run-script/) | |
| Script no disponible en el archivo | [Ejecuta un script disponible](https://docs.catalyst.zoho.com/es/cli/v1/scripts/run-script/) | |
| El script finalizó con error | [Rectifica el error e intenta de nuevo](https://docs.catalyst.zoho.com/es/cli/v1/scripts/run-script/) | |
| Generación de eventos | Opciones proporcionadas no están en pares | [Proporciona las opciones como pares en el formato correcto](https://docs.catalyst.zoho.com/es/cli/v1/event-generate/introduction/) |
| Fuente inválida | [Proporciona una fuente disponible](https://docs.catalyst.zoho.com/es/cli/v1/event-generate/introduction/) | |
| Opciones en formato inválido | [Proporciona las opciones en un formato válido](https://docs.catalyst.zoho.com/es/cli/v1/event-generate/introduction/) | |
| Nombre del Event Bus faltante en evento personalizado | [Proporciona el nombre del Event Bus](https://docs.catalyst.zoho.com/es/cli/v1/event-generate/sample-payload-custom-event/) | |
| Identificador de regla faltante en evento personalizado | [Proporciona el identificador de regla](https://docs.catalyst.zoho.com/es/cli/v1/event-generate/sample-payload-custom-event/) | |
| Event Bus no encontrado en la consola remota | [Proporciona un nombre de Event Bus disponible](https://docs.catalyst.zoho.com/es/cli/v1/event-generate/sample-payload-custom-event/) | |
| Acción no compatible con la fuente | [Proporciona una acción compatible con la fuente](https://docs.catalyst.zoho.com/es/cli/v1/event-generate/introduction/) | |
| Identificador de segmento/tabla/carpeta incorrecto | [Proporciona un identificador válido con la opción](https://docs.catalyst.zoho.com/es/cli/v1/event-generate/sample-payload-component-event/) | |
| Generación de eventos: funciones de integración | Valor de entrada incorrecto para evento de integración con Cliq | [Proporciona la entrada en el formato correcto](https://docs.catalyst.zoho.com/es/cli/v1/event-generate/sample-payload-integration-functions/) |
| Combinación desconocida de componente Cliq | [Elige la combinación apropiada de componentes Cliq de la lista](https://docs.catalyst.zoho.com/es/cli/v1/event-generate/sample-payload-integration-functions/) | |
| Servicio de integración no disponible | [Proporciona un servicio de integración disponible](https://docs.catalyst.zoho.com/es/cli/v1/event-generate/sample-payload-integration-functions/) | |
| Pull | Valor inválido con el comando | [Proporciona los valores `client`, `functions` o `apig` con el comando](https://docs.catalyst.zoho.com/es/cli/v1/pull-resources/pull-all-resources/) |
| Serve | No hay componentes válidos para servir | [Rectifica los errores e intenta de nuevo](https://docs.catalyst.zoho.com/es/cli/v1/serve-resources/introduction/) |
| Puertos en el rango indicado no disponibles | [Especifica un puerto fuera del rango indicado](https://docs.catalyst.zoho.com/es/cli/v1/serve-resources/serve-options/) | |
| Shell | No hay funciones válidas para servir | [Rectifica los errores e intenta de nuevo](https://docs.catalyst.zoho.com/es/cli/v1/working-with-functions/functions-shell/) |
| Deploy | No hay Functions listas para desplegar | [Ejecuta el comando deploy con una opción apropiada](https://docs.catalyst.zoho.com/es/cli/v1/deploy-resources/deploy-options/) |
| Despliegue de APIG omitido | [Habilita API Gateway localmente](https://docs.catalyst.zoho.com/es/cli/v1/working-with-api-gateway/enable-api-gateway/) y [despliégalo una vez más](https://docs.catalyst.zoho.com/es/cli/v1/deploy-resources/introduction/) | |
| Configuración de Functions Java | Archivo JAR faltante en la ruta especificada en el archivo de configuración | [Especifica una ruta válida al archivo JAR](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/functions-directory/) |
| Archivo corrupto en el directorio de Functions | [Elimina el archivo corrupto y ejecuta el comando de nuevo](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/functions-directory/) | |
| Nombre de proyecto no coincide en el archivo de configuración | [Cambia el nombre del proyecto a un valor apropiado](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/introduction/) | |
| Error en la verificación de la versión del compilador Java | [Asegúrate de que el compilador Java esté instalado](https://docs.catalyst.zoho.com/es/getting-started/installing-catalyst-cli/#pre-requisities) y ejecuta el comando de nuevo | |
| Compilador Java por encima de la versión compatible | [Degrada el compilador Java a una versión compatible](https://docs.catalyst.zoho.com/es/getting-started/installing-catalyst-cli/#pre-requisities) | |
| Archivo principal faltante en el directorio de Functions | [Especifica un archivo principal válido en el archivo de configuración](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/functions-directory/) | |
| Error de compilación Java | Rectifica los errores especificados para continuar | |
| Configuración de Functions Node.js | Archivo principal faltante en el directorio de Functions | [Especifica un archivo principal válido en el archivo de configuración](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/functions-directory/) |
| Uso de opciones | Destinos duplicados especificados para la opción | Elimina el valor duplicado e intenta de nuevo |
| Destino inválido especificado con la opción | Proporciona un destino válido según lo especificado | |
| Destino especificado con y sin filtro | Proporciona el destino en un formato válido | |
| No se puede depurar el destino Client | Elimina el Client como destino en `-\-debug` e intenta de nuevo | |
| Conflicto en el uso de opciones | Usa solo una de las opciones a la vez | |
| Entrada inválida para la opción | Proporciona una entrada válida según lo especificado e intenta de nuevo | |
| APIG no se puede servir por separado | [Incluye al menos otro componente como Functions o Client](https://docs.catalyst.zoho.com/es/cli/v1/serve-resources/introduction/) | |
| La opción Org es necesaria cuando se proporciona la opción Project | Proporciona el ID de la organización a la que pertenece el proyecto usando `-\-org` cuando te refieras a un proyecto específico usando [`-\-project` o `-p`](https://docs.catalyst.zoho.com/es/cli/v1/cli-options/#-p----project-ltname_or_project_idgt---org-ltorg_idgt) | |
| General | No se está en el directorio de la aplicación Catalyst durante la ejecución del comando | [Ejecuta el comando desde un directorio válido de Catalyst](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/introduction/) o [inicializa un proyecto para hacer de este un directorio de aplicación Catalyst](https://docs.catalyst.zoho.com/es/cli/v1/initialize-resources/introduction/) |
| Uso incorrecto del comando | [Usa `catalyst help` o ejecuta el comando con la opción `--help` para obtener instrucciones de uso](https://docs.catalyst.zoho.com/es/cli/v1/cli-help/command-reference-help/) | |
| No se puede cargar el archivo | Rectifica los errores especificados para continuar | |
| Puerto solicitado no disponible | Proporciona un puerto diferente con el comando |