Soluciona 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 Service Control en general?

La API de Service Control 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 Service Control 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 Service Control y puedes utilizar los datos para solucionar los problemas del servicio administrado.
  • Si el servidor recibe errores 429 de la API de Service Control, debe mostrar errores 429 a los clientes.
  • Si el servidor no puede acceder a la API de Service Control, 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 Service Control, debe mostrar errores 500 a los clientes. Por lo general, tales errores representan fallas dentro de la API de Service Control.
  • Si el servidor recibe otros errores de la API de Service Control, 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 en tu proyecto con la consola de Google Cloud, 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.