Skip to content

Commit 3e142f3

Browse files
committed
envoy-types: update generated files
1 parent 0bb3951 commit 3e142f3

File tree

61 files changed

+1695
-400
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

61 files changed

+1695
-400
lines changed

envoy-types/src/generated/envoy.admin.v3.rs

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -262,8 +262,8 @@ pub struct HostStatus {
262262
///
263263
/// .. note::
264264
///
265-
/// The message will be missing if the host didnt receive enough traffic to compute a success rate, or if the
266-
/// cluster didnt have enough hosts to perform outlier ejection based on success rate.
265+
/// The message will be missing if the host didn't receive enough traffic to compute a success rate, or if the
266+
/// cluster didn't have enough hosts to perform outlier ejection based on success rate.
267267
#[prost(message, optional, tag = "8")]
268268
pub local_origin_success_rate: ::core::option::Option<
269269
super::super::r#type::v3::Percent,
@@ -289,18 +289,22 @@ pub struct HostHealthStatus {
289289
/// health checking.
290290
#[prost(bool, tag = "5")]
291291
pub pending_dynamic_removal: bool,
292-
/// The host has not yet been health checked.
292+
/// The host is awaiting first health check.
293293
#[prost(bool, tag = "6")]
294294
pub pending_active_hc: bool,
295295
/// The host should be excluded from panic, spillover, etc. calculations because it was explicitly
296296
/// taken out of rotation via protocol signal and is not meant to be routed to.
297297
#[prost(bool, tag = "7")]
298298
pub excluded_via_immediate_hc_fail: bool,
299-
/// The host failed active HC due to timeout.
299+
/// The host failed active health check due to timeout.
300300
#[prost(bool, tag = "8")]
301301
pub active_hc_timeout: bool,
302-
/// Health status as reported by EDS. Note: only HEALTHY and UNHEALTHY are currently supported
303-
/// here.
302+
/// Health status as reported by EDS.
303+
///
304+
/// .. note::
305+
///
306+
/// Currently, only `HEALTHY` and `UNHEALTHY` are supported.
307+
///
304308
/// \[\#comment:TODO(mrice32): pipe through remaining EDS health status possibilities.\]
305309
#[prost(enumeration = "super::super::config::core::v3::HealthStatus", tag = "3")]
306310
pub eds_health_status: i32,

envoy-types/src/generated/envoy.config.bootstrap.v3.rs

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -305,9 +305,7 @@ pub mod bootstrap {
305305
>,
306306
/// If a network based configuration source is specified for :ref:`cds_config <envoy_v3_api_field_config.bootstrap.v3.Bootstrap.DynamicResources.cds_config>`, it's necessary
307307
/// to have some initial cluster definitions available to allow Envoy to know
308-
/// how to speak to the management server. These cluster definitions may not
309-
/// use :ref:`EDS <arch_overview_dynamic_config_eds>` (i.e. they should be static
310-
/// IP or DNS-based).
308+
/// how to speak to the management server.
311309
#[prost(message, repeated, tag = "2")]
312310
pub clusters: ::prost::alloc::vec::Vec<
313311
super::super::super::cluster::v3::Cluster,

envoy-types/src/generated/envoy.config.cluster.v3.rs

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -429,11 +429,13 @@ pub struct Cluster {
429429
pub name: ::prost::alloc::string::String,
430430
///
431431
/// An optional alternative to the cluster name to be used for observability. This name is used
432-
/// emitting stats for the cluster and access logging the cluster name. This will appear as
432+
/// for emitting stats for the cluster and access logging the cluster name. This will appear as
433433
/// additional information in configuration dumps of a cluster's current status as
434434
/// : ref:`observability_name <envoy_v3_api_field_admin.v3.ClusterStatus.observability_name>`
435-
/// and as an additional tag "upstream_cluster.name" while tracing. Note: Any `:` in the name
436-
/// will be converted to `_` when emitting statistics. This should not be confused with
435+
/// and as an additional tag "upstream_cluster.name" while tracing.
436+
///
437+
/// .. note::
438+
/// Any `:` in the name will be converted to `_` when emitting statistics. This should not be confused with
437439
/// : ref:`Router Filter Header <config_http_filters_router_x-envoy-upstream-alt-stat-name>`.
438440
#[prost(string, tag = "28")]
439441
pub alt_stat_name: ::prost::alloc::string::String,
@@ -1489,7 +1491,8 @@ pub mod cluster {
14891491
/// If this is not set, we default to a merge window of 1000ms. To disable it, set the merge
14901492
/// window to 0.
14911493
///
1492-
/// Note: merging does not apply to cluster membership changes (e.g.: adds/removes); this is
1494+
/// .. note::
1495+
/// Merging does not apply to cluster membership changes (e.g.: adds/removes); this is
14931496
/// because merging those updates isn't currently safe. See
14941497
/// <https://github.com/envoyproxy/envoy/pull/3941.>
14951498
#[prost(message, optional, tag = "4")]

envoy-types/src/generated/envoy.config.common.matcher.v3.rs

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,8 @@
99
/// Please use the syntactically equivalent :ref:`matching API <envoy_v3_api_msg_.xds.type.matcher.v3.Matcher>`
1010
#[derive(Clone, PartialEq, ::prost::Message)]
1111
pub struct Matcher {
12-
/// Optional OnMatch to use if the matcher failed.
13-
/// If specified, the OnMatch is used, and the matcher is considered
12+
/// Optional `OnMatch` to use if the matcher failed.
13+
/// If specified, the `OnMatch` is used, and the matcher is considered
1414
/// to have matched.
1515
/// If not specified, the matcher is considered not to have matched.
1616
#[prost(message, optional, boxed, tag = "3")]
@@ -25,6 +25,17 @@ pub mod matcher {
2525
/// What to do if a match is successful.
2626
#[derive(Clone, PartialEq, ::prost::Message)]
2727
pub struct OnMatch {
28+
/// If true, the action will be taken but the caller will behave as if no
29+
/// match was found. This applies both to actions directly encoded in the
30+
/// action field and to actions returned from a nested matcher tree in the
31+
/// matcher field. A subsequent matcher on_no_match action will be used
32+
/// instead.
33+
///
34+
/// This field is not supported in all contexts in which the matcher API is
35+
/// used. If this field is set in a context in which it's not supported,
36+
/// the resource will be rejected.
37+
#[prost(bool, tag = "3")]
38+
pub keep_matching: bool,
2839
#[prost(oneof = "on_match::OnMatch", tags = "1, 2")]
2940
pub on_match: ::core::option::Option<on_match::OnMatch>,
3041
}
@@ -109,7 +120,7 @@ pub mod matcher {
109120
/// A list of predicates to be AND-ed together.
110121
#[prost(message, tag = "3")]
111122
AndMatcher(PredicateList),
112-
/// The invert of a predicate
123+
/// The inverse of a predicate
113124
#[prost(message, tag = "4")]
114125
NotMatcher(::prost::alloc::boxed::Box<super::Predicate>),
115126
}
@@ -243,9 +254,9 @@ pub struct HttpHeadersMatch {
243254
///
244255
/// .. attention::
245256
///
246-
/// Searching for patterns in HTTP body is potentially cpu intensive. For each specified pattern, http body is scanned byte by byte to find a match.
257+
/// Searching for patterns in HTTP body is potentially CPU-intensive. For each specified pattern, HTTP body is scanned byte by byte to find a match.
247258
/// If multiple patterns are specified, the process is repeated for each pattern. If location of a pattern is known, `bytes_limit` should be specified
248-
/// to scan only part of the http body.
259+
/// to scan only part of the HTTP body.
249260
#[derive(Clone, PartialEq, ::prost::Message)]
250261
pub struct HttpGenericBodyMatch {
251262
/// Limits search to specified number of bytes - default zero (no limit - match entire captured buffer).

envoy-types/src/generated/envoy.config.core.v3.rs

Lines changed: 47 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -215,9 +215,14 @@ pub struct SocketAddress {
215215
/// IPv6 space as `::FFFF:<IPv4-address>`.
216216
#[prost(bool, tag = "6")]
217217
pub ipv4_compat: bool,
218-
/// The Linux network namespace to bind the socket to. If this is set, Envoy will
219-
/// create the socket in the specified network namespace. Only supported on Linux.
220-
/// \[\#not-implemented-hide:\]
218+
/// Filepath that specifies the Linux network namespace this socket will be created in (see `man 7 network_namespaces`). If this field is set, Envoy will create the socket in the specified
219+
/// network namespace.
220+
///
221+
/// .. note::
222+
/// Setting this parameter requires Envoy to run with the `CAP_NET_ADMIN` capability.
223+
///
224+
/// .. attention::
225+
/// Network namespaces are only configurable on Linux. Otherwise, this field has no effect.
221226
#[prost(string, tag = "7")]
222227
pub network_namespace_filepath: ::prost::alloc::string::String,
223228
#[prost(oneof = "socket_address::PortSpecifier", tags = "3, 4")]
@@ -1976,7 +1981,8 @@ pub mod health_check {
19761981
/// `/healthcheck`.
19771982
#[prost(string, tag = "2")]
19781983
pub path: ::prost::alloc::string::String,
1979-
/// \[\#not-implemented-hide:\] HTTP specific payload.
1984+
/// HTTP specific payload to be sent as the request body during health checking.
1985+
/// If specified, the method should support a request body (POST, PUT, PATCH, etc.).
19801986
#[prost(message, optional, tag = "3")]
19811987
pub send: ::core::option::Option<Payload>,
19821988
/// Specifies a list of HTTP expected responses to match in the first `response_buffer_size` bytes of the response body.
@@ -2043,7 +2049,8 @@ pub mod health_check {
20432049
super::super::super::super::r#type::matcher::v3::StringMatcher,
20442050
>,
20452051
/// HTTP Method that will be used for health checking, default is "GET".
2046-
/// GET, HEAD, POST, PUT, DELETE, OPTIONS, TRACE, PATCH methods are supported, but making request body is not supported.
2052+
/// GET, HEAD, POST, PUT, DELETE, OPTIONS, TRACE, PATCH methods are supported.
2053+
/// Request body payloads are supported for POST, PUT, PATCH, and OPTIONS methods only.
20472054
/// CONNECT method is disallowed because it is not appropriate for health check request.
20482055
/// If a non-200 response is expected by the method, it needs to be set in :ref:`expected_statuses <envoy_v3_api_field_config.core.v3.HealthCheck.HttpHealthCheck.expected_statuses>`.
20492056
#[prost(enumeration = "super::RequestMethod", tag = "13")]
@@ -2568,8 +2575,11 @@ pub struct QuicProtocolOptions {
25682575
/// `Initial stream-level flow-control receive window <<https://tools.ietf.org/html/draft-ietf-quic-transport-34#section-4.1>`\_> size. Valid values range from
25692576
/// 1 to 16777216 (2^24, maximum supported by QUICHE) and defaults to 16777216 (16 * 1024 * 1024).
25702577
///
2571-
/// NOTE: 16384 (2^14) is the minimum window size supported in Google QUIC. If configured smaller than it, we will use 16384 instead.
2572-
/// QUICHE IETF Quic implementation supports 1 bytes window. We only support increasing the default window size now, so it's also the minimum.
2578+
/// .. note::
2579+
///
2580+
/// 16384 (2^14) is the minimum window size supported in Google QUIC. If configured smaller than it, we will use
2581+
/// 16384 instead. QUICHE IETF Quic implementation supports 1 bytes window. We only support increasing the default
2582+
/// window size now, so it's also the minimum.
25732583
///
25742584
/// This field also acts as a soft limit on the number of bytes Envoy will buffer per-stream in the
25752585
/// QUIC stream send and receive buffers. Once the buffer reaches this pointer, watermark callbacks will fire to
@@ -2579,10 +2589,12 @@ pub struct QuicProtocolOptions {
25792589
super::super::super::super::google::protobuf::UInt32Value,
25802590
>,
25812591
/// Similar to `initial_stream_window_size`, but for connection-level
2582-
/// flow-control. Valid values rage from 1 to 25165824 (24MB, maximum supported by QUICHE) and defaults
2592+
/// flow-control. Valid values range from 1 to 25165824 (24MB, maximum supported by QUICHE) and defaults
25832593
/// to 25165824 (24 * 1024 * 1024).
25842594
///
2585-
/// NOTE: 16384 (2^14) is the minimum window size supported in Google QUIC. We only support increasing the default
2595+
/// .. note::
2596+
///
2597+
/// 16384 (2^14) is the minimum window size supported in Google QUIC. We only support increasing the default
25862598
/// window size now, so it's also the minimum.
25872599
#[prost(message, optional, tag = "3")]
25882600
pub initial_connection_window_size: ::core::option::Option<
@@ -2768,7 +2780,7 @@ pub struct HttpProtocolOptions {
27682780
/// The default value for responses can be overridden by setting runtime key `envoy.reloadable_features.max_response_headers_count`.
27692781
/// Downstream requests that exceed this limit will receive a 431 response for HTTP/1.x and cause a stream
27702782
/// reset for HTTP/2.
2771-
/// Upstream responses that exceed this limit will result in a 503 response.
2783+
/// Upstream responses that exceed this limit will result in a 502 response.
27722784
#[prost(message, optional, tag = "2")]
27732785
pub max_headers_count: ::core::option::Option<
27742786
super::super::super::super::google::protobuf::UInt32Value,
@@ -2783,9 +2795,12 @@ pub struct HttpProtocolOptions {
27832795
/// : ref:`HTTP Connection Manager <envoy_v3_api_field_extensions.filters.network.http_connection_manager.v3.HttpConnectionManager.common_http_protocol_options>`.
27842796
///
27852797
///
2786-
/// Note: currently some protocol codecs impose limits on the maximum size of a single header:
2787-
/// HTTP/2 (when using nghttp2) limits a single header to around 100kb.
2788-
/// HTTP/3 limits a single header to around 1024kb.
2798+
/// .. note::
2799+
///
2800+
/// Currently some protocol codecs impose limits on the maximum size of a single header.
2801+
///
2802+
/// * HTTP/2 (when using nghttp2) limits a single header to around 100kb.
2803+
/// * HTTP/3 limits a single header to around 1024kb.
27892804
#[prost(message, optional, tag = "7")]
27902805
pub max_response_headers_kb: ::core::option::Option<
27912806
super::super::super::super::google::protobuf::UInt32Value,
@@ -2798,9 +2813,15 @@ pub struct HttpProtocolOptions {
27982813
>,
27992814
/// Action to take when a client request with a header name containing underscore characters is received.
28002815
/// If this setting is not specified, the value defaults to ALLOW.
2801-
/// Note: upstream responses are not affected by this setting.
2802-
/// Note: this only affects client headers. It does not affect headers added
2803-
/// by Envoy filters and does not have any impact if added to cluster config.
2816+
///
2817+
/// .. note::
2818+
///
2819+
/// Upstream responses are not affected by this setting.
2820+
///
2821+
/// .. note::
2822+
///
2823+
/// This only affects client headers. It does not affect headers added by Envoy filters and does not have any
2824+
/// impact if added to cluster config.
28042825
#[prost(
28052826
enumeration = "http_protocol_options::HeadersWithUnderscoresAction",
28062827
tag = "5"
@@ -2944,6 +2965,7 @@ pub struct Http1ProtocolOptions {
29442965
/// If unset, HTTP/1 parser is selected based on
29452966
/// envoy.reloadable_features.http1_use_balsa_parser.
29462967
/// See issue #21245.
2968+
#[deprecated]
29472969
#[prost(message, optional, tag = "9")]
29482970
pub use_balsa_parser: ::core::option::Option<
29492971
super::super::super::super::google::protobuf::BoolValue,
@@ -3065,8 +3087,10 @@ pub struct Http2ProtocolOptions {
30653087
/// (2^16 - 1, HTTP/2 default) to 2147483647 (2^31 - 1, HTTP/2 maximum) and defaults to 268435456
30663088
/// (256 * 1024 * 1024).
30673089
///
3068-
/// NOTE: 65535 is the initial window size from HTTP/2 spec. We only support increasing the default
3069-
/// window size now, so it's also the minimum.
3090+
/// .. note::
3091+
///
3092+
/// 65535 is the initial window size from HTTP/2 spec. We only support increasing the default window size now,
3093+
/// so it's also the minimum.
30703094
///
30713095
/// This field also acts as a soft limit on the number of bytes Envoy will buffer per-stream in the
30723096
/// HTTP/2 codec buffers. Once the buffer reaches this pointer, watermark callbacks will fire to
@@ -3247,7 +3271,7 @@ pub struct GrpcProtocolOptions {
32473271
pub http2_protocol_options: ::core::option::Option<Http2ProtocolOptions>,
32483272
}
32493273
/// A message which allows using HTTP/3.
3250-
/// \[\#next-free-field: 8\]
3274+
/// \[\#next-free-field: 9\]
32513275
#[derive(Clone, PartialEq, ::prost::Message)]
32523276
pub struct Http3ProtocolOptions {
32533277
#[prost(message, optional, tag = "1")]
@@ -3283,6 +3307,10 @@ pub struct Http3ProtocolOptions {
32833307
/// This can be useful for trading off CPU vs bandwidth when an upstream HTTP/3 connection multiplexes multiple downstream connections.
32843308
#[prost(bool, tag = "7")]
32853309
pub disable_qpack: bool,
3310+
/// Disables connection level flow control for HTTP/3 streams. This is useful in situations where the streams share the same connection
3311+
/// but originate from different end-clients, so that each stream can make progress independently at non-front-line proxies.
3312+
#[prost(bool, tag = "8")]
3313+
pub disable_connection_flow_control_for_streams: bool,
32863314
}
32873315
/// A message to control transformations to the :scheme header
32883316
#[derive(Clone, PartialEq, ::prost::Message)]

envoy-types/src/generated/envoy.config.endpoint.v3.rs

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -324,7 +324,8 @@ pub mod cluster_load_assignment {
324324
/// this calculation.
325325
///
326326
///
327-
/// Note: this is not currently implemented for
327+
/// .. note::
328+
/// This is not currently implemented for
328329
/// : ref:`locality weighted load balancing <arch_overview_load_balancing_locality_weighted_lb>`.
329330
#[prost(bool, tag = "6")]
330331
pub weighted_priority_health: bool,

envoy-types/src/generated/envoy.config.grpc_credential.v3.rs

Lines changed: 0 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,5 @@
11
// This file is @generated by prost-build.
22
#[derive(Clone, PartialEq, ::prost::Message)]
3-
pub struct AwsIamConfig {
4-
/// The `service namespace <<https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#genref-aws-service-namespaces>`\_>
5-
/// of the Grpc endpoint.
6-
///
7-
/// Example: appmesh
8-
#[deprecated]
9-
#[prost(string, tag = "1")]
10-
pub service_name: ::prost::alloc::string::String,
11-
/// The `region <<https://docs.aws.amazon.com/general/latest/gr/rande.html>`\_> hosting the Grpc
12-
/// endpoint. If unspecified, the extension will use the value in the `AWS_REGION` environment
13-
/// variable.
14-
///
15-
/// Example: us-west-2
16-
#[deprecated]
17-
#[prost(string, tag = "2")]
18-
pub region: ::prost::alloc::string::String,
19-
}
20-
#[derive(Clone, PartialEq, ::prost::Message)]
213
pub struct FileBasedMetadataConfig {
224
/// Location or inline data of secret to use for authentication of the Google gRPC connection
235
/// this secret will be attached to a header of the gRPC connection

0 commit comments

Comments
 (0)