發現API · ENVOY 智能代理中文參考文檔

## 通用發現服務接口 - [DiscoveryRequest](#discoveryrequest) - [DiscoveryResponse](#discoveryresponse) ### DiscoveryRequest [DiscoveryRequest proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/discovery.proto#L24) 發現請求：是指在通過某些API，為Envoy節點請求一組相同類型的帶版本標簽的資源。 ``` { "version_info": "...", "node": "{...}", "resource_names": [], "type_url": "...", "response_nonce": "..." } ``` - **version_info** ([string](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 請求消息所攜帶的版本信息，將是最近成功處理的響應中收到的版本信息，第一個請求中`version_info`為空。在收到響應之前不會發送新的請求，直到Envoy實例準備好ACK/NACK新配置為止。ACK/NACK分別通過返回應用的新API配置版本或先前的API配置版本來進行。每個`type_url`（見下文）都有一個獨立的版本信息。 - **node** ([Node](Commontypes.md)) 發出請求的節點信息 - **resource_names** ([string](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 要訂閱的資源列表，群集名稱列表或路由配置名稱。如果為空，則返回該API的所有資源。LDS/CDS期望`resource_names`為空，因為這是Envoy實例的全局資源。LDS和CDS響應將意味著需要通過EDS/RDS獲取的一些資源，這些資源將會在`resource_names`中列出。 - **type_url** ([string](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 正在請求的資源的類型，例如“type.googleapis.com/envoy.api.v2.ClusterLoadAssignment”。在單獨的xDS API（例如CDS，LDS等）的請求中，資源類型不可見，但對于ADS是必需的。 - **response_nonce** ([string](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 對應于DiscoveryResponse的nonce的ACK/NACK。請參閱關于`version_info`和[DiscoveryResponse](#discoveryresponse) nonce上述的討論。如果`nonce`不可用，則這可能是空的。以支持啟動或非流xDS的實現。 ### DiscoveryResponse [DiscoveryResponse proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/discovery.proto#L58) ``` { "version_info": "...", "resources": [], "type_url": "...", "nonce": "..." } ``` - **version_info** ([string](#)) 響應數據的版本信息 - **resources** ([Any](#)) 響應資源。關于這些資源的類型，取決于被調用的API。 - **type_url** ([string](#)) 資源的URL。如果資源非空，任何消息中的`type_url`必須與資源保持一致。這可以有效地識別在ADS上混合提供的xDS API。 - **nonce** ([string](#)) 對于基于gRPC的訂閱，nonce提供了一種方法來顯式確認以下`DiscoveryRequest`中的特定`DiscoveryResponse`。在此發現響應之前，Envoy可能會向流管理服務器發送其他消息，以便在響應發送時未經處理。nonce允許管理服務器忽略前一版本的任何進一步發現請求，直到當前的發現請求。nonce是可選的，對于基于非流的xDS實現，不是必需的。 ## 返回 - [上一級](../v2APIreference.md) - [首頁目錄](../README.md)