Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Si no obtienes una respuesta correcta de una solicitud a tu API de Cloud Endpoints Frameworks, puedes usar Cloud Logging en la consola deGoogle Cloud para ayudar a solucionar el problema.
Visualiza registros
En la Google Cloud consola, ve a la página Registros > Explorador de registros.
En la lista desplegable del proyecto de la parte superior de la página, selecciona el proyecto deGoogle Cloud en el que creaste tu API.
Selecciona Aplicación en GAE y Todos los registros.
Ajusta el intervalo de tiempo hasta que veas una fila que muestre un error.
Haz clic en Expandir todos para ver el registro completo del error.
La siguiente sección proporciona información para la solución de problemas para mensajes de error específicos. Si no puedes solucionar el problema, copia una de las entradas de registro que muestra el error y pégala en un archivo de texto. Incluye el registro en cualquier comunicación que tengas con Google.
503 Service Unavailable
App Engine puede tardar unos minutos en responder con éxito a las solicitudes. Si envías una solicitud y recibes un error 503, espera unos minutos y vuelve a enviarla. Si aún no recibes una respuesta correcta, revisa los registros de Cloud Logging. Los siguientes son algunos mensajes de error que podría aparecer en los registros de Cloud Logging.
Mensaje de error
Solución de problemas
No se encontró el servicio YOUR_PROJECT_ID.appspot.com o se denegó el permiso. Si este es un servicio de Endpoints nuevo, asegúrate de haber implementado la configuración de servicio con gcloud.
Endpoints Frameworks para Python registra este error cuando no logra cargar la configuración del servicio que especificaste en tu archivo app.yaml. Este error puede ocurrir cuando no implementaste el documento de OpenAPI para la API mediante gcloud endpoints services
deploy, o la API de Service Management no está habilitada. Cuando implementas el documento de OpenAPI para tu API, el comando de gcloud habilita automáticamente lo siguiente:
API de Service Management (servicemanagement.googleapis.com)
API de Cloud (cloudapis.googleapis.com)
Si inhabilitaste cualquiera de estos servicios, debes volver a habilitarlos. Consulta Inhabilita y habilita API para obtener más información.
Se encontró el servicio YOUR_PROJECT_ID.appspot.com, pero no se encontró la configuración de servicios para la versión SERVICE_CONFIG_ID.
Endpoints Frameworks para Python registra este error cuando no logra encontrar el ID de configuración del servicio que especificaste para ENDPOINTS_SERVICE_VERSION en tu archivo app.yaml.
Para corregir este error, sigue estos pasos:
Edita el archivo app.yaml y configura ENDPOINTS_SERVICE_VERSION en el ID de configuración de servicio.
Vuelve a implementar la app:
gcloudappdeploy
404 Not Found
Si migraste hace poco a la versión 2 de Endpoints Frameworks y recibes el mensaje de error 404 Not Found, consulta las siguientes secciones para solucionar el problema:
En algunas versiones de Windows PowerShell, el ejemplo Invoke-WebRequest de los instructivos falla. También recibimos un informe de que la respuesta contenía una lista de bytes sin firma que debían convertirse en caracteres. Si el ejemplo Invoke-WebRequest no mostró el resultado esperado, intenta enviar la solicitud con otra aplicación. A continuación, se muestran algunas sugerencias:
Inicia Cloud Shell y sigue los pasos para Linux del instructivo que usaste cuando enviaste la solicitud.
Usa una aplicación de terceros, como la extensión Postman del navegador Chrome (que ofrece www.getpostman.com). Cuando crees la solicitud en Postman, ejecuta el comando siguiente:
Selecciona POST como el verbo HTTP.
Para el encabezado, selecciona la clave content-type y el valor application/json.
Para el cuerpo, ingresa: {"message":"hello world"}
Ingresa la URL para la aplicación de muestra. Por ejemplo:
Instala curl, que se ejecuta en el símbolo de sistema. Debido a que Windows no maneja las comillas dobles anidadas entre comillas simples, debes cambiar la opción --data en el ejemplo, de la siguiente manera: --data "{\"message\":\"hello world\"}"
Usa los filtros para aprovechar las funciones del filtro avanzado, como la obtención de todas las solicitudes con una latencia mayor a 300 milésimas de segundo.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
