Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
Sintoma
Você pode encontrar um ou mais dos seguintes problemas causados por problemas de comunicação entre o portal do desenvolvedor e o Edge:
- Não foi possível realizar as seguintes tarefas:
- Criar ou atualizar SmartDocs.
- Registrar apps de desenvolvedores.
- Listar produtos de API.
- Erro retornado ao acessar a página de modelos do SmartDocs no Portal do desenvolvedor. Selecione Conteúdo > SmartDocs no menu de administração do portal do desenvolvedor.
- A análise de aplicativos do desenvolvedor não está sendo gerada.
Mensagens de erro
- Erro retornado ao acessar a guia "SmartDocs" no portal do desenvolvedor:
The website encountered an unexpected error. Please try again later.
- Erro retornado ao registrar um app do desenvolvedor no portal do desenvolvedor:
There was an error trying to create the App. Please try again later.
Causas possíveis
Na maioria dos casos, o problema se deve a credenciais de devadmin incorretas especificadas ou a permissões insuficientes atribuídas ao papel de usuário devadmin.
Valide a configuração da conexão de borda para o portal do desenvolvedor acessando Configuração > Portal do desenvolvedor e verificando se o campo "Status da conexão" exibe "Conexão bem-sucedida". Caso contrário, o portal do desenvolvedor não poderá se conectar corretamente ao servidor de gerenciamento de borda.
Diagnóstico
- Para ativar a geração de registros "DEBUG" no portal do desenvolvedor, acesse Configuração > Portal do desenvolvedor e selecione "Depurar" em "Limite de registro de borda". Por padrão, as chamadas da API Management não são registradas.
- Reproduza o problema.
- Acesse o registro em Relatórios -> Mensagens de registro recentes.
- Abra a "Mensagem" do tipo "LogPlugin" para saber mais sobre o erro real.
Exemplo de saída mostrando o erro 401 não autorizado
Resolução
Siga as etapas apropriadas listadas na tabela abaixo, dependendo do erro encontrado:
Erro |
Etapas para a resolução |
401 não autorizado |
Atualize as credenciais corretas do devadmin no Portal do desenvolvedor e teste a conectividade novamente. Consulte Adicionar e gerenciar contas de usuário. |
403 Proibido |
Atualize o papel de usuário devadmin na organização de Edge para ter as permissões necessárias para o recurso. Consulte Como definir funções e permissões do usuário. |