xref: /aosp_15_r20/external/grpc-grpc/src/proto/grpc/testing/xds/v3/ads.proto (revision cc02d7e222339f7a4f6ba5f422e6413f4bd931f2)
1// Copyright 2020 The gRPC Authors
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15// Local copy of Envoy xDS proto file, used for testing only.
16
17syntax = "proto3";
18
19package envoy.service.discovery.v3;
20
21import "src/proto/grpc/testing/xds/v3/discovery.proto";
22
23// [#protodoc-title: Aggregated Discovery Service (ADS)]
24
25// [#not-implemented-hide:] Discovery services for endpoints, clusters, routes,
26// and listeners are retained in the package `envoy.api.v2` for backwards
27// compatibility with existing management servers. New development in discovery
28// services should proceed in the package `envoy.service.discovery.v2`.
29
30// See https://github.com/lyft/envoy-api#apis for a description of the role of
31// ADS and how it is intended to be used by a management server. ADS requests
32// have the same structure as their singleton xDS counterparts, but can
33// multiplex many resource types on a single stream. The type_url in the
34// DiscoveryRequest/DiscoveryResponse provides sufficient information to recover
35// the multiplexed singleton APIs at the Envoy instance and management server.
36service AggregatedDiscoveryService {
37  // This is a gRPC-only API.
38  rpc StreamAggregatedResources(stream DiscoveryRequest) returns (stream DiscoveryResponse) {
39  }
40}
41
42// [#not-implemented-hide:] Not configuration. Workaround c++ protobuf issue with importing
43// services: https://github.com/protocolbuffers/protobuf/issues/4221
44message AdsPhony {
45}
46