Solución de problemas

Esta página contiene información sobre la solución de problemas para cada versión de las siguientes API de Service Infrastructure:

  • La API de Service Management
  • API de Service Control
  • API de Service Consumer Management

¿Cómo manejo los errores de la API de Control de servicios en general?

La API de Control de servicios proporciona la funcionalidad de plano de control para los servicios administrados, por ejemplo, registros y supervisión. Por lo tanto, los emisores de la API de Control de servicios generalmente son aplicaciones de servidor. A continuación, se mencionan algunas recomendaciones generales sobre cómo manejar errores en el nivel de la API de REST/RPC:

  • El servidor debe registrar todos los errores que muestra la API de Control de servicios y puedes utilizar los datos para solucionar los problemas del servicio administrado.
  • Si el servidor recibe errores 429 de la API de Control de servicios, debe mostrar errores 429 a los clientes.
  • Si el servidor no puede acceder a la API de Control de servicios, puede optar entre una falla abierta (ignorar el error) o una falla cerrada (mostrar un error 503 al cliente).
  • Si el servidor recibe errores 500 en la API de Control de servicios, debe mostrar errores 500 a los clientes. Por lo general, tales errores representan fallas dentro de la API de Control de servicios.
  • Si el servidor recibe otros errores de la API de Control de servicios, debe mostrar errores 500 a los clientes. Por lo general, tales errores representan fallas dentro de tu servicio administrado.

¿Qué significa el error de "servicio no habilitado"?

A fin de utilizar cualquier servicio API de Google, debes tener un proyecto Google Cloud, habilitar el servicio para ese proyecto y pasar una clave de API o un token de acceso de OAuth asociado con el proyecto para cada solicitud de API. Consulta la Guía de Auth para obtener más detalles. Para corregir este error, debes habilitar el servicio para el proyecto mediante Google Cloud Console, Google Cloud CLI o la API de Service Usage. Para saber cómo habilitar un servicio, consulta Habilita e inhabilita servicios.

¿Cómo corrijo los errores de permiso denegado?

Por lo general, estos errores ocurren porque el emisor no tiene el permiso de administración de identidades y accesos adecuado en ciertos recursos. Para obtener más información sobre los permisos necesarios para cada una de las siguientes API de Service Infrastructure, consulta la página de Control de acceso correspondiente:

¿Cómo realizo un reintento en los errores de API?

Se recomienda realizar un reintento con intervalos exponenciales y aleatoriedad. El intervalo de reintento mínimo debe ser de 30 segundos para errores 429 de cuota; 1 segundo para errores 500 y 503 de servidor. Para otros errores, el reintento solo debe realizarse según la información de error adicional. Consulta google.rpc.Code para obtener más detalles.

¿Cómo solicito una cuota de API mayor?

Para obtener información sobre cómo solicitar cuotas mayores para cada una de las siguientes API de Service Infrastructure, visita la sección correspondiente de la página Cuotas y límites:

¿Cómo corrijo los errores de "No se puede verificar la propiedad del nombre de dominio"?

Este error indica que el emisor no tiene la propiedad del nombre de dominio que se usó para el nombre del servicio administrado que se especifica en la configuración del servicio. Sigue la guía para utilizar un dominio válido.