code, title e message, além de um mapa fields em um 422. Os códigos são NRY- e quatro dígitos. Cite o código ao reportar um problema. A visão geral da API do host descreve o transporte pelo qual essas respostas chegam.
{ "code": "<code>", "title": "<title>", "message": "<message>" }
Códigos que o host responde
A
message sempre nomeia o item específico que falhou. Leia-a antes de agir com base na linha abaixo.
| Código | Status HTTP | Quando o host responde | O que fazer |
|---|---|---|---|
| NRY-0000 | 400 | A requisição está malformada. O corpo não é um JSON válido, ou um valor não corresponde ao tipo declarado. | Corrija a codificação da requisição. A mensagem nomeia a parte que falhou ao corresponder. |
| NRY-0001 | 422 | O corpo da requisição falhou na validação. | Corrija as propriedades que o mapa fields nomeia, e envie a requisição novamente. |
| NRY-0002 | 404 | Nenhuma sessão neste host carrega o sessionId da requisição. | Liste as sessões para obter um id válido. |
| NRY-0003 | 409 | A sessão de destino está arquivada. Uma sessão arquivada não aceita novos trabalhos. | Crie um branch da sessão em uma entrada para continuar a partir da transcrição, ou direcione-se a uma sessão ativa. |
| NRY-0004 | 409 | A sessão ou lane de destino não pode aceitar a requisição no estado atual. | Aguarde o trabalho em andamento terminar, ou interrompa-o, e envie a requisição novamente. |
| NRY-0006 | 409 | Dois pacotes reivindicam o mesmo slot substituível. Nada foi instalado. Um job de pacote que falha dessa forma carrega o código no seu campo error. | Remova ou desabilite um dos reivindicantes, e instale novamente. A mensagem nomeia ambos. |
| NRY-0007 | 409 | Uma build de pacote falhou. O binário que já estava servindo permanece intacto. Um job de pacote que falha dessa forma carrega o código no seu campo error. | Leia o erro do job, corrija ou remova o pacote, e instale novamente. |
| NRY-0009 | 404 | A sessão par endereçada não existe mais neste host. | Liste os pares para atualizar o conjunto de sessões endereçáveis, e envie a mensagem novamente. |
| NRY-0010 | 422 | Um script de workflow falhou na validação antes do run começar. | Corrija os erros de script que a mensagem nomeia, e inicie o run novamente. |
| NRY-0012 | 500 | O store local está indisponível, ou falhou na verificação de integridade. O host recusa gravações em vez de operar sobre um store danificado. | Verifique o espaço em disco e a integridade do store, corrija a causa, e reinicie o host. |
| NRY-0015 | 404 | O recurso nomeado não existe neste host. Pacotes, jobs de pacote, receitas de agente, skills, comandos, lanes, monitores, provedores, agendamentos, workflow runs, perguntas entre sessões e entradas da transcrição respondem todos com este código. | Liste a coleção à qual o recurso pertence, e use um nome ou id dela. |
| NRY-0016 | 409 | Já existe um pacote instalado com este nome. | Remova primeiro o pacote instalado, ou instale com outro nome. |
| NRY-0017 | 409 | Uma habilitação ou uma desabilitação trocou o binário, e então falhou ao confirmar a linha do pacote. | A mudança já se aplica ao binário que roda agora. Envie a requisição novamente, ou reinicie o host para que a conciliação de inicialização confirme a linha. |
| NRY-0020 | 412 | Uma gravação condicional carregava um ifMatchesSha256 ao qual o valor armazenado não corresponde mais pelo hash. Outro cliente gravou a linha primeiro, e nada foi gravado. | Leia o recurso novamente para ver o que ele contém agora. Um cliente que limpa um rascunho que enviou pode tratar isso como sucesso. |
| NRY-0021 | 500 | O host não conseguiu executar a requisição nesta máquina. Um processo que precisava iniciar não iniciou, ou uma operação falhou por um motivo sem um código mais exato. | Não havia nada de errado com a requisição, então envie-a novamente. O log do host carrega a causa, que a mensagem omite. |
| NRY-0022 | 500 | Um rewind que restaura arquivos nomeados parou no meio do caminho. Alguns arquivos voltaram e o restante permanece intocado. | Leia a mensagem para ver os arquivos que foram movidos. A working tree como estava antes da tentativa é mantida como um ponto de restauração. |
| NRY-0023 | 500 | Um rewind da conversa e dos arquivos criou um branch da conversa, e então falhou ao restaurar os arquivos. O branch é real. | Continue na sessão que a mensagem nomeia, e então faça o rewind dos arquivos sozinho a partir da sessão original no mesmo momento. |
| NRY-0024 | 413 | Uma importação de transcrição ultrapassou um teto de tamanho. | Leia a mensagem para ver o teto que ela nomeia, e envie uma transcrição menor. |
| NRY-0025 | 409 | Uma pergunta bloqueante entre sessões foi recusada, porque atendê-la fecharia um loop de sessões que esperam umas pelas outras. | Responda ou expire a pergunta já em andamento, ou envie uma mensagem unidirecional em vez disso. A mensagem nomeia as duas sessões. |
| NRY-0026 | 409 | Um stream retomou a partir de um Last-Event-ID que nomeia um evento mais recente do que qualquer coisa que este store contém. | Retome sem nenhum Last-Event-ID, e leia o estado novamente por meio das operações GET. O mesmo cursor é recusado de forma idêntica todas as vezes. |
| NRY-0027 | 413 | Os arquivos de uma mensagem pesam juntos mais do que uma requisição a um fornecedor consegue carregar. Nada foi gravado. | Envie menos arquivos na mensagem, ou arquivos menores. A mensagem nomeia o teto em bytes. |
Códigos que um turn com falha carrega
Um turn que falha termina com um evento
turn-finished. O seu payload.error carrega o mesmo envelope de um erro HTTP. Três códigos chegam dessa forma, e o host nunca os responde como um status HTTP.
| Código | Evento | Quando o host grava | O que fazer |
|---|---|---|---|
| NRY-0008 | turn-finished | O fornecedor de modelo de que o turn precisava não tem uma credencial utilizável. Ela está ausente, expirada ou recusada, ou o keyring está indisponível. | Faça login com narya auth login <provider>, e envie a mensagem novamente. A mensagem nomeia o remédio adequado. |
| NRY-0018 | turn-finished | O turn não conseguiu alcançar nenhum fornecedor de modelo. A sessão não nomeia nenhum provedor, ou nomeia um do qual este host não tem registro. | Faça login com narya auth login <provider>, ou defina default_model no config.toml do host, e envie a mensagem novamente. narya providers lista o que esta máquina pode usar. |
| NRY-0019 | turn-finished | O turn falhou por um motivo sem um código mais específico. A mensagem carrega a causa. O Narya remove dela formatos de credencial conhecidos e segredos de URL, e substitui o seu diretório home por ~. Os caminhos do host fora do seu diretório home permanecem. | Leia a mensagem. O log do host carrega a mesma falha sem essa filtragem. |