srds.proto 1.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051
  1. syntax = "proto3";
  2. package envoy.api.v2;
  3. import "envoy/api/v2/discovery.proto";
  4. import "google/api/annotations.proto";
  5. import "envoy/annotations/resource.proto";
  6. import "udpa/annotations/migrate.proto";
  7. import "udpa/annotations/status.proto";
  8. import public "envoy/api/v2/scoped_route.proto";
  9. option java_package = "io.envoyproxy.envoy.api.v2";
  10. option java_outer_classname = "SrdsProto";
  11. option java_multiple_files = true;
  12. option go_package = "github.com/envoyproxy/go-control-plane/envoy/api/v2;apiv2";
  13. option java_generic_services = true;
  14. option (udpa.annotations.file_migrate).move_to_package = "envoy.service.route.v3";
  15. option (udpa.annotations.file_status).package_version_status = FROZEN;
  16. // [#protodoc-title: SRDS]
  17. // * Routing :ref:`architecture overview <arch_overview_http_routing>`
  18. // The Scoped Routes Discovery Service (SRDS) API distributes
  19. // :ref:`ScopedRouteConfiguration<envoy_api_msg.ScopedRouteConfiguration>`
  20. // resources. Each ScopedRouteConfiguration resource represents a "routing
  21. // scope" containing a mapping that allows the HTTP connection manager to
  22. // dynamically assign a routing table (specified via a
  23. // :ref:`RouteConfiguration<envoy_api_msg_RouteConfiguration>` message) to each
  24. // HTTP request.
  25. service ScopedRoutesDiscoveryService {
  26. option (envoy.annotations.resource).type = "envoy.api.v2.ScopedRouteConfiguration";
  27. rpc StreamScopedRoutes(stream DiscoveryRequest) returns (stream DiscoveryResponse) {
  28. }
  29. rpc DeltaScopedRoutes(stream DeltaDiscoveryRequest) returns (stream DeltaDiscoveryResponse) {
  30. }
  31. rpc FetchScopedRoutes(DiscoveryRequest) returns (DiscoveryResponse) {
  32. option (google.api.http).post = "/v2/discovery:scoped-routes";
  33. option (google.api.http).body = "*";
  34. }
  35. }
  36. // [#not-implemented-hide:] Not configuration. Workaround c++ protobuf issue with importing
  37. // services: https://github.com/google/protobuf/issues/4221 and protoxform to upgrade the file.
  38. message SrdsDummy {
  39. }