HTTPBackendRef

Reference to a backend service in an HTTPRoute rule, with an optional traffic weight for proportional routing.

Container OrchestrationKubernetesLoad BalancingNetworkingService Discovery

Properties

Name Type Description
name string Name of the referenced Service.
namespace string Namespace of the Service. Defaults to the HTTPRoute's namespace.
port integer Port number on the referenced Service.
weight integer Relative weight for traffic distribution. Requests are proportioned by weight across backendRefs in the same rule.
View JSON Schema on GitHub

JSON Schema

kubernetes-services-httpbackendref-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/HTTPBackendRef",
  "title": "HTTPBackendRef",
  "type": "object",
  "description": "Reference to a backend service in an HTTPRoute rule, with an optional traffic weight for proportional routing.",
  "required": [
    "name",
    "port"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the referenced Service."
    },
    "namespace": {
      "type": "string",
      "description": "Namespace of the Service. Defaults to the HTTPRoute's namespace."
    },
    "port": {
      "type": "integer",
      "minimum": 1,
      "maximum": 65535,
      "description": "Port number on the referenced Service."
    },
    "weight": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Relative weight for traffic distribution. Requests are proportioned by weight across backendRefs in the same rule."
    }
  }
}