Vous consultez la documentation Apigee Edge.
Accédez à la
documentation**Apigee X**. info
La règle Quota permet de comptabiliser le nombre de requêtes reçues par un proxy d'API. Cette fonctionnalité permet aux fournisseurs d'API d'appliquer des limites sur le nombre d'appels d'API effectués par des applications sur un intervalle de temps donné.
La règle Quota peut inclure un
identifier élément qui identifie le "compartiment" de quota dans lequel chaque requête est
comptabilisée.
Antimodèle
Lorsque vous utilisez la règle Quota, n'utilisez pas d'identifiants à forte cardinalité.
La cardinalité fait référence au nombre de valeurs de données uniques dans un ensemble. Un identifiant à forte cardinalité comporte un grand nombre de valeurs distinctes possibles. Les identifiants à forte cardinalité incluent des ID de requête ou des ID de session uniques qui changent à chaque appel d'API.
L'utilisation d'identifiants à forte cardinalité peut nuire considérablement à l'efficacité de l'application de votre quota
Impact
L'utilisation d'identifiants à forte cardinalité pour l'élément d'identifiant de votre règle de quota entraîne les conséquences suivantes :
- Application inefficace du quota : chaque identifiant unique est traité comme un compteur distinct. Si chaque requête possède un ID unique, votre système de quota crée essentiellement un nouveau "compartiment" pour chaque appel d'API. Cela signifie votre limite de quota globale est mesurée par rapport à des compteurs individuels à usage unique plutôt que par rapport à des groupes de requêtes réels que vous souhaitez limiter, ce qui rend la règle inutile pour le contrôle du trafic.
- Consommation accrue de ressources : la génération et la gestion d'un nombre massif de compteurs de quota uniques exercent une pression inutile sur la plate-forme Apigee, ce qui entraîne une augmentation de l'utilisation des ressources et des problèmes de performances potentiels.
- Difficultés de surveillance : il devient difficile de surveiller et de comprendre les tendances réelles de consommation de l'API lorsque les données sont fragmentées sur un grand nombre d'identifiants uniques. Vous ne pouvez plus voir quelles applications, développeurs ou quels produits consomment vos ressources d'API.
Bonne pratique
Choisissez des identifiants à cardinalité faible à moyenne qui représentent également un regroupement stable et significatif pour l'application du quota. Cela vous permet de gérer efficacement l'utilisation de l'API et d'obtenir des insights sur votre trafic. Voici quelques exemples :
- developer.app.name
- client_id
- apiproduct.name
Avec des identifiants appropriés, votre règle Quota peut gérer plus efficacement le trafic d'API, éviter les dépassements involontaires et fournir des insights clairs sur les modèles d'utilisation.