配額簡介
API Gateway 提供配額,讓您控管應用程式呼叫 API 的頻率。您可以設定配額來指定使用量限制,藉此保護 API 免於收到呼叫應用程式的過量要求。要求過多可能是因為簡單的錯字,或是系統設計不當,導致對 API 發出不必要的要求。
無論原因為何,一旦流量達到特定程度,就必須封鎖來源流量,才能確保 API 整體運作正常。設定配額後,即可確保單一應用程式不會對使用您 API 的其他應用程式造成負面影響。
配額適用於整個 API
您可以在 API 設定中定義配額指標和限制,但 API Gateway 會將這些指標和限制套用至擁有 API 設定的 API,而不是單獨套用至該 API 設定。每次建立 API 設定時,系統都會以該設定宣告的指標和限制,取代先前 API 設定宣告的指標和限制。系統只會強制執行最近建立的 API 設定中的指標和限制。
如果 API 部署多個 API 設定,會造成以下兩種後果:
變更限制的值會影響 API 的每個閘道,包括提供較早 API 設定的閘道。
如果閘道仍提供舊版 API 設定,重新命名或移除指標會導致配額設定無效。如果對這些閘道的配額強制執行方法提出要求,系統會傳回 HTTP
500錯誤,並顯示Failed to call Service Control Quota.訊息。
如要找出並修正無效的配額設定,請參閱「API 要求針對配額強制執行的方法傳回 HTTP 500 錯誤」。