NGINX · Schema

HTTP Upstream Server

Dynamically configurable parameters of an HTTP upstream server:

API GatewayCachingCloud NativeLoad BalancerOpen SourceReverse ProxyWeb Server

Properties

Name	Type	Description
id	integer	The ID of the HTTP upstream server. The ID is assigned automatically and cannot be changed.
server	string	Same as the address parameter of the HTTP upstream server. When adding a server, it is possible to specify it as a dom
service	string	Same as the service parameter of the HTTP upstream server. This parameter cannot be changed.
weight	integer	Same as the weight parameter of the HTTP upstream server.
max_conns	integer	Same as the max_conns parameter of the HTTP upstream server.
max_fails	integer	Same as the max_fails parameter of the HTTP upstream server.
fail_timeout	string	Same as the fail_timeout parameter of the HTTP upstream server.
slow_start	string	Same as the slow_start parameter of the HTTP upstream server.
route	string	Same as the route parameter of the HTTP upstream server.
backup	boolean	When `true`, adds a backup server. This parameter cannot be changed.
down	boolean	Same as the down parameter of the HTTP upstream server.
drain	boolean	Same as the drain parameter of the HTTP upstream server.
parent	string	Parent server ID of the resolved server. The ID is assigned automatically and cannot be changed.
host	string	Hostname of the resolved server. The hostname is assigned automatically and cannot be changed.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/nginx/refs/heads/main/json-schema/plus-http-api-nginx-http-upstream-conf-server-schema.json",
  "title": "HTTP Upstream Server",
  "description": "Dynamically configurable parameters of an HTTP upstream\n<a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#server\">server</a>:\n",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "The ID of the HTTP upstream server. The ID is assigned automatically and cannot be changed.",
      "readOnly": true,
      "example": 0
    },
    "server": {
      "type": "string",
      "description": "Same as the <a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#server\">address</a> parameter of the HTTP upstream server. When adding a server, it is possible to specify it as a domain name. In this case, changes of the IP addresses that correspond to a domain name will be monitored and automatically applied to the upstream configuration without the need of restarting nginx. This requires the <a href=\"https://nginx.org/en/docs/http/ngx_http_core_module.html#resolver\">resolver</a> directive in the \u201c<code>http</code>\u201d block. See also the <a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#resolve\">resolve</a> parameter of the HTTP upstream server.",
      "example": "example-server"
    },
    "service": {
      "type": "string",
      "description": "Same as the <a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#service\">service</a> parameter of the HTTP upstream server. This parameter cannot be changed.",
      "readOnly": true,
      "example": "example-service"
    },
    "weight": {
      "type": "integer",
      "description": "Same as the <a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#weight\">weight</a> parameter of the HTTP upstream server.",
      "example": 0
    },
    "max_conns": {
      "type": "integer",
      "description": "Same as the <a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#max_conns\">max_conns</a> parameter of the HTTP upstream server.",
      "example": 0
    },
    "max_fails": {
      "type": "integer",
      "description": "Same as the <a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#max_fails\">max_fails</a> parameter of the HTTP upstream server.",
      "example": 0
    },
    "fail_timeout": {
      "type": "string",
      "description": "Same as the <a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#fail_timeout\">fail_timeout</a> parameter of the HTTP upstream server.",
      "example": "example-fail_timeout"
    },
    "slow_start": {
      "type": "string",
      "description": "Same as the <a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#slow_start\">slow_start</a> parameter of the HTTP upstream server.",
      "example": "example-slow_start"
    },
    "route": {
      "type": "string",
      "description": "Same as the <a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#route\">route</a> parameter of the HTTP upstream server.",
      "example": "example-route"
    },
    "backup": {
      "type": "boolean",
      "description": "When <code>true</code>, adds a <a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#backup\">backup</a> server. This parameter cannot be changed.",
      "readOnly": true,
      "example": false
    },
    "down": {
      "type": "boolean",
      "description": "Same as the <a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#down\">down</a> parameter of the HTTP upstream server.",
      "example": false
    },
    "drain": {
      "type": "boolean",
      "description": "Same as the <a href=\"https://nginx.org/en/docs/http/ngx_http_upstream_module.html#drain\">drain</a> parameter of the HTTP upstream server.",
      "example": false
    },
    "parent": {
      "type": "string",
      "description": "Parent server ID of the resolved server. The ID is assigned automatically and cannot be changed.",
      "readOnly": true,
      "example": "example-parent"
    },
    "host": {
      "type": "string",
      "description": "Hostname of the resolved server. The hostname is assigned automatically and cannot be changed.",
      "readOnly": true,
      "example": "example-host"
    }
  },
  "example": {
    "id": 1,
    "server": "10.0.0.1:8089",
    "weight": 4,
    "max_conns": 0,
    "max_fails": 0,
    "fail_timeout": "10s",
    "slow_start": "10s",
    "route": "",
    "backup": true,
    "down": true
  }
}