Estás viendo la documentación de Apigee Edge.
Ir a la documentación de
Apigee X. info
La política de cuotas se usa para contar la cantidad de solicitudes que recibe un proxy de API. Esta capacidad permite que los proveedores de API apliquen límites a la cantidad de llamadas a la API que realizan las aplicaciones en un intervalo de tiempo.
La política de cuotas puede incluir un elemento
identifier que identifica el "bucket" de cuota en el que se cuenta cada solicitud.
Antipatrón
Cuando uses la política de cuotas, no uses identificadores de alta cardinalidad.
La cardinalidad se refiere a la cantidad de valores de datos únicos en un conjunto. Un identificador con alta cardinalidad tiene una gran cantidad de valores posibles distintos. Los identificadores de alta cardinalidad incluyen IDs de solicitud únicos o IDs de sesión que cambian con cada llamada a la API.
El uso de identificadores de alta cardinalidad puede socavar significativamente la eficacia de la aplicación de la cuota.
Impacto
El uso de identificadores de alta cardinalidad para el elemento identificador de la política de cuotas genera los siguientes problemas:
- Aplicación ineficaz de la cuota: Cada identificador único se trata como un contador independiente. Si cada solicitud tiene un ID nuevo y único, tu sistema de cuotas crea, esencialmente, un "bucket" nuevo para cada llamada a la API. Esto significa que tu límite de cuota general se mide en función de contadores individuales de un solo uso, en lugar de los grupos reales de solicitudes que deseas limitar, lo que hace que la política sea inútil para el control del tráfico.
- Mayor consumo de recursos: Generar y administrar una gran cantidad de contadores de cuota únicos ejerce una presión innecesaria sobre la plataforma de Apigee, lo que genera un mayor uso de recursos y posibles problemas de rendimiento.
- Desafíos de la supervisión: Resulta difícil supervisar y comprender las tendencias reales de consumo de la API cuando los datos se fragmentan en una gran cantidad de identificadores únicos. Perderás la capacidad de ver qué aplicaciones, desarrolladores o productos consumen tus recursos de API.
Práctica recomendada
Elige identificadores con una cardinalidad de baja a media que también representen una agrupación estable y significativa para la aplicación de la cuota. Te ayudan a administrar el uso de la API de manera eficaz y a obtener estadísticas sobre tu tráfico. Los siguientes son algunos ejemplos:
- developer.app.name
- client_id
- apiproduct.name
Con identificadores adecuados, tu política de cuotas puede administrar el tráfico de la API de manera más eficaz, evitar excesos no deseados y proporcionar estadísticas claras sobre los patrones de uso.