### 路由發現服務(RDS) ``` { "cluster": "...", "route_config_name": "...", "refresh_delay_ms": "..." } ``` - **cluster**<br /> (required, string) 承載路由發現服務的上游群集的名稱。群集必須實現和運行RDS HTTP API的REST服務。注：這是在群集管理器配置中定義的群集的名稱，而不是群集的完整定義，如SDS和CDS的情況。 - **route_config_name**<br /> (required, string) 路由配置的名稱。這個名字將被傳遞給RDS HTTP API。這允許具有多個HTTP監聽器（和關聯的HTTP連接管理器過濾器）的Envoy配置使用不同的路由配置。默認情況下，名稱的最大長度限制為60個字符。通過`--max-obj-name-len`命令行參數設置為所需的值，可以提高此限制。 - **refresh_delay_ms**<br /> (optional, integer) 每次從RDS API提取的時間間隔（以毫秒為單位）。Envoy將在0和`refresh_delay_ms`之間的增加一個額外的隨機抖動。因此，最長可能的刷新間隔是`2*refresh_delay_ms`。默認值是30000ms（30秒）。 ### REST API ``` GET /v1/routes/(string: route_config_name)/(string: service_cluster)/(string: service_node) ``` 請求路由發現服務返回特定`route_config_name`，`service_cluster`和`service_node`的路由配置。`route_config_name`對應于上面的RDS配置參數。`service_cluster` 對應于`--service-cluster` 命令行選項。`service_node`對應于`--service-node` 命令行選項。響應是單個JSON對象，其中包含路由配置文檔中定義的[路由配置](../../v1APIreference/HTTPRouteconfiguration.md)。 新的路由配置將被優雅地交換，使得現有的請求不受影響。這意味著當一個請求開始時，它會看到一個一致的快照，在請求的持續時間內不會改變路由配置。因此，例如，如果更新更改超時值，則只有新的請求將使用更新后的值。 作為性能優化，Envoy對從RDS API接收的路由配置進行哈希散列處理，并且只有在哈希值發生變化時才會執行完整的重新加載。 注意：通過RDS加載的路由配置不會檢查所引用的集群是否已經在集群管理器加載。RDS API被設計為與CDS API一起工作，使得Envoy最終采取一致的更新。如果一個路由引用一個未知的集群，路由器過濾器將返回一個404響應。 ## 返回 - [上一級](../HTTPRouteconfiguration.md) - [首頁目錄](../../README.md)