### 速率限制配置 全局速率限制[架構概述](../../Introduction/Architectureoverview/Globalratelimiting.md)。 ``` { "stage": "...", "disable_key": "...", "actions": [] } ``` - **stage**<br /> (optional, integer) 指在過濾器中設置的階段。速率限制配置僅適用于具有相同階段編號的過濾器。默認的階段編號是0。 注意：對于階段編號，過濾器支持0-10的范圍。 - **disable_key**<br /> (optional, string) 在運行時設置的key，用于禁用此速率限制配置。 - **actions**<br /> (required, array) 將應用于此速率限制配置的操作列表。順序很重要，因為這些操作是按順序處理的，描述符是通過在該順序中附加描述符條目來組成的。如果某個操作無法附加描述符條目，則不會為該配置生成描述符。請參閱相關[操作文檔](../../Configurationreference/HTTPfilters/Ratelimit.md)。 ### Actions ``` { "type": "..." } ``` - **type**<br /> (required, string) 要執行的速率限制操作的類型。當前支持的操作類型是`source_cluster`，`destination_cluster`，`request_headers`，`remote_address`，`generic_key`和`header_value_match`。 ### Source Cluster ``` { "type": "source_cluster" } ``` 以下描述符條目被追加到描述符中： ``` ("source_cluster", "<local service cluster>") ``` `<local service cluster>` 是從 `--service-cluster` 選項派生出來的. ### Destination Cluster ``` { "type": "destination_cluster" } ``` 以下描述符條目被追加到描述符中： ``` ("destination_cluster", "<routed target cluster>") ``` 一旦請求與路由表規則匹配，路由的集群就由以下路由表配置設置之一確定： - [cluster](../../v1APIreference/HTTPRouteconfiguration/Route.md#cluster) 指定要路由到的上游群集。 - [weighted_clusters](../../v1APIreference/HTTPRouteconfiguration/Route.md#weighted_clusters) 從一組具有權重屬性的集群組中隨機選擇一個集群。 - [cluster_header](../../v1APIreference/HTTPRouteconfiguration/Route.md#cluster_header) 指定從請求中的頭部獲取目標群集。 ### Request Headers ``` { "type": "request_headers", "header_name": "...", "descriptor_key" : "..." } ``` - **header_name**<br /> (required, string) 要從請求頭中查詢的該頭的名稱。頭的值用于填充`descriptor_key`的描述符條目的值。 - **descriptor_key**<br /> (required, string) 在描述符條目中使用的關鍵。 當一個頭包含一個與`header_name`匹配的關鍵字時，附加下面的描述符條目： ``` ("<descriptor_key>", "<header_value_queried_from_header>") ``` ### Remote Address ``` { "type": "remote_address" } ``` 以下描述符條目被追加到描述符中，并使用來自[x-forwarded-for](../../Configurationreference/HTTPconnectionmanager/HTTPheadermanipulation.md#x-forwarded-for)的可信地址填充： ``` ("remote_address", "<trusted address from x-forwarded-for>") ``` ### Generic Key ``` { "type": "generic_key", "descriptor_value" : "..." } ``` - **descriptor_value**<br /> (required, string) 描述符條目中使用的值。 以下描述符條目被追加到描述符中： ``` ("generic_key", "<descriptor_value>") ``` ### Header Value Match ``` { "type": "header_value_match", "descriptor_value" : "...", "expect_match" : "...", "headers" : [] } ``` - **descriptor_value**<br /> (required, string) 描述符條目中使用的值。 - **expect_match**<br /> (optional, boolean) 如果設置為true，則該操作將在請求與頭部匹配時附加描述符條目。如果設置為false，則該操作將在請求與頭部不匹配時附加描述符條目。默認值是true。 - **[headers](../../v1APIreference/HTTPRouteconfiguration/Route.md#headers)**<br /> (required, array) 指定速率限制操作應匹配的一組頭。將檢查請求的頭部與配置中所有指定的頭部。如果配置中的所有報頭都存在于具有相同值的請求中（或者如果沒有配置`value`字段，則認為存在），則匹配將發生。 以下描述符條目被追加到描述符中`: .. code-block:: cpp` ``` (“header_match”, “<descriptor_value>”) ``` ## 返回 - [上一級](../HTTPRouteconfiguration.md) - [首頁目錄](../../README.md)