Solução de problemas de erros de respostas

Se você não receber uma resposta de uma solicitação à API Cloud Endpoints Frameworks, é possível usar o Cloud Logging na console do Google Cloud para ajudar a resolver problemas.

Como ver registros

  1. No console do Google Cloud, acesse Logging > Análise de registros.

    Acessar a página Análise de registros

  2. Na lista suspensa do projeto, na parte superior da página, selecione o projeto do Google Cloud em que você criou a API.

  3. Selecione GAE Application e All logs.

  4. Ajuste o intervalo até ver uma linha que mostre um erro.

  5. Clique em Expandir tudo para ver todo o registro do erro.

A seção a seguir fornece informações sobre solução de problemas para mensagens de erro específicas. Se você não conseguir corrigir o problema, copie uma das entradas de registro que mostra o erro e cole-a em um arquivo de texto. Inclua o registro em qualquer comunicação que você tiver com o Google.

503 Service Unavailable

O App Engine pode levar alguns minutos para responder às solicitações. Se você enviar uma solicitação e receber um erro 503, aguarde alguns minutos e reenvie a solicitação. Se você ainda não obtiver uma resposta bem-sucedida, verifique os registros do Cloud Logging. Veja a seguir algumas mensagens de erro que podem ser exibidas nos registros do Cloud Logging.

Mensagem de erro Solução de problemas
Nenhum serviço YOUR_PROJECT_ID.appspot.com encontrado ou permissão negada. Se esse for um novo serviço do Endpoints, certifique-se de ter implantado a configuração do serviço usando a gcloud. O Endpoints Frameworks para Python registra esse erro quando ocorre uma falha ao carregar a configuração do serviço que você especificou no arquivo app.yaml. Esse erro pode acontecer quando o documento da OpenAPI não foi implantado na API usando gcloud endpoints services deploy ou quando a API Service Management não está ativada. Ao implantar o documento do OpenAPI na sua API, o comando gcloud ativa automaticamente o seguinte:
  • API Service Management (servicemanagement.googleapis.com)
  • Endpoints (endpoints.googleapis.com)
  • APIs do Cloud (cloudapis.googleapis.com)
Se tiver desativado um desses serviços, reative-os. Consulte Como ativar e desativar APIs para mais informações.
O serviço YOUR_PROJECT_ID.appspot.com foi encontrado, mas nenhuma configuração de serviço foi localizada para a versão SERVICE_CONFIG_ID. O Endpoints Frameworks para Python registra esse erro quando não consegue localizar o ID de configuração de serviço que você especificou para ENDPOINTS_SERVICE_VERSION no arquivo app.yaml. Para corrigir esse erro, siga as etapas abaixo:
  1. Consiga o ID de configuração do serviço.
  2. Edite o arquivo app.yaml e configure ENDPOINTS_SERVICE_VERSION para o ID de configuração do serviço.
  3. Implante o app novamente:
    gcloud app deploy

404 Not Found

Se você migrou recentemente para a versão 2 do Endpoints Frameworks e recebeu a mensagem de erro 404 Not Found, consulte as próximas seções para solucionar o problema:

Problemas com o exemplo Invoke-WebRequest

Em algumas versões do Windows PowerShell, o exemplo Invoke-WebRequest nos tutoriais apresenta falha. Também recebemos um relatório informando que a resposta continha uma lista de bytes não assinados que precisavam ser convertidos em caracteres. Se o exemplo Invoke-WebRequest não retornou o resultado esperado, tente enviar a solicitação usando outro aplicativo. A seguir, algumas sugestões:

  • Inicie o Cloud Shell e siga os passos do Linux no tutorial que estava sendo usado para enviar a solicitação.
  • Use um aplicativo de terceiros como o Postman, uma extensão do navegador Chrome, oferecido por www.getpostman.com. Ao criar a solicitação no Postman, faça o seguinte:

    • Selecione POST como o verbo HTTP.
    • Para o cabeçalho, selecione a chave content-type e o valor application/json.
    • Para o corpo, digite: {"message":"hello world"}
    • Digite o URL para o aplicativo de amostra. Exemplo:

      https://example-project-12345.appspot.com/_ah/api/echo/v1/echo
      
  • Faça o download e instale o curl executado no prompt de comando. Como o Windows não processa aspas duplas aninhadas entre aspas simples, é necessário alterar a opção --data no exemplo desta forma: --data "{\"message\":\"hello world\"}"

A seguir