Apache APISIX · Schema

Apache APISIX Upstream

An Upstream is a virtual host abstraction that performs load balancing on a given set of service nodes according to configured rules.

ApacheAPI GatewayCloud NativeKubernetesLuaNGINXOpen SourceTraffic Management

Properties

Name Type Description
name string Human-readable name for the upstream.
desc string Description of the upstream.
type string Load balancing algorithm.
nodes object Backend service nodes.
service_name string Service name for service discovery.
discovery_type string Type of service discovery (e.g. dns, consul, nacos, eureka).
hash_on string Hash input for consistent hashing load balancer.
key string Hash key when using chash load balancer.
checks object Health check configuration.
retries integer Number of retries for failed requests.
retry_timeout number Timeout in seconds for retry requests.
timeout object Timeout settings for upstream connections.
scheme string The scheme for communicating with the upstream.
pass_host string How to set the Host header when proxying to upstream.
upstream_host string Host to use when pass_host is set to rewrite.
labels object Key-value pairs for categorization.
keepalive_pool object Keepalive pool configuration.
tls object TLS configuration for upstream connections.
View JSON Schema on GitHub