code, title y message. Los códigos son NRY- y cuatro dígitos. Cita el código cuando reportes un problema. La descripción general de la API del host describe el transporte por el que llegan estas respuestas.
{ "code": "<code>", "title": "<title>", "message": "<message>" }
Códigos que responde el host
El
message siempre nombra lo específico que falló. Léelo antes de actuar según la fila siguiente.
| Código | Estado HTTP | Cuándo lo responde el host | Qué hacer |
|---|---|---|---|
| NRY-0000 | 400 | La solicitud está mal formada. | Corrige la parte que nombra el mensaje. |
| NRY-0001 | 422 | El cuerpo de una solicitud falló la validación. | Corrige las propiedades que nombra el mensaje, y vuelve a enviar la solicitud. |
| NRY-0002 | 404 | Ninguna sesión de este host tiene el sessionId de la solicitud. | Lista las sesiones para obtener un id válido. |
| NRY-0003 | 409 | La sesión objetivo está archivada. Una sesión archivada no acepta trabajo nuevo. | Bifurca la sesión en una entrada para continuar desde su transcripción, o dirígete a una sesión activa. |
| NRY-0004 | 409 | El destino no puede aceptar la solicitud en su estado actual. | Lee el mensaje y resuelve el conflicto que describe. |
| NRY-0006 | 409 | Dos paquetes reclaman el mismo slot reemplazable. No se instaló nada. Un trabajo de paquete que falla de esta manera lleva el código en su campo error. | Elimina o deshabilita a uno de los reclamantes, y vuelve a instalar. El mensaje nombra a ambos. |
| NRY-0007 | 409 | Falló la compilación de un paquete. El binario que ya estaba en servicio permanece intacto. Un trabajo de paquete que falla de esta manera lleva el código en su campo error. | Lee el error del trabajo, corrige o elimina el paquete, y vuelve a instalar. |
| NRY-0009 | 404 | La sesión par a la que se dirigió ya no está en este host. | Lista los pares para actualizar el conjunto de sesiones direccionables, y vuelve a enviar el mensaje. |
| NRY-0010 | 422 | Un script de workflow falló la validación antes de que empezara la ejecución. | Corrige los errores del script que nombra el mensaje, y vuelve a iniciar la ejecución. |
| NRY-0011 | 401 | La solicitud no lleva un token válido, o pide un trabajo que exige autenticación. | Inicia sesión con narya login, y vuelve a enviar la solicitud. Un host sin proveedor de identidad rechaza todos los tokens, y el mensaje nombra la configuración que debes añadir. |
| NRY-0012 | 500 | El almacén local no está disponible, o falló su verificación de integridad. El host rechaza las escrituras en lugar de trabajar sobre un almacén dañado. | Verifica el espacio en disco y la integridad del almacén, corrige la causa, y reinicia el host. |
| NRY-0013 | 404 | Este home no tiene una extensión habilitada con ese nombre, o la extensión no expone la operación. | Lista las extensiones de este home, y pregunta al autor de la extensión qué operaciones expone. |
| NRY-0015 | 404 | El recurso indicado no existe en este host. Los paquetes, los trabajos de paquete, las recetas de agente, las skills, los comandos, los carriles, los monitores, los proveedores, las programaciones, las ejecuciones de workflow, las solicitudes entre sesiones y las entradas de transcripción responden con este código. | Lista la colección a la que pertenece el recurso, y usa un nombre o id de ella. |
| NRY-0016 | 409 | Ya hay un paquete instalado con este nombre. | Elimina primero el paquete instalado, o instala con otro nombre. |
| NRY-0017 | 409 | Una habilitación o una deshabilitación intercambió el binario, y luego no pudo confirmar la fila del paquete. | El cambio ya se aplica al binario que se ejecuta ahora. Vuelve a enviar la solicitud, o reinicia el host para que la sincronización de inicio actualice la fila. |
| NRY-0020 | 412 | Una escritura condicional llevaba un ifMatchesSha256 al que el valor almacenado ya no genera el mismo hash. Otro cliente escribió la fila primero, y no se escribió nada. | Vuelve a leer el recurso para ver qué contiene ahora. Un cliente que borra un borrador que envió puede tratar esto como un éxito. |
| NRY-0021 | 500, 503 | El host no pudo hacer la solicitud en esta máquina. Un proceso que debía iniciar no se inició, o una operación falló por una razón que no tiene un código más exacto. Un 503 significa que el producto de una sesión de producto no tiene herramientas cargadas, y no se envió nada. | Nada de la solicitud estaba mal, así que vuelve a enviarla. |
| NRY-0022 | 500 | Un rewind que restaura archivos indicados se detuvo a mitad de camino. Algunos archivos volvieron y el resto quedó sin tocar. | Lee el mensaje para ver los archivos que se movieron. El árbol de trabajo tal como estaba antes del intento se conserva como punto de restauración. |
| NRY-0023 | 500 | Un rewind de la conversación y los archivos bifurcó la conversación, y luego no pudo restaurar los archivos. La bifurcación es real. | Continúa en la sesión que nombra el mensaje, y luego haz un rewind de los archivos solos desde la sesión original en el mismo momento. |
| NRY-0024 | 413 | La importación de una transcripción superó un límite de tamaño. | Lee el mensaje para ver el límite que nombra, y envía una transcripción más pequeña. |
| NRY-0026 | 409 | Un stream se reanudó desde un Last-Event-ID que nombra un evento más reciente que cualquiera que tenga este almacén. | Reanuda sin Last-Event-ID, y luego vuelve a leer el estado a través de las operaciones GET. |
| NRY-0027 | 413 | Los archivos de un mensaje pesan, en conjunto, más de lo que puede llevar una solicitud al proveedor. No se escribió nada. | Envía menos archivos en el mensaje, o archivos más pequeños. El mensaje nombra el límite en bytes. |
| NRY-0028 | 403 | El llamador inició sesión y la solicitud se rechaza. Cuando la operación necesita un permiso, el mensaje lo nombra. | Para un permiso nombrado, un administrador lo concede en tu rol en Access Manager, y aplica desde tu próximo token. Si el mensaje dice que el host no pudo consultar Access Manager, vuelve a enviar la solicitud en unos instantes. |
| NRY-0029 | 503 | El home de la organización no respondió. | Lee el mensaje: indica si el trabajo está en cola o si debes volver a enviar la solicitud. Publicar la misma sesión otra vez crea un segundo recurso compartido. |
| NRY-0030 | 403 | El token nombra una organización que este home no atiende. | Apunta NARYA_HOME al home de tu organización, o inicia sesión en este home con narya login. El dueño del home que tu organización usa ahora registra de nuevo una extensión rechazada. |
| NRY-0031 | 410 | El recurso compartido fue revocado. | Publica la sesión otra vez para crear un nuevo recurso compartido. Un recurso compartido revocado nunca se reanuda. |
| NRY-0032 | 409 | El host se negó a recibir la respuesta del dueño a una pregunta de una sesión de producto, por ejemplo mientras se vacía. La pregunta vuelve a quedar pendiente. | Responde la pregunta de nuevo cuando el host reciba mensajes. No se pierde nada. |
Códigos que lleva un turno fallido
Un turno que falla termina con un evento
turn-finished. Su payload.error lleva el mismo envelope que un error HTTP. Tres códigos llegan solo de esa manera, y el host nunca los responde como un estado HTTP. NRY-0011 también llega de esa manera, cuando el producto de una sesión de producto rechaza el inicio de sesión de la persona.
| Código | Evento | Cuándo lo escribe el host | Qué hacer |
|---|---|---|---|
| NRY-0008 | turn-finished | El proveedor de modelo que necesitaba el turno no tiene una credencial utilizable. Falta, está vencida o fue rechazada, o el keyring no está disponible. | Inicia sesión con narya auth login <provider>, y vuelve a enviar el mensaje. El mensaje nombra el remedio que corresponde. |
| NRY-0011 | turn-finished | El producto de una sesión de producto rechazó el inicio de sesión de la persona que envió el mensaje. | Inicia sesión de nuevo y vuelve a enviar el mensaje. |
| NRY-0018 | turn-finished | El turno no pudo comunicarse con ningún proveedor de modelo. La sesión no nombra ningún proveedor, o nombra uno del que este host no tiene registro. | Inicia sesión con narya auth login <provider>, o define default_model en el config.toml del host, y vuelve a enviar el mensaje. narya providers muestra lo que puede usar esta máquina. |
| NRY-0019 | turn-finished | El turno falló por una razón que no tiene un código más específico. El mensaje lleva la causa. Narya elimina de él las formas de credencial conocidas y los secretos de URL, y reemplaza tu directorio home con ~. | Lee el mensaje. |