反模式：在配額政策中使用高基數 ID

您目前正在查看 Apigee 和 Apigee Hybrid 說明文件。
查看 Apigee Edge 說明文件。

配額政策用於計算 API Proxy 收到的要求數。API 供應商可透過這項功能，在一段時間內對應用程式發出的 API 呼叫次數強制設限。

配額政策可以包含 identifier 元素，用於識別每個要求計入的配額「bucket」。

反模式

使用配額政策時，請勿使用高基數 ID。

基數是指一組資料中不重複資料值的數量。高基數 ID 有大量不重複的可能值。高基數 ID 包括專屬要求 ID 或工作階段 ID，每次 API 呼叫都會變更。

使用高基數 ID 可能會大幅降低配額強制執行的效力。

影響

如果配額政策的 ID 元素使用高基數 ID，會導致下列情況：

• 配額強制執行無效：每個專屬 ID 都會視為個別計數器。如果每個要求都有新的專屬 ID，配額系統基本上會為每個 API 呼叫建立新的「儲存區」。也就是說，系統會根據個別單次使用的計數器來衡量整體配額限制，而不是根據您要限制的實際要求群組，因此這項政策無法用於控管流量。
• 資源耗用量增加：產生及管理大量不重複的配額計數器，會對 Apigee 平台造成不必要的負擔，導致資源用量增加，並可能產生效能問題。
• 監控挑戰：當資料分散在大量不重複的 ID 中時，監控及瞭解實際 API 用量趨勢就會變得困難。您將無法查看哪些應用程式、開發人員或產品正在耗用 API 資源。

最佳做法

選擇基數偏低或中等的 ID，這些 ID 也代表配額強制執行的穩定且有意義分組。這些功能可協助您有效管理 API 使用情形，並深入瞭解流量。例如：

• developer.app.name
• client_id
• apiproduct.name

有了適當的 ID，配額政策就能更有效地管理 API 流量、避免意外超出配額，並清楚瞭解使用模式。