Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Se você não receber uma resposta bem-sucedida de uma solicitação para sua
API Frameworks do Cloud Endpoints, use o Cloud Logging no
Google Cloud console para ajudar a resolver problemas.
Como ver registros
No Google Cloud console, acesse a página Logging >
Explorador de registros.
Na lista suspensa do projeto, na parte de cima da página, selecione o projetoGoogle Cloud em que você criou a API.
Selecione GAE Application e All logs.
Ajuste o intervalo até ver uma linha que mostre um erro.
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)
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:
Edite o arquivo app.yaml e configure ENDPOINTS_SERVICE_VERSION para o ID de configuração do serviço.
Implante o app novamente:
gcloudappdeploy
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:
Em algumas versões do Windows PowerShell, o exemplo Invoke-WebRequestnos 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:
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\"}"
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eCloud Logging helps troubleshoot unsuccessful responses from Cloud Endpoints Frameworks APIs, accessible via the Logs Explorer in the Google Cloud console.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003e503 Service Unavailable\u003c/code\u003e error may occur initially with App Engine; waiting a few minutes and retrying the request is recommended before checking logs.\u003c/p\u003e\n"],["\u003cp\u003eErrors like "No service found" or "permission denied" often indicate a missing service configuration or disabled APIs, which can be resolved by deploying the OpenAPI document and ensuring necessary APIs are enabled.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003e404 Not Found\u003c/code\u003e error after migrating to Endpoints Frameworks version 2 requires specific troubleshooting steps detailed in Java and Python migration guides.\u003c/p\u003e\n"],["\u003cp\u003eIf \u003ccode\u003eInvoke-WebRequest\u003c/code\u003e fails in Windows PowerShell, try using Cloud Shell, Postman, or \u003ccode\u003ecurl\u003c/code\u003e with specific formatting for nested quotation marks.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting response errors\n\nIf you don't get a successful response from a request to your\nCloud Endpoints Frameworks API, you can use Cloud Logging in the\nGoogle Cloud console to help troubleshoot.\n\nViewing logs\n------------\n\n1. In the Google Cloud console, go to the **Logging** \\\u003e\n **Logs Explorer** page.\n\n\n [Go to the Logs Explorer page](https://console.cloud.google.com/logs/query)\n\n \u003cbr /\u003e\n\n2. From the project drop-down list at the top of the page, select the\n Google Cloud project in which you created your API.\n\n3. Select **GAE Application** and **All logs**.\n\n4. Adjust the time range until you see a row that shows an error.\n\n5. Click **Expand All** to see the entire log for the error.\n\nThe following section provides troubleshooting information for specific error\nmessages. If you are unable to fix the issue, copy one of the log entries that\nshows the error and paste it in a text file. Include the log in any\ncommunication that you have with Google.\n\n### `503 Service Unavailable`\n\nApp Engine might take a few minutes to respond successfully to requests. If you\nsend a request and get a `503` error, wait a few minutes and try the\nrequest again. If you still don't get a successful response, check the\nCloud Logging logs. The following are some error messages that you might\nsee in the Cloud Logging logs.\n\n### `404 Not Found`\n\nIf you recently migrated to Endpoints Frameworks version 2, and you\nget the `404 Not Found` error message, see the following sections to\ntroubleshoot the issue:\n\n- [Java: Troubleshooting](/endpoints/docs/frameworks/java/migrating#api_returns_404_errors_but_api_explorer_still_lists_apis_correctly)\n- [Python: Troubleshooting](/endpoints/docs/frameworks/python/migrating#api_returns_404_errors_but_api_explorer_still_lists_apis_correctly)\n\nIssues with the example `Invoke-WebRequest`\n-------------------------------------------\n\nIn some versions of Windows PowerShell, the example `Invoke-WebRequest` in the\n[tutorials](/endpoints/docs/frameworks/tutorials) fails. We have also received a\nreport that the response contained a list of unsigned bytes that had to be\nconverted to characters. If the example `Invoke-WebRequest` didn't return the\nexpected result, try sending the request using another application. Following\nare a few suggestions:\n\n- [Start Cloud Shell](/shell/docs/starting-cloud-shell), and follow the Linux steps in the tutorial that you were using to send the request.\n- Use a third-party application such as the Chrome browser extension Postman\n (offered by `www.getpostman.com`). When creating the request in Postman:\n\n - Select `POST` as the HTTP verb.\n - For the header, select the key `content-type` and the value `application/json`.\n - For the body, enter: `{\"message\":\"hello world\"}`\n - Enter the URL for the sample application. For example:\n\n https://example-project-12345.appspot.com/_ah/api/echo/v1/echo\n\n- Download and install [`curl`](https://curl.haxx.se/download.html), which you\n run in the Command prompt. Because Windows doesn't handle double quotation\n marks nested inside single quotation marks, you have to change the `--data`\n option in the example, as follows: `--data \"{\\\"message\\\":\\\"hello world\\\"}\"`\n\nWhat's next\n\n- Get started using the [Logs Explorer](/logging/docs/view/logs-explorer-interface).\n\n- Learn how to [route logs](/logging/docs/export/configure_export_v2).\n\n- Use [filters](/logging/docs/view/advanced_filters)\n for advanced filtering, such as getting all requests with a latency greater\n than 300 milliseconds."]]
