Informazioni sulle quote

API Gateway fornisce quote che consentono di controllare la frequenza con cui le applicazioni possono chiamare l'API. L'impostazione di una quota consente di specificare i limiti di utilizzo per proteggere l'API da un numero eccessivo di richieste dalle applicazioni chiamanti. Le richieste eccessive potrebbero essere state causate da un semplice errore di battitura o da un sistema progettato in modo inefficiente che effettua chiamate non necessarie all'API.

Indipendentemente dalla causa, bloccare il traffico da un'origine una volta raggiunto un determinato livello è necessario per la salute generale dell'API. Impostando una quota, ti assicuri che un'applicazione non possa influire negativamente su altre applicazioni che utilizzano la tua API.

Le quote si applicano all'intera API

Definisci le metriche e i limiti delle quote in una configurazione API, ma API Gateway li applica all'API proprietaria della configurazione API, non solo a quest'ultima. Ogni volta che crei una configurazione API, le metriche e i limiti che dichiara sostituiscono quelli dichiarati dalle configurazioni API precedenti dell'API. Vengono applicate solo le metriche e i limiti della configurazione API creata più di recente.

Ciò ha due conseguenze quando un'API ha più di una configurazione API di cui è stato eseguito il deployment:

  • La modifica del valore di un limite lo modifica per ogni gateway dell'API, inclusi i gateway che erogano una configurazione API precedente.

  • La ridenominazione o la rimozione di una metrica lascia una configurazione delle quote non valida su qualsiasi gateway che pubblica ancora una configurazione API precedente. Le richieste ai metodi con applicazione delle quote di questi gateway non vanno a buon fine e restituiscono un errore HTTP 500 e il messaggio Failed to call Service Control Quota.

Per trovare e correggere una configurazione delle quote non valida, consulta La richiesta API restituisce un errore HTTP 500 per un metodo con applicazione delle quote.