ads.proto 1.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. syntax = "proto3";
  2. package envoy.service.discovery.v3;
  3. import "envoy/service/discovery/v3/discovery.proto";
  4. import "udpa/annotations/status.proto";
  5. import "udpa/annotations/versioning.proto";
  6. option java_package = "io.envoyproxy.envoy.service.discovery.v3";
  7. option java_outer_classname = "AdsProto";
  8. option java_multiple_files = true;
  9. option go_package = "github.com/envoyproxy/go-control-plane/envoy/service/discovery/v3;discoveryv3";
  10. option java_generic_services = true;
  11. option (udpa.annotations.file_status).package_version_status = ACTIVE;
  12. // [#protodoc-title: Aggregated Discovery Service (ADS)]
  13. // Discovery services for endpoints, clusters, routes,
  14. // and listeners are retained in the package `envoy.api.v2` for backwards
  15. // compatibility with existing management servers. New development in discovery
  16. // services should proceed in the package `envoy.service.discovery.v2`.
  17. // See https://github.com/envoyproxy/envoy-api#apis for a description of the role of
  18. // ADS and how it is intended to be used by a management server. ADS requests
  19. // have the same structure as their singleton xDS counterparts, but can
  20. // multiplex many resource types on a single stream. The type_url in the
  21. // DiscoveryRequest/DiscoveryResponse provides sufficient information to recover
  22. // the multiplexed singleton APIs at the Envoy instance and management server.
  23. service AggregatedDiscoveryService {
  24. // This is a gRPC-only API.
  25. rpc StreamAggregatedResources(stream DiscoveryRequest) returns (stream DiscoveryResponse) {
  26. }
  27. rpc DeltaAggregatedResources(stream DeltaDiscoveryRequest)
  28. returns (stream DeltaDiscoveryResponse) {
  29. }
  30. }
  31. // [#not-implemented-hide:] Not configuration. Workaround c++ protobuf issue with importing
  32. // services: https://github.com/google/protobuf/issues/4221
  33. message AdsDummy {
  34. option (udpa.annotations.versioning).previous_message_type =
  35. "envoy.service.discovery.v2.AdsDummy";
  36. }