Referência de erros do Edge Microgateway

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

Neste tópico, descrevemos os erros e avisos que você pode encontrar no Edge Microgateway.

Erros gerais de aplicativo

  • HTTP 500, failed in error handle: a maioria dos erros terá esse número, assim como alguns erros retornados de destinos. Especificamente, o error-middleware.js é usado em todo o módulo microgateway-core. Quando usado, ele grava statusCodes na geração de registros usando o logger object: logger.error(err, 'failed in error handler'); do Edge Microgateway. Para códigos recebidos de destinos entre 100 e 300, o errors-middleware.js reescreve o statusCode como 500 para retorno ao cliente.

  • HTTP 404: é possível que você veja esse status produzido como um stack trace com a mensagem no match found for [API_path_name].

Erros e avisos do módulo

É possível usar essas informações para configurar alertas que ajudam a monitorar e gerenciar sua implantação do Edge Microgateway.

Os termos a seguir, que aparecem na referência de erro em "Gerenciador", indicam como os vários erros são processados no Edge Microgateway.

  • assert: normalmente, o Edge Microgateway será interrompido quando uma avaliação de declaração falhar. No entanto, esse nem sempre é o caso, já que "declarações" gera exceções que podem ser capturadas.
  • throws: possível interrupção do sistema.
  • callback: o erro é transmitido para um callback, e o sistema pode continuar.
Tipo Mensagem Handler Observações

