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