À propos des quotas

API Gateway vous permet de définir des quotas pour contrôler le débit auquel les applications peuvent appeler votre API. La définition d'un quota vous permet de spécifier des limites d'utilisation afin d'éviter que les applications appelantes n'envoient un nombre excessif de requêtes à l'API. Les requêtes excessives peuvent être causées par une simple faute de frappe ou par un système mal conçu qui appelle inutilement l'API.

Quelle qu'en soit la cause, il est nécessaire de bloquer le trafic provenant d'une source dès qu'il atteint un certain niveau afin de préserver l'état global de l'API. En définissant un quota, vous garantissez qu'une application donnée ne peut pas avoir d'impact négatif sur les autres applications qui utilisent l'API.

**Remarque** : Pour API Gateway, vous pouvez contrôler les quotas comme décrit dans la documentation Cloud Endpoints sur la page À propos des quotas.

Les quotas s'appliquent à l'ensemble de l'API

Vous définissez des métriques et des limites de quota dans une configuration d'API, mais API Gateway les applique à l'API qui possède la configuration d'API, et non à cette configuration d'API seule. Chaque fois que vous créez une configuration d'API, les métriques et les limites qu'elle déclare remplacent celles déclarées par les configurations d'API précédentes de l'API. Seules les métriques et les limites de la configuration d'API la plus récente sont appliquées.

Cela a deux conséquences lorsqu'une API comporte plusieurs configurations d'API déployées :

• La modification de la valeur d'une limite la modifie pour chaque passerelle de l'API, y compris les passerelles qui diffusent une configuration d'API antérieure.

• Le renommage ou la suppression d'une métrique laisse une configuration de quota non valide sur toute passerelle qui diffuse encore une configuration d'API antérieure. Les requêtes adressées aux méthodes de ces passerelles pour lesquelles un quota est appliqué échouent avec une erreur HTTP 500 et le message Failed to call Service Control Quota.

Attention : Vérifiez vos métriques et limites de quota pour vous assurer qu’elles sont cohérentes dans toutes les configurations actives. Si vous ne pouvez pas conserver des noms de métriques cohérents, mettez à jour chaque passerelle de l'API vers la configuration d'API la plus récente.

Pour trouver et corriger une configuration de quota non valide, consultez La requête d'API renvoie une erreur HTTP 500 pour une méthode pour laquelle un quota est appliqué.