---
title: "Return configuration of all servers in an HTTP upstream server group"
method: GET
path: "/http/upstreams/{httpUpstreamName}/servers/"
tags: ["HTTP Upstreams", "Method GET"]
---

# Return configuration of all servers in an HTTP upstream server group

`GET /http/upstreams/{httpUpstreamName}/servers/`

Returns configuration of each server in a particular HTTP upstream server group.

## Response `200`

Success

- NginxHTTPUpstreamConfServer[] — An array of HTTP upstream servers for dynamic configuration.
  - `id` integer — The ID of the HTTP upstream server. The ID is assigned automatically and cannot be changed.
  - `server` string — 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 “<code>http</code>” 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.
  - `service` string — 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.
  - `weight` integer — 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.
  - `max_conns` integer — 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.
  - `max_fails` integer — 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.
  - `fail_timeout` string — 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.
  - `slow_start` string — 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.
  - `route` string — 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.
  - `backup` boolean — 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.
  - `down` boolean — 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.
  - `drain` boolean — 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.
  - `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.

## Other responses

- `400` — Upstream is static (*UpstreamStatic*)
- `404` — Unknown version (*UnknownVersion*), upstream not found (*UpstreamNotFound*)

---

[API](https://skmtc.dev/nginx/apis/nginx-plus-rest-api.md) · [All operations](https://skmtc.dev/nginx/apis/nginx-plus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nginx/nginx-plus-rest-api/revisions/533ae7834228/schema)