gateway api v1.2.0 experimental

GRPCRoute.spec.rules[].backendRefs[].filters.requestHeaderModifier.spec.rules.backendRefs.filters

Filters defined at this level MUST be executed if and only if the request is being forwarded to the backend defined here. Support: Implementation-specific (For broader support of filters, use the Filters field in GRPCRouteRule.)

5 fields
GRPCRoute.spec.rules[].backendRefs[].filters.requestHeaderModifier.spec.rules.backendRefs.filters fields and descriptions
Field / TypeDescription
object

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. Support: Implementation-specific This filter can be used multiple times within the same rule.

object

RequestHeaderModifier defines a schema for a filter that modifies request headers. Support: Core

object

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

  • x-kubernetes-validations: [{"message":"Only one of percent or fraction may be specified in HTTPRequestMirrorFilter","rule":"!(has(self.percent) \u0026\u0026 has(self.fraction))"}]
object

ResponseHeaderModifier defines a schema for a filter that modifies response headers. Support: Extended

type
string required

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 supporting GRPCRoute 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` MUST 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.

  • enum: ["ResponseHeaderModifier","RequestHeaderModifier","RequestMirror","ExtensionRef"]