pub struct HTTPRouteRulesBackendRefsFilters {
pub extension_ref: Option<HTTPRouteRulesBackendRefsFiltersExtensionRef>,
pub request_header_modifier: Option<HTTPRouteRulesBackendRefsFiltersRequestHeaderModifier>,
pub request_mirror: Option<HTTPRouteRulesBackendRefsFiltersRequestMirror>,
pub request_redirect: Option<HTTPRouteRulesBackendRefsFiltersRequestRedirect>,
pub response_header_modifier: Option<HTTPRouteRulesBackendRefsFiltersResponseHeaderModifier>,
pub type: HTTPRouteRulesBackendRefsFiltersType,
pub url_rewrite: Option<HTTPRouteRulesBackendRefsFiltersUrlRewrite>,
}
Expand description
HTTPRouteFilter defines processing steps that must be completed during the request or response lifecycle. HTTPRouteFilters are meant as an extension point to express processing that may be done in Gateway implementations. Some examples include request or response modification, implementing authentication strategies, rate-limiting, and traffic shaping. API guarantee/conformance is defined based on the type of the filter.
Fields§
§extension_ref: Option<HTTPRouteRulesBackendRefsFiltersExtensionRef>
ExtensionRef is an optional, implementation-specific extension to the “filter” behavior. For example, resource “myroutefilter” in group “networking.example.net”). ExtensionRef MUST NOT be used for core and extended filters.
This filter can be used multiple times within the same rule.
Support: Implementation-specific
request_header_modifier: Option<HTTPRouteRulesBackendRefsFiltersRequestHeaderModifier>
RequestHeaderModifier defines a schema for a filter that modifies request headers.
Support: Core
request_mirror: Option<HTTPRouteRulesBackendRefsFiltersRequestMirror>
RequestMirror defines a schema for a filter that mirrors requests. Requests are sent to the specified destination, but responses from that destination are ignored.
This filter can be used multiple times within the same rule. Note that not all implementations will be able to support mirroring to multiple backends.
Support: Extended
request_redirect: Option<HTTPRouteRulesBackendRefsFiltersRequestRedirect>
RequestRedirect defines a schema for a filter that responds to the request with an HTTP redirection.
Support: Core
response_header_modifier: Option<HTTPRouteRulesBackendRefsFiltersResponseHeaderModifier>
ResponseHeaderModifier defines a schema for a filter that modifies response headers.
Support: Extended
type: HTTPRouteRulesBackendRefsFiltersType
Type identifies the type of filter to apply. As with other API fields, types are classified into three conformance levels:
-
Core: Filter types and their corresponding configuration defined by “Support: Core” in this package, e.g. “RequestHeaderModifier”. All implementations must support core filters.
-
Extended: Filter types and their corresponding configuration defined by “Support: Extended” in this package, e.g. “RequestMirror”. Implementers are encouraged to support extended filters.
-
Implementation-specific: Filters that are defined and supported by specific vendors. In the future, filters showing convergence in behavior across multiple implementations will be considered for inclusion in extended or core conformance levels. Filter-specific configuration for such filters is specified using the ExtensionRef field.
Type
should be set to “ExtensionRef” for custom filters.
Implementers are encouraged to define custom implementation types to extend the core API with implementation-specific behavior.
If a reference to a custom filter type cannot be resolved, the filter MUST NOT be skipped. Instead, requests that would have been processed by that filter MUST receive a HTTP error response.
Note that values may be added to this enum, implementations must ensure that unknown values will not cause a crash.
Unknown values here must result in the implementation setting the
Accepted Condition for the Route to status: False
, with a
Reason of UnsupportedValue
.
url_rewrite: Option<HTTPRouteRulesBackendRefsFiltersUrlRewrite>
URLRewrite defines a schema for a filter that modifies a request during forwarding.
Support: Extended
Trait Implementations§
Source§impl Clone for HTTPRouteRulesBackendRefsFilters
impl Clone for HTTPRouteRulesBackendRefsFilters
Source§fn clone(&self) -> HTTPRouteRulesBackendRefsFilters
fn clone(&self) -> HTTPRouteRulesBackendRefsFilters
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Default for HTTPRouteRulesBackendRefsFilters
impl Default for HTTPRouteRulesBackendRefsFilters
Source§fn default() -> HTTPRouteRulesBackendRefsFilters
fn default() -> HTTPRouteRulesBackendRefsFilters
Source§impl<'de> Deserialize<'de> for HTTPRouteRulesBackendRefsFilters
impl<'de> Deserialize<'de> for HTTPRouteRulesBackendRefsFilters
Source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
Source§impl JsonSchema for HTTPRouteRulesBackendRefsFilters
impl JsonSchema for HTTPRouteRulesBackendRefsFilters
Source§fn schema_name() -> String
fn schema_name() -> String
Source§fn schema_id() -> Cow<'static, str>
fn schema_id() -> Cow<'static, str>
Source§fn json_schema(generator: &mut SchemaGenerator) -> Schema
fn json_schema(generator: &mut SchemaGenerator) -> Schema
Source§fn is_referenceable() -> bool
fn is_referenceable() -> bool
$ref
keyword. Read moreSource§impl PartialEq for HTTPRouteRulesBackendRefsFilters
impl PartialEq for HTTPRouteRulesBackendRefsFilters
Source§fn eq(&self, other: &HTTPRouteRulesBackendRefsFilters) -> bool
fn eq(&self, other: &HTTPRouteRulesBackendRefsFilters) -> bool
self
and other
values to be equal, and is used by ==
.impl StructuralPartialEq for HTTPRouteRulesBackendRefsFilters
Auto Trait Implementations§
impl Freeze for HTTPRouteRulesBackendRefsFilters
impl RefUnwindSafe for HTTPRouteRulesBackendRefsFilters
impl Send for HTTPRouteRulesBackendRefsFilters
impl Sync for HTTPRouteRulesBackendRefsFilters
impl Unpin for HTTPRouteRulesBackendRefsFilters
impl UnwindSafe for HTTPRouteRulesBackendRefsFilters
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more