gateway api v1.6.2 experimental

XBackend.spec

Spec defines the desired state of XBackend.

5 fields
XBackend.spec fields and descriptions
Field / TypeDescription
object

ExternalHostname specifies the configuration for an ExternalHostname backend. This field must be set when type is ExternalHostname and must be unset otherwise. Support: Extended

object required

Port defines the port that the implementation should use when connecting to this backend.

protocol
string

Protocol defines the protocol for backend communication. In the common case, the underlying transport protocol for the proxied traffic will already have been determined and processed by the dataplane at the routing step. Where this field is useful is either for higher level protocols or asymmetrical protocol configurations (e.g. version upgrades or h2c). When set, the implementation uses the specified protocol when connecting to this backend. When not set, the implementation will use the protocol determined by the route or listener configuration. Support: Core - HTTP, HTTP2, H2C, and HTTP11 Support: Extended - GRPC, MCP, TCP

  • enum: ["TCP","HTTP","HTTP2","HTTP11","H2C","MCP"]
object

TLS defines the TLS configuration that the implementation should use when connecting to the backend. ExternalHostname backends SHOULD have TLS configured; the lack of TLS for external hostnames should be considered insecure and a security risk. Support: Extended

  • x-kubernetes-validations: [{"message":"clientCertificateRef must be set if and only if mode is ClientAndServer","rule":"self.mode == 'ClientAndServer' ? has(self.clientCertificateRef) : !has(self.clientCertificateRef)"}]
type
string required

Type defines the backend type.

  • enum: ["ExternalHostname"]