Módulo microgateway
error org é obrigatório assert assert(options.org,"org é obrigatório");
error env é obrigatório assert assert(options.env,"env é obrigatório")
error o nome de usuário é obrigatório assert assert(options.username || options.token,"username é obrigatório");
error a senha é obrigatória assert assert(options.password || options.token,"a senha é obrigatória")
error org é obrigatório assert assert(options.org,"org é obrigatório");
error env é obrigatório assert assert(options.env,"env é obrigatório")
error o nome de usuário é obrigatório assert assert(options.username || options.token,"username é obrigatório");
error a senha é obrigatória assert assert(options.password || options.token,"a senha é obrigatória")
error org é obrigatório assert assert(options.org,"org é obrigatório");
error env é obrigatório assert assert(options.env,"env é obrigatório")
error org é obrigatório assert assert(options.org,"org é obrigatório");
error env é obrigatório assert assert(options.env,"env é obrigatório")
error o nome de usuário é obrigatório assert assert(options.username, 'username é obrigatório');
error a senha é obrigatória assert assert(options.password, 'senha necessária');
error org é obrigatório assert assert(options.org, 'org é obrigatório');
error env é obrigatório assert assert(options.env, 'env is required');
error precisa ter um arquivo de destino atribuído assert assert(targetFile, "precisa ter um arquivo de destino atribuído")
error precisa ter uma chave assert assert(key, 'deve ter uma chave');
error precisa ter um secret assert assert(secret, 'deve ter um secret');
error O dir precisa ser configurado assert assert(dir, "o diretório precisa ser configurado")
error o callback precisa estar presente assert assert(callback, "o callback precisa estar presente")
error o nome de usuário é obrigatório assert assert(options.username, 'username é obrigatório');
error a senha é obrigatória assert assert(options.password, 'senha necessária');
error org é obrigatório assert assert(options.org, 'org é obrigatório');
error env é obrigatório assert assert(options.env, 'env is required');
error RuntimeUrl é obrigatório assert assert(options.runtimeUrl, 'runtimeUrl é obrigatório');
error O mgmtUrl é obrigatório assert assert(options.mgmtUrl, 'mgmtUrl é obrigatório');
error O arquivo é obrigatório assert assert(options.file,"o arquivo é obrigatório")
error deve ter destino assert assert(options.target, 'precisa ter destino');
error plug-ins não configurados assert assert(config.edgemicro.plugins, 'plug-ins não configurados');
error o diretório do plug-in não existe: + pluginDir assert assert(fs.existsSync(pluginDir), 'diretório do plug-in não existe: ' + pluginDir);
error O plugin dir não é um diretório: + pluginDir assert assert(stat.isDirectory(), 'plugin dir não é um diretório: ' + pluginDir);
error erro ao ler o diretório do plug-in: + pluginDir assert assert(dirs, 'error read plugin dir: ' + pluginDir);
error precisa ter um token assert assert(token, 'precisa ter um token');
error O campo configpath não pode ficar em branco assert assert(config, 'configpath não pode estar vazio');
error precisa ter EDGEMICRO_KEY assert assert(key, 'precisa ter EDGEMICRO_KEY');
error precisa ter EDGEMICRO_SECRET assert assert(secret, 'precisa ter EDGEMICRO_SECRET');
error A configuração não existe. lança relacionado ao arquivo YAML
error O Edgemicro parece já estar em execução. console.error tentativa de substituir um arquivo .sock
error Falha ao verificar se há alteração em Config. Uma nova tentativa será feita após console.error problema com a comunicação de borda
error Se o servidor não estiver em execução, pode ser devido ao encerramento incorreto do início anterior. console.error
error %s ausente. Execute console.error Falta (.*), execute
error Falha ao recarregar o Edgemicro console.error nível de comando
error Falha ao interromper o Edgemicro console.error Nível de comando
error "Tente remover " + ipcPath + " e começar de novo" console.error
error "configuração de cache" + cache + " não existe. Saindo". console.error
error arquivo de configuração não pôde ser gravado: console.error Falha na configuração
error Não foi possível fazer o download do arquivo de configuração: console.error Falha na configuração
error Falha ao iniciar o Edge Micro console.error Ele não deve estar em execução
error O Edgemicro não está em execução. console.error Verifique o processo que não deve estar listado
error env é obrigatório console.error Variáveis de ambiente necessárias para a execução
error erro - editando apiproxy callout.xml console.error Acesso ao arquivo
error erro - editando apiproxy default.xml console.error Acesso ao arquivo
error verificação de erros para o certificado. Instalando o novo certificado. console.error Não é possível usar a chave pública
error erro ao recuperar a região da organização console.error key-gen.js, cert-lib.js e private.js
error erro ao fazer o upload de credenciais console.error Não é possível sincronizar a chave pública com o Edge
error com falha console.error key-gen.js
error falha ao iniciar o arquivo configpath %s console.error A configuração não está carregando
error resposta inválida da API de região console.error key-gen.js, cert-lib.js e private.js
error A chave é obrigatória. console.error Parâmetro
error org é obrigatório console.error Parâmetro
error não está disponível. console.error Parâmetro
error o secret é obrigatório console.error Parâmetro
error protocolo de URL não suportado: console.error As informações de configuração indicam um protocolo de Internet que não está no escopo do Edge Microgateway
error verificação de caso negativo de análise: FAIL console.error Possível falha/falha
error verificação de análises com payload: FAIL console.error Possível falha/falha
error verificar disponibilidade do URL de inicialização:FAIL console.error Possível falha/falha
error verificar a disponibilidade de jwt_public_key: FAIL console.error Possível falha/falha
error verificar a disponibilidade dos produtos: FAIL console.error Possível falha/falha
error verificação da cota com produtos configurados: FAIL console.error Possível falha/falha
warn falha ao recuperar configuração do gateway. Continuar, tentará copiar em cache. console.error
warn A KVM já existe na sua organização console.log
warn já foi implantado console.log
warn plug-in sequenciado não encontrado: console.warn
warn O pluginDir %s não existe console.log O pluginDir (.*) não existe.

Módulo microgateway-core
error configuração não inicializada assert assert(config, 'config não inicializado')
error precisa ter uma configuração assert assert(config, ' precisa ter uma configuração')
error precisa ter configurações assert assert(config, 'precisa ter config')
error a configuração precisa ter um uid assert assert(config.uid, 'o config precisa ter uid');
error precisa ter config.edgemicro.logging na configuração assert assert(logConfig, "precisa ter config.edgemicro.logging in config');
error precisa ter um método de solicitação assert assert(httpLibrary.request, 'deve ter método de solicitação');
error o plug-in precisa estar carregado na memória. assert assert(options.plugin, "deve ter o plug-in carregado na memória");
error "init" precisa ser uma função assert assert(_.isFunction(options.plugin.init), 'init precisa ser uma função');
error precisa ter o nome do plug-in assert assert(options.pluginName, "precisa ter o nome do plug-in");
error ignora gerenciadores de plug-in + nome inválidos assert assert(_.isObject(middleware), 'ignorar gerenciadores de plug-in inválidos ' + nome);
error as opções precisam conter configurações assert assert(config, "as opções precisam conter config")
error o plug-in precisa ter um nome assert assert(name,"o plug-in precisa ter um nome")
error o nome precisa ser uma string assert assert(_.isString(name),"name should be a string");
error O plug-in precisa ser uma função assert assert(_.isFunction(plugin),"plugin must be a function(config,logger,stats){return {onresponse:function(req,res,data,next){}}}");
error precisa ter uma chave assert assert(key, 'deve ter uma chave');
error precisa ter um secret assert assert(secret, 'deve ter um secret');
error precisa ter um diretório de configuração de origem assert assert(source, 'precisa ter um diretório de configuração de origem');
error erro ao carregar o plug-in console.error O plug-in não foi carregado
error falha no gerenciador de erros callback Função HTTP server.on()
error o comprimento do cabeçalho é maior do que o tamanho permitido erro de HTTP Não executa o plug-in
error resposta concluída antes que o trabalho possa ser feito logger.error O plug-in de destino não é executado
error gerou uma exceção callback Capturar erro do plug-in (catch)
error erro de borda inicial callback O Edge Microgateway não inicia
error O plug-in precisa ser uma função lança
warn console.error warns Gravação de registros
warn erro de targetRequest invocar tratamento de erros de destino Erro de cliente HTTP em conexão com o destino
warn erro targetResponse invocar tratamento de erros de destino Erro de servidor de destino HTTP em conexão com o destino como visto no cliente

Módulo microgateway-config
error allow_message assert assert(+config.quota.allow > 0, allow_message);
error A configuração não existe. lança Arquivo YAML de configuração
error configuração está vazia lança Arquivo YAML de configuração
error "config" não é um arquivo lança Arquivo YAML de configuração
error configuração não definida assert assert(config, 'config não definido');
error config.analytics.batchSize é inválido assert assert(+config.analytics.batchSize > 0, 'config.analytics.batchSize é inválido');
error config.analytics.batchSize não é um número assert assert(typeof config.analytics.batchSize === 'number', 'config.analytics.batchSize is not a number');
error config.analytics.bufferSize é inválido assert assert(+config.analytics.bufferSize > 0, 'config.analytics.bufferSize é inválido');
error config.analytics.bufferSize não é um número assert assert(typeof config.analytics.bufferSize === 'number', 'config.analytics.bufferSize is not a number');
error config.analytics.clearInterval é inválido assert assert(+config.analytics.clearInterval > 0, 'config.analytics.clearInterval é inválido');
error config.analytics.clearInterval não é um número. assert assert(typeof config.analytics.clearInterval === 'number', 'config.analytics.clearInterval não é um número');
error config.analytics.proxy não é "fictício" assert assert(config.analytics.proxy === 'dummy', 'config.analytics.proxy não é "fictício"');
error config.analytics.proxy não está definido assert assert(config.analytics.proxy, 'config.analytics.proxy não está definido');
error config.analytics.proxy_revision não é um número assert assert(typeof config.analytics.proxy_revision === 'number', 'config.analytics.proxy_revision não é um número');
error config.analytics.proxy_revision não definido assert assert(config.analytics.proxy_revision, 'config.analytics.proxy_revision não definido');
error config.analytics.source não é "microgateway" assert assert(config.analytics.source === 'microgateway', 'config.analytics.source não é "microgateway"');
error config.analytics.source não definido assert assert(config.analytics.source, 'config.analytics.source não definido');
error config.analytics.uri não é uma string assert assert(typeof config.analytics.uri === 'string', 'config.analytics.uri não é uma string');
error config.analytics.uri não definido assert assert(config.analytics.uri, 'config.analytics.uri não está definido');
error config.apikeys.public_key não definido assert assert(typeof config.apikeys.public_key === 'string', 'config.apikeys.public_key não definido');
error config.edge_config não definido assert assert(config.edge_config, 'config.edge_config não definido');
error config.edge_config.bootstrap não definido assert assert(config.edge_config.bootstrap, 'config.edge_config.bootstrap não definido');
error config.edge_config.jwt_public_key não definido assert assert(config.edge_config.jwt_public_key, 'config.edge_config.jwt_public_key não definido');
error config.edge_config.proxy precisará ser definido se config.edge_config.proxy_tunnel estiver definido assert assert(typeof config.edge_config.proxy !== 'undefined', 'config.edge_config.proxy deve ser definido se config.edge_config.proxy_tunnel estiver definido');
error config.edge_config.proxy_tunnel is not a boolean assert assert(typeof config.edge_config.proxy_tunnel === 'boolean', 'config.edge_config.proxy_tunnel is not a boolean');
error config.edge_config.refresh_interval não é um número assert assert(typeof config.edge_config.refresh_interval === 'number', 'config.edge_config.refresh_interval não é um número');
error config.edge_config.refresh_interval é muito pequeno (mín. 1h) assert assert(config.edge_config.refresh_interval >= 3600000, 'config.edge_config.refresh_interval é muito pequeno (mín. 1h)');
error config.edge_config.retry_interval não é um número assert assert(typeof config.edge_config.retry_interval === 'number', 'config.edge_config.retry_interval não é um número');
error config.edge_config.retry_interval é muito pequeno (mín. 5 s) assert assert(config.edge_config.retry_interval >= 5000, 'config.edge_config.retry_interval é muito pequeno (mín. 5 s)');
error config.edgemicro não definido assert assert(config.edgemicro, 'config.edgemicro não definido');
error config.edgemicro.logging não está definido assert assert(config.edgemicro.logging, 'config.edgemicro.logging não está definido');
error config.edgemicro.logging.dir não definido assert se (!config.edgemicro.logging.to_console) assert(config.edgemicro.logging.dir, 'config.edgemicro.logging.dir não está definido');
error config.edgemicro.logging.level não definido assert assert(config.edgemicro.logging.level, 'config.edgemicro.logging.level não definido');
error config.edgemicro.max_connections não é número assert assert(typeof config.edgemicro.max_connections === 'number', 'config.edgemicro.max_connections não é um número');
error config.edgemicro.max_connections não está definido assert assert(config.edgemicro.max_connections, 'config.edgemicro.max_connections não está definido');
error config.edgemicro.plugins.Sequence não é uma matriz assert assert(Array.isArray(config.edgemicro.plugins.Sequence), 'config.edgemicro.plugins.Sequence não é uma matriz');
error config.edgemicro.port não definido assert assert(config.edgemicro.port, 'config.edgemicro.port não definido');
error config.oauth.allowInvalidAuthorization não definido assert assert(typeof config.oauth.allowInvalidAuthorization === 'boolean', 'config.oauth.allowInvalidAuthorization is not base');
error config.oauth.allowNoAuthorization não definido não está definido assert assert(typeof config.oauth.allowNoAuthorization === 'boolean', 'config.oauth.allowNoAuthorization is not base');
error config.oauth.public_key não definido assert assert(typeof config.oauth.public_key === 'string', 'config.oauth.public_key is not base');
error config.oauthv2.public_key não definido assert assert(typeof config.oauthv2.public_key === 'string', 'config.oauthv2.public_key is not base');
error config.proxies não está definido assert assert(config.proxies, 'config.proxies não definido');
error config.proxy[ + index + ].base_path não está definido assert assert(proxy.base_path, 'config.proxy[' + index + '].base_path não está definido');
error config.proxy[ + index + ].max_connections não é número assert assert(typeof proxy.max_connections === 'number', 'config.proxy[' + index + '].max_connections não é um número');
error config.proxy[ + index + ].max_connections não está definido assert assert(proxy.max_connections, 'config.proxy[' + index + '].max_connections não está definido');
error config.proxy[ + index + ].name não está definido assert assert(proxy.name, 'config.proxy[' + index + '].name não definido');
error config.proxy[ + index + ].proxy_name não está definido assert assert(proxy.target_name, 'config.proxy[' + index + '].proxy_name não está definido');
error config.proxy[ + index + ].revision não está definido assert assert(proxy.revision, 'config.proxy[' + index + '].revision não está definido');
error config.proxy[ + index + ].url não está definido assert assert(proxy.url, 'config.proxy[' + índice + '].url não está definido');
error config.quota.allow não é um número assert assert(typeof config.quota.allow === 'number', 'config.quota.allow não é um número');
error config.quota.allow não está definido assert assert(config.quota.allow, 'config.quota.allow não está definido');
error config.quota.interval não é um número assert assert(typeof config.quota.interval === 'number', 'config.quota.interval não é um número');
error config.quota.interval não está definido assert assert(config.quota.interval, 'config.quota.interval não está definido');
error config.spikearrest não definido assert assert(config.spikearrest, 'config.spikearrest não definido');
error config.spikearrest.allow é inválido assert assert(+config.spikearrest.allow > 0, 'config.spikearrest.allow é inválido');
error config.spikearrest.allow não é um número assert assert(typeof config.spikearrest.allow === 'number', 'config.spikearrest.allow não é um número');
error config.spikearrest.allow não está definido assert assert(config.spikearrest.allow, 'config.spikearrest.allow não está definido');
error config.spikearrest.bufferSize é inválido assert assert(+config.spikearrest.bufferSize > 0, 'config.spikearrest.bufferSize is invalid');
error config.spikearrest.bufferSize não é um número assert assert(typeof config.spikearrest.bufferSize === 'number', 'config.spikearrest.bufferSize is not a number');
error config.spikearrest.timeUnit não está definido assert assert(config.spikearrest.timeUnit, 'config.spikearrest.timeUnit não está definido');
error ERRO CRÍTICO: erro ao analisar a lista de produtos transferida por download callback
error ERRO CRÍTICO: erro ao analisar a lista de proxies baixada callback
error ERRO DE CONFIGURAÇÃO DETECTADA DO PRODUTO console.error Seguido por console.warn('usando configuração antiga em cache');
error erro ao ler a configuração de lança Arquivo YAML de configuração
error erro ao salvar a configuração em callback Arquivo YAML de configuração
error fatal: configuração em cache indisponível, não é possível continuar callback
error interval_message assert assert(+config.quota.interval > 0, interval_message);
error protocolo inválido para config.edge_config.proxy (http: ou https:: esperado + proxy_url.protocol) assert assert(proxy_url.protocol === 'http:' || proxy_url.protocol === 'https:', 'protocolo inválido para config.edge_config.proxy (http: ou https: esperado): ' + proxy_url.protocol);
error host de proxy inválido para config.edge_config.proxy assert assert(proxy_url.hostname, 'host proxy inválido para config.edge_config.proxy: ' + proxy_url.hostname);
error Parece que o Edge Micro não foi configurado. Consulte o guia de administração. callback Resultado: falha ao carregar a configuração
error chave ausente assert assert(keys.key, 'a chave está ausente');
error precisa ter o configDir assert assert(configDir, "precisa ter configDir")
error opções obrigatórias assert assert(options, 'precisa ter opções');
error precisa ter uma origem assert assert(source, 'precisa ter origem')
error deve ter uma origem para carregar de assert assert(options.source, "precisa ter uma origem para carregar de")
error precisa ter targetFile assert assert(fileName, "precisa ter targetFile")
error opções não podem ser nulas assert assert(options, 'options não podem ser nulos');
error options.keys não pode ser nulo. assert assert(options.keys, 'options.keys não pode ser nulo');
error port_message assert assert(+config.edgemicro.port < 65536, port_message);
error produtos devem ser uma matriz assert assert(Array.isArray(products), 'produtos devem ser uma matriz');
error "proxies for product" + product + "deve ser uma matriz" assert assert(Array.isArray(product.proxies), 'proxies para o produto ' + produto + ' deve ser uma matriz');
error secret está ausente assert assert(keys.secret, 'o secret está ausente');
error a meta não está definida assert assert(target, 'target não definido');
warn erro ao fazer o download da configuração, verifique a configuração de inicialização console.warn
warn falha no download de jwt_public_key console.warn
warn As chaves jwk não estão ativadas console.warn
warn mensagem, "download de", url, "retornado" console.warn Pesquise: (.*)\sdownload from\s(.*)\sreturned
warn nenhum produto Edge Micro foi encontrado em resposta console.warn
warn nenhum proxy de borda micro encontrado na organização console.warn
warn Nenhum proxy de borda de borda foi encontrado em resposta console.warn
warn nenhum produto encontrado na organização console.warn
warn nenhum produto foi encontrado na resposta console.warn
warn usando a configuração em cache antiga console.warn

Módulo microgateway-plugins
error A configuração não existe. lança Relacionado ao arquivo YAML
error apikey Resposta HTTP Falhas em plug-ins com API
error autenticação Resposta HTTP Falhas no plug-in bauth
error extauth Resposta HTTP Falhas no plug-in extauth
error Oauth Resposta HTTP Falhas no plug-in OAuth
warn Erro encontrado ao processar as análises da Apigee. Como permitir que o processamento da solicitação continue logger.error
warn ignorando errr console.warn Plug-ins apikeys, oauth e oauthv2
warn erro de análise de jwt: console.warn
warn O objeto de resposta de juramento não tem setHeader console.warn O erro de parâmetro OAuth indica que alguns erros não serão relatados.
warn o objeto de resposta de compromisso não é fornecido pelo ambiente de execução console.warn Erro de parâmetro OAuth
warn O objeto de estatísticas de juramento não é fornecido pelo ambiente de execução console.warn Erro de parâmetro OAuth

Módulo apigeetool-node
error Falha ao excluir o cache com o código de status %d', res.statusCode callback Gerada em deletecache.js. Código de status do Apigee Edge. Transmite para o callback um erro de stack trace com esta mensagem:done(new Error(errMsg):
error Falha ao excluir o produto com o código de status %d', res.statusCode callback Gerada em deleteproduct.js. Código de status do Apigee Edge. Transmite para o callback um erro de stack trace com esta mensagem:done(new Error(errMsg):
error org, api e revisão precisam ser especificadas. callback Gerada em fetchproxy.js. Erro de configuração.
error Erro recebido %d ao buscar proxy: %j callback Gerada em fetchproxy.js. Código de status diferente de 200.
error Falha ao criar o app com o código de status %d callback Gerada em createapp.js. Transmite todos os erros para callbacks como erros de stack trace. Não faz nenhuma impressão do console nem entradas de registro.
error comando + ' falha com o código de status %d callback Gerada em command-utils.js. Para qualquer comando analisado e transmitido para esse módulo, qualquer código diferente de 200 ou 201 vai gerar uma mensagem de erro. Formata essa mensagem, mas não é impressa. Transmite um erro de stack trace com a mensagem de volta para os callbacks.
error Erro recebido %d ao buscar o fluxo compartilhado: %s callback Gerada em fetchsharedflow.js. Para qualquer status HTTP que não seja 200. Se for bem-sucedida, mas falhar ao gravar um arquivo, a gravação será feita no console:
Falha ao gravar o arquivo
Texto do erro: [stack_trace_error]
error Falha ao criar KeySecret com o código de status %d', res.statusCode callback Gerada em createappkey.js. Para códigos de status HTTP do Apigee Edge que não são 200 ou 201.
error Falha na criação do cache com o código de status %d', res.statusCode callback Gerada em createcache.js. Para códigos de status HTTP do Apigee Edge que não são 200 ou 201.
error Falha ao criar o produto com o código de status %d', res.statusCode callback Gerada em createproduct.js. Para códigos de status HTTP do Apigee Edge que não são 201. Se o status HTTP for 201, mas a resposta incluir o JSON de erro, o JSON de erro será encaminhado ao callback.
error Falha ao excluir o app com o código de status %d', res.statusCode callback Gerada em deleteapp.js. Para códigos de status HTTP do Apigee Edge que não sejam 200. Se o status HTTP for 200, mas a resposta incluir o JSON de erro, o JSON de erro será encaminhado ao callback.
error Falha ao criar desenvolvedor com o código de status %d', res.statusCode callback Gerada em createdeveloper.js. Para códigos de status HTTP do Apigee Edge que não são 201. Se o status HTTP for 201, mas a resposta incluir o JSON de erro, o JSON de erro será encaminhado ao callback.
error Falha ao excluir o desenvolvedor com o código de status %d', res.statusCode callback Gerada em deletedeveloper.js. Para códigos de status HTTP do Apigee Edge que não sejam 200. Se o status HTTP for 200, mas a resposta incluir o JSON de erro, o JSON de erro será encaminhado ao callback.

Erros de plug-in

accesscontrol plug-in

This section describes the error codes and messages that are returned by the accesscontrol plug-in with descriptions of possible causes.

Error Message HTTP status Possible Causes
Not printed Forbidden 403 Access control rule

accumulate-request plug-in

This section describes the error codes and messages that are returned by the accumulate-request plug-in with descriptions of possible causes.

No errors generated.

accumulate-resopnse plug-in

This section describes the error codes and messages that are returned by the accumulate-response plug-in with descriptions of possible causes.

No errors generated.

analytics plug-in

This section describes the error codes and messages that are returned by the analytics plug-in with descriptions of possible causes.

Errors encountered processing Apigee analytics are written to the Edge Microgateway log. Edge Microgateway processing continues.

apikeys plug-in

This section describes the error codes and messages that are returned by the apikeys plug-in with descriptions of possible causes.

Error Message HTTP status Possible Causes
invalid_request Invalid Request 400 allowNoAuthorization == false

No Authorization header in the HTTP request

allowOAuthOnly == true

invalid_request API Key Verification URL not configured 400 Verification API service not in header.
access_denied Copy service message 403 In response to the auth service timeout
missing_authorization Missing API Key header 401 allowAPIKeyOnly == true

Unless allowInvalidAuthorization

invalid_authorization Invalid Authorization header 401 allowOAuthOnly == true

Authorization-header not in HTTP

gateway_timeout Copy service message 504 In response to the auth timeout
default 500 All other not categorized

bauth plug-in

This section describes the error codes and messages that are returned by the bauth plug-in with descriptions of possible causes.

Error Message HTTP status Possible Causes
missing_authorization Missing API Key header 401 allowAPIKeyOnly == true

Unless allowInvalidAuthorization

invalid_authorization Invalid Authorization header 401 allowOAuthOnly == true

Authorization-header not in HTTP

gateway_timeout Copy service message 504 In response to the auth timeout
default 500 All other not categorized

cloud-foundry-route-service plug-in

This section describes the error codes and messages that are returned by the cloud-foundry-route-service plug-in with descriptions of possible causes.

No errors generated.

cors plug-in

This section describes the error codes and messages that are returned by the cors plug-in with descriptions of possible causes.

No errors generated.

eurekaclient plug-in

This section describes the error codes and messages that are returned by the eurekaclient plug-in with descriptions of possible causes.

The eurekaclient plug-in throws a few console errors only, including a stack trace error on failed start and a warning about the target endpoint from Eureka not found.

extauth plug-in

This section describes the error codes and messages that are returned by the extauth plug-in with descriptions of possible causes.

Error Message HTTP status Possible Causes
invalid_request Invalid Request 400 allowNoAuthorization == false

No Authorization header in the HTTP request

allowOAuthOnly == true

invalid_request API Key Verification URL not configured 400 Verification API service not in header.
access_denied Copy service message 403 In response to the auth service timeout
missing_authorization Missing API Key header 401 allowAPIKeyOnly == true

Unless allowInvalidAuthorization

invalid_authorization Invalid Authorization header 401 allowOAuthOnly == true

Authorization-header not in HTTP

gateway_timeout Copy service message 504 In response to the auth timeout
default 500 All other not categorized

header-uppercase plug-in

This section describes the error codes and messages that are returned by the header-uppercase plug-in with descriptions of possible causes.

No errors generated.

healthcheck plug-in

This section describes the error codes and messages that are returned by the healthcheck plug-in with descriptions of possible causes.

Error Message HTTP status Possible Causes
503 Too busy. No messages in HTTP or console
default Application is not running on specified application port 500 All other not categorized

invalidHeader plug-in

This section describes the error codes and messages that are returned by the invalidHeader plug-in with descriptions of possible causes.

No errors generated.

json2xml plug-in

This section describes the error codes and messages that are returned by the json2xml plug-in with descriptions of possible causes.

Parsing errors are sent to a callback.

Error Message HTTP status Possible Causes
default 500 All other not categorized

monitor plug-in

This section describes the error codes and messages that are returned by the monitor plug-in with descriptions of possible causes.

No errors generated.

oauth plug-in (v1)

This section describes the error codes and messages that are returned by the oauth plug-in (v1) with descriptions of possible causes.

Error Message HTTP status Possible Causes
invalid_request Invalid Authorization Header 400
  • allowNoAuthorization attribute == false
  • allowOAuthOnly == true
  • No Authorization header in the HTTP request
invalid_request API Key Verification URL not configured 400 Verification API service not in header.
Access_denied Copy service message 403 In response to the auth service timeout
invalid_token Missing API Key header 401 allowAPIKeyOnly == true

Unless allowInvalidAuthorization is set

invalid_token token could not be parsed 401 allowAPIKeyOnly == true

Bad token delivered

missing_authorization Missing Authorization header 401 allowNoAuthorization == false

Authorization-header in HTTP

allowOAuthOnly == true

invalid_authorization Invalid Authorization header 401 allowOAuthOnly == true

Authorization-header not in HTTP

gateway_timeout Copy service message 504 In response to the auth timeout
default 500 All other uncategorized responses

oauthv2 plug-in

This section describes the error codes and messages that are returned by the oauthv2 plug-in with descriptions of possible causes.

Error Message HTTP status Possible Causes
invalid_request Invalid Authorization Header 400
  • allowNoAuthorization attribute == false
  • allowOAuthOnly == true
  • No Authorization header in the HTTP request
invalid_request API Key Verification URL not configured 400 Verification API service not in header
access_denied Copy service message 403 In response to the auth service timeout
invalid_token Missing API Key header 401 allowAPIKeyOnly == true

Unless allowInvalidAuthorization is set

invalid_token token could not be parsed 401 allowAPIKeyOnly == true

Bad token delivered

missing_authorization Missing Authorization header 401 allowNoAuthorization == false

Authorization-header in HTTP

allowOAuthOnly == true

invalid_authorization Invalid Authorization header 401 allowOAuthOnly == true

Authorization-header not in HTTP

gateway_timeout Copy service message 504 In response to the auth timeout
default 500 All other uncategorized responses

quota plug-in

This section describes the error codes and messages that are returned by the quota plug-in with descriptions of possible causes.

Defers to volos quota/apigee.

Error Message HTTP status Possible Causes
invalid_authorization Invalid Authorization header 401 allowOAuthOnly == true

Authorization-header not in HTTP

gateway_timeout Not authorized to call the remote proxy. Check the "key" parameter. 404 In response to the auth timeout
default 500 All other not categorized
throw uri parameter must be specified apigeequota.js
throw key parameter must be specified apigeequota.js
callback Apigee Remote Proxy not found at: ' + self.uri + '. Check your configuration apigeequota.js
callback HTTP error getting proxy version: %d. Check the "uri" parameter. apigeequota.js
callback Quotas with a fixed starting time are not supported apigeequota.js
callback Error updating remote quota: %d %s', resp.statusCode, body apigeequota.js

If there is an error on an entry in the product list, the product list will stop being processed.

quota-memory plug-in

This section describes the error codes and messages that are returned by the quota-memory plug-in with descriptions of possible causes.

Defers to volos quota/apigee.

Error Message HTTP status Possible Causes
invalid_authorization Invalid Authorization header 401 allowOAuthOnly == true

Authorization-header not in HTTP

gateway_timeout Not authorized to call the remote proxy. Check the "key" parameter. 404 In response to the auth timeout
default 500 All other not categorized
throw start time not allowed for month time units quota.js. volos error on time format.
throw Invalid start time %s quota.js. volos error on time format.
throw Invalid timeUnit %s quota.js. volos error on time format.

If there is an error on an entry in the product list, the product list will stop being processed.

spikearrest plug-in

This section describes the error codes and messages that are returned by the spikearrest plug-in with descriptions of possible causes.

Defers to volos spikearrest/memory.

Error Message HTTP status Possible Causes
SpikeArrest engaged 503 Traffic spike. This is expected behavior.
throw Invalid timeUnit %s spikearrest.js
callback key must be a string spikearrest.js
throw %s must be a number', name spikearrest.js

transform-uppercase plug-in

This section describes the error codes and messages that are returned by the transform-uppercase plug-in with descriptions of possible causes.

No errors generated.