Cloud Endpoints proporciona cuotas que te permiten controlar la frecuencia con la que las aplicaciones pueden llamar a tu API. Las cuotas te permiten especificar límites de uso para proteger tu API frente a un número excesivo de solicitudes de aplicaciones que la llamen. Es posible que el exceso de solicitudes se haya debido a un simple error tipográfico o a un sistema diseñado de forma ineficiente que haga llamadas innecesarias a tu API. Independientemente de la causa, es necesario bloquear el tráfico de una fuente cuando alcanza un determinado nivel para mantener el buen estado general de tu API. Al definir una cuota, te aseguras de que una aplicación no afecte negativamente a otras aplicaciones que usen tu API.
En esta página se ofrece una descripción general de las funciones clave que proporcionan las cuotas.
Las solicitudes están vinculadas al proyecto del consumidor
Una vez que hayas configurado una cuota, Endpoints registrará el número de solicitudes por minuto y por proyecto de consumidor. Google Cloud Cada aplicación que llame a tu API debe cumplir los siguientes requisitos:
- Tener un Google Cloud proyecto.
- Haber habilitado la API en su proyectoGoogle Cloud .
- Enviar una clave de API. con cada solicitud a tu API. Esto permite que Endpoints identifique el proyectoGoogle Cloud con el que está asociada la aplicación que llama y que aumente el contador de solicitudes del proyecto Google Cloud .
Para obtener información sobre cómo configurar una clave de API, consulta lo siguiente:
- Java: restringir el acceso a la API con claves de API
- Python: restringir el acceso a la API con claves de API
Puedes pedir a los consumidores de tu API que creen sus propios proyectos en laGoogle Cloud consola o crear los proyectos por ellos. Como Endpoints aplica cuotas por proyecto, debes tener un proyecto por cada consumidor de la API.
Limitar el número de solicitudes por minuto
Si defines una cuota, puedes limitar el número de solicitudes por minuto a toda tu API o solo a métodos específicos. Si el código de cliente de un proyecto de consumidor supera el límite que has configurado, la solicitud se rechaza antes de llegar a tu API y se devuelve el código de estado HTTP 429 too many
requests. Las aplicaciones que llamen a la API deberán gestionar el código de estado 429 y usar retroceso exponencial u otra lógica de reintento para reducir la frecuencia de las llamadas a tu API.
Configurar una o varias cuotas
Puede configurar una o varias cuotas con nombre y especificar un límite de frecuencia diferente para cada cuota. Por ejemplo, puede que tu API tenga algunos métodos que consuman muchos recursos (como un método que ejecute una consulta compleja y devuelva una lista grande de resultados) y otros métodos que sean rápidos y ligeros. Puede que quieras configurar dos cuotas con límites de frecuencia diferentes y asociar los métodos que consumen muchos recursos a una cuota y los métodos ligeros a la otra.
Configurar un coste
Cuando asocias un método a una cuota, siempre especificas un coste para la solicitud. Esto permite que diferentes métodos consuman la misma cuota a diferentes velocidades. Puedes usar los costes como alternativa a la configuración de diferentes cuotas. Por ejemplo, supongamos que configura una cuota con un límite de 1000 solicitudes por minuto. En el caso de los métodos ligeros, se configura un coste de 1, lo que significa que los clientes pueden llamar a los métodos ligeros 1000 veces por minuto. En el caso de los métodos que requieren muchos recursos, se configura un coste de 2, lo que significa que cada vez que el cliente llama al método, el contador de solicitudes aumenta en 2 hasta alcanzar el límite de 1000. De esta forma, se limita el número de solicitudes de los métodos que consumen muchos recursos a 500 por minuto.
Anular la cuota configurada
En la página Endpoints > Services (Endpoints > Servicios) se muestra la cuota configurada para cada método de tu API. Si es necesario, puedes anular el límite configurado en un proyecto de consumidor específico. Para definir una anulación, debe introducir el número de proyecto del proyecto de consumidor en la página Endpoints (Endpoints) > Services (Servicios). Si no tienes acceso al proyecto de consumidor que quieres anular, debes ponerte en contacto con alguien que sí lo tenga para obtener el número de proyecto.