## 速率限制 - 速率限制[架構概述](../../Introduction/Architectureoverview/Globalratelimiting.md) - [v1 API 參考](../../v1APIreference/HTTPfilters/Ratelimit.md) - [v2 API 參考](../../v2APIreference/Filters/HTTPfilters/Ratelimit.md) 當請求的路由或虛擬主機有一個或多個符合過濾器設置的速率限制配置時，HTTP速率限制過濾器將調用速率限制服務。路由可以選擇包含虛擬主機速率限制配置。可配置多個應用于請求。每個配置描述符都會導致被發送到速率限制服務。 如果速率限制服務被調用，并且任何響應超出限制的描述符，都將返回429響應。 ### 組成操作 **注意：本文是為v1 API編寫的，但這些概念也適用于v2 API。它將在未來版本中使用v2 API重寫。** 路由或虛擬主機上的每個速率限制操作都需要一個描述符作為輸入。若要創建更復雜的速率限制描述符，可由一組描述符按任意順序進行組合操作。描述符將按照配置中指定操作的順序進行填充。 **例1** 例如，要生成以下描述符： ``` ("generic_key", "some_value") ("source_cluster", "from_cluster") ``` 配置將是： ``` { "actions" : [ { "type" : "generic_key", "descriptor_value" : "some_value" }, { "type" : "source_cluster" } ] } ``` **例2** 如果某個操作不附加描述符條目，則不會為該配置生成描述符。 對于以下配置： ``` { "actions" : [ { "type" : "generic_key", "descriptor_value" : "some_value" }, { "type" : "remote_address" }, { "type" : "souce_cluster" } ] } ``` 如果請求沒有設置[x-forwarded-for](../../Configurationreference/HTTPconnectionmanager/HTTPheadermanipulation.md)，則不會生成描述符。 如果請求設置了[x-forwarded-for](../../Configurationreference/HTTPconnectionmanager/HTTPheadermanipulation.md)，則會生成以下描述符： ``` ("generic_key", "some_value") ("remote_address", "<trusted address from x-forwarded-for>") ("source_cluster", "from_cluster") ``` ### 統計 緩沖區過濾器輸出集群中的統計信息以`cluster.<route target cluster>.ratelimit.`為命名空間。429響應被發送到正常的群集[動態HTTP統計](../../Configurationreference/Clustermanager/Statistics.md)。 | 名稱 | 類型 | 描述 | | ------------- | ------------- | ------------- | | ok | Counter | 低于限速請求的速率限制服務總數 | | error | Counter | 連接速率限制服務的失敗總數 | | over_limit | Counter | 高于限速請求的速率限制服務總數 | ### 運行時設置 HTTP速率限制過濾器支持以下運行時設置： - **ratelimit.http_filter_enabled**<br /> 將調用速率限制服務的請求的百分比。默認為100。 - **ratelimit.http_filter_enforcing**<br /> 將調用速率限制服務并執行決定的請求百分比。默認為100。這可以用來測試完全執行結果之前會發生什么。 - **ratelimit.`<route_key>`.http_filter_enabled**<br /> 將調用速率限制配置中指定的給定`route_key`的速率限制服務請求的百分比。默認為100。 ## 返回 - [上一級](../HTTPfilters.md) - [首頁目錄](../../README.md)