nginx-site: xml/en/docs/http/ngx_http_api

comparison xml/en/docs/http/ngx_http_api_module.xml @ 2046:a810103f8a75

Changed summary and description style to flow scalar in yaml.

author	Yaroslav Zhuravlev <yar@nginx.com>
date	Wed, 27 Sep 2017 21:55:34 +0300
parents	7e7edf832099
children	593dfdc524ae

comparison

equal deleted inserted replaced

-:ae16f480c867
+:a810103f8a75
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getAPIEndpoints">
 <literal>GET</literal> - Return list of root endpoints
 <para>Returns a list of root endpoints.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getNginx">
 <literal>GET</literal> - Return status of nginx running instance
+<para>Returns nginx version, build name, address, number of configuration reloads, IDs of master and worker processes.</para>
-<para>Returns nginx version, build name, address,
-number of configuration reloads, IDs of master and worker processes.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 (<literal>string</literal>, optional)</tag-name>
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getProcesses">
 <literal>GET</literal> - Return nginx processes status
+<para>Returns the number of abnormally terminated and respawned child processes.</para>
-<para>Returns the number of abnormally terminated
-and respawned child processes.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>200 - Success, returns <link id="def_nginx_processes">Processes</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteProcesses">
 <literal>DELETE</literal> - Reset nginx processes statistics
+<para>Resets counters of abnormally terminated and respawned child processes.</para>
-<para>Resets counters of abnormally terminated and respawned
-child processes.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>204 - Success</listitem>
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getConnections">
 <literal>GET</literal> - Return client connections statistics
 <para>Returns statistics of client connections.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 <listitem>200 - Success, returns <link id="def_nginx_connections">Connections</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteConnections">
 <literal>DELETE</literal> - Reset client connections statistics
+<para>Resets statistics of accepted and dropped client connections.</para>
-<para>Resets statistics of accepted and dropped
-client connections.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>204 - Success</listitem>
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getSsl">
 <literal>GET</literal> - Return SSL statistics
 <para>Returns SSL statistics.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 <listitem>200 - Success, returns <link id="def_nginx_ssl_object">SSL</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteSslStat">
 <literal>DELETE</literal> - Reset SSL statistics
 <para>Resets counters of SSL handshakes and session reuses.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getSlabs">
 <literal>GET</literal> - Return status of all slabs
+<para>Returns status of slabs for each shared memory zone with slab allocator.</para>
-<para>Returns status of slabs
-for each shared memory zone with slab allocator.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 (<literal>string</literal>, optional)</tag-name>
 <tag-desc>
-Limits which fields of slab zones will be output.
+Limits which fields of slab zones will be output. If the “<literal>fields</literal>” value is empty, then only zone names are output.</tag-desc>
-If the “<literal>fields</literal>” value is empty,
-then only zone names are output.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 </list>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getSlabZone">
 <literal>GET</literal> - Return status of a slab
+<para>Returns status of slabs for a particular shared memory zone with slab allocator.</para>
-<para>Returns status of slabs for a particular shared memory zone
-with slab allocator.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 (<literal>string</literal>, optional)</tag-name>
 <listitem>404 - Slab not found (<literal>SlabNotFound</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteSlabZoneStats">
 <literal>DELETE</literal> - Reset slab statistics
+<para>Resets the “<literal>reqs</literal>” and “<literal>fails</literal>” metrics for each memory slot.</para>
-<para>Resets the “<literal>reqs</literal>” and “<literal>fails</literal>”
-metrics for each memory slot.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>204 - Success</listitem>
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getHttp">
 <literal>GET</literal> - Return list of HTTP-related endpoints
 <para>Returns a list of first level HTTP endpoints.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getHttpRequests">
 <literal>GET</literal> - Return HTTP requests statistics
 <para>Returns status of client HTTP requests.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 (<literal>string</literal>, optional)</tag-name>
 <tag-desc>
-Limits which fields of client HTTP requests statistics
+Limits which fields of client HTTP requests statistics will be output.</tag-desc>
-will be output.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 <listitem>200 - Success, returns <link id="def_nginx_http_requests">HTTP Requests</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteHttpRequests">
 <literal>DELETE</literal> - Reset HTTP requests statistics
 <para>Resets the number of total client HTTP requests.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getHttpServerZones">
 <literal>GET</literal> - Return status of all HTTP server zones
+<para>Returns status information for each HTTP <link url="https://nginx.org/en/docs/http/ngx_http_status_module.html#status_zone">server zone</link>.</para>
-<para>Returns status information for each HTTP
-<link url="https://nginx.org/en/docs/http/ngx_http_status_module.html#status_zone">server zone</link>.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 (<literal>string</literal>, optional)</tag-name>
 <tag-desc>
-Limits which fields of server zones will be output.
+Limits which fields of server zones will be output. If the “<literal>fields</literal>” value is empty, then only server zone names are output.</tag-desc>
-If the “<literal>fields</literal>” value is empty,
-then only server zone names are output.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 </list>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getHttpServerZone">
 <literal>GET</literal> - Return status of an HTTP server zone
 <para>Returns status of a particular HTTP server zone.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 <listitem>404 - Server zone not found (<literal>ServerZoneNotFound</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteHttpServerZoneStat">
 <literal>DELETE</literal> - Reset statistics for an HTTP server zone
+<para>Resets statistics of accepted and discarded requests, responses, received and sent bytes in a particular HTTP server zone.</para>
-<para>Resets statistics of accepted and discarded requests, responses,
-received and sent bytes in a particular HTTP server zone.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>204 - Success</listitem>
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getHttpCaches">
 <literal>GET</literal> - Return status of all caches
+<para>Returns status of each cache configured by <link url="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_path">proxy_cache_path</link> and other “<literal>*_cache_path</literal>” directives.</para>
-<para>Returns status of each cache configured by
-<link url="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_path">proxy_cache_path</link>
-and other “<literal>*_cache_path</literal>” directives.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 (<literal>string</literal>, optional)</tag-name>
 <tag-desc>
-Limits which fields of cache zones will be output.
+Limits which fields of cache zones will be output. If the “<literal>fields</literal>” value is empty, then only names of cache zones are output.</tag-desc>
-If the “<literal>fields</literal>” value is empty,
-then only names of cache zones are output.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 </list>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getHttpCacheZone">
 <literal>GET</literal> - Return status of a cache
 <para>Returns status of a particular cache.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 <listitem>404 - Cache not found (<literal>CacheNotFound</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteHttpCacheZoneStat">
 <literal>DELETE</literal> - Reset cache statistics
 <para>Resets statistics of cache hits/misses in a particular cache zone.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getHttpUpstreams">
 <literal>GET</literal> - Return status of all HTTP upstream server groups
+<para>Returns status of each HTTP upstream server group and its servers.</para>
-<para>Returns status of each HTTP upstream server group
-and its servers.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 (<literal>string</literal>, optional)</tag-name>
 <tag-desc>
-Limits which fields of upstream server groups will be output.
+Limits which fields of upstream server groups will be output. If the “<literal>fields</literal>” value is empty, only names of upstreams are output.</tag-desc>
-If the “<literal>fields</literal>” value is empty,
-only names of upstreams are output.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 </list>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getHttpUpstreamName">
 <literal>GET</literal> - Return status of an HTTP upstream server group
+<para>Returns status of a particular HTTP upstream server group and its servers.</para>
-<para>Returns status of a particular HTTP upstream server group
-and its servers.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 (<literal>string</literal>, optional)</tag-name>
 <listitem>404 - Upstream not found (<literal>UpstreamNotFound</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteHttpUpstreamStat">
 <literal>DELETE</literal> - Reset statistics of an HTTP upstream server group
+<para>Resets the statistics for each upstream server in an upstream server group and queue statistics.</para>
-<para>Resets the statistics for each upstream server
-in an upstream server group and queue statistics.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>204 - Success</listitem>
 </list>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getHttpUpstreamServers">
 <literal>GET</literal> - Return configuration of all servers in an HTTP upstream server group
+<para>Returns configuration of each server in a particular HTTP upstream server group.</para>
-<para>Returns configuration of each server
-in a particular HTTP upstream server group.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>200 - Success, returns an array of <link id="def_nginx_http_upstream_conf_server">HTTP Upstream Servers</link></listitem>
 <listitem>404 - Upstream not found (<literal>UpstreamNotFound</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="postHttpUpstreamServer">
 <literal>POST</literal> - Add a server to an HTTP upstream server group
+<para>Adds a new server to an HTTP upstream server group. Server parameters are specified in the JSON format.</para>
-<para>Adds a new server to an HTTP upstream server group.
-Server parameters are specified in the JSON format.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>postHttpUpstreamServer</literal>
 (<link id="def_nginx_http_upstream_conf_server">HTTP Upstream Server</link>, required)</tag-name>
 <tag-desc>
-Address of a new server and other optional parameters
+Address of a new server and other optional parameters in the JSON format. The “<literal>ID</literal>”, “<literal>backup</literal>”, and “<literal>service</literal>” parameters cannot be changed.</tag-desc>
-in the JSON format.
-The “<literal>ID</literal>”, “<literal>backup</literal>”, and “<literal>service</literal>” parameters
-cannot be changed.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 </list>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getHttpUpstreamPeer">
 <literal>GET</literal> - Return configuration of a server in an HTTP upstream server group
+<para>Returns configuration of a particular server in the HTTP upstream server group.</para>
-<para>Returns configuration of a particular server
-in the HTTP upstream server group.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>200 - Success, returns <link id="def_nginx_http_upstream_conf_server">HTTP Upstream Server</link></listitem>
 server with ID “<value>id</value>” does not exist (<literal>UpstreamServerNotFound</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="patchHttpUpstreamPeer">
 <literal>PATCH</literal> - Modify a server in an HTTP upstream server group
+<para>Modifies settings of a particular server in an HTTP upstream server group. Server parameters are specified in the JSON format.</para>
-<para>Modifies settings of a particular server
-in an HTTP upstream server group.
-Server parameters are specified in the JSON format.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>patchHttpUpstreamServer</literal>
 (<link id="def_nginx_http_upstream_conf_server">HTTP Upstream Server</link>, required)</tag-name>
 <tag-desc>
-Server parameters, specified in the JSON format.
+Server parameters, specified in the JSON format. The “<literal>ID</literal>”, “<literal>backup</literal>”, and “<literal>service</literal>” parameters cannot be changed.</tag-desc>
-The “<literal>ID</literal>”, “<literal>backup</literal>”, and “<literal>service</literal>” parameters
-cannot be changed.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 <listitem>415 - JSON error (<literal>JsonError</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteHttpUpstreamServer">
 <literal>DELETE</literal> - Remove a server from an HTTP upstream server group
 <para>Removes a server from an HTTP upstream server group.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getHttpKeyvalZones">
 <literal>GET</literal> - Return key-value pairs from all keyval zones
+<para>Returns key-value pairs for each keyval shared memory <link url="https://nginx.org/en/docs/http/ngx_http_keyval_module.html#keyval_zone">zone</link>.</para>
-<para>Returns key-value pairs for each keyval shared memory
-<link url="https://nginx.org/en/docs/http/ngx_http_keyval_module.html#keyval_zone">zone</link>.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 (<literal>string</literal>, optional)</tag-name>
 <tag-desc>
-If the “<literal>fields</literal>” value is empty,
+If the “<literal>fields</literal>” value is empty, then only keyval zone names are output.</tag-desc>
-then only keyval zone names are output.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 </list>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getHttpKeyvalZoneKeysValues">
 <literal>GET</literal> - Return key-value pairs from a keyval zone
+<para>Returns key-value pairs stored in a particular keyval shared memory <link url="https://nginx.org/en/docs/http/ngx_http_keyval_module.html#keyval_zone">zone</link>.</para>
-<para>Returns key-value pairs stored in a particular keyval shared memory
-<link url="https://nginx.org/en/docs/http/ngx_http_keyval_module.html#keyval_zone">zone</link>.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>key</literal>
 (<literal>string</literal>, optional)</tag-name>
 keyval key not found (<literal>KeyvalKeyNotFound</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="postHttpKeyvalZoneData">
 <literal>POST</literal> - Add a key-value pair to the keyval zone
+<para>Adds a new key-value pair to the keyval shared memory <link url="https://nginx.org/en/docs/http/ngx_http_keyval_module.html#keyval_zone">zone</link>. Several key-value pairs can be entered if the keyval shared memory zone is empty.</para>
-<para>Adds a new key-value pair to the keyval shared memory
-<link url="https://nginx.org/en/docs/http/ngx_http_keyval_module.html#keyval_zone">zone</link>.
-Several key-value pairs can be entered
-if the keyval shared memory zone is empty.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>Key-value</literal>
 (<link id="def_nginx_http_keyval_zone">Keyval Shared Memory Zone</link>, required)</tag-name>
 <tag-desc>
-A key-value pair is specified in the JSON format.
+A key-value pair is specified in the JSON format. Several key-value pairs can be entered if the keyval shared memory zone is empty.</tag-desc>
-Several key-value pairs can be entered
-if the keyval shared memory zone is empty.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 <listitem>415 - JSON error (<literal>JsonError</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="patchHttpKeyvalZoneKeyValue">
 <literal>PATCH</literal> - Modify a key-value or delete a key
+<para>Changes the value of the selected key in the key-value pair or deletes a key by setting the key value to <literal>null</literal>.</para>
-<para>Changes the value of the selected key in the key-value pair
-or deletes a key by setting the key value to <literal>null</literal>.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>httpKeyvalZoneKeyValue</literal>
 (<link id="def_nginx_http_keyval_zone">Keyval Shared Memory Zone</link>, required)</tag-name>
 <listitem>415 - JSON error (<literal>JsonError</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteHttpKeyvalZoneData">
 <literal>DELETE</literal> - Empty the keyval zone
+<para>Deletes all key-value pairs from the keyval shared memory <link url="https://nginx.org/en/docs/http/ngx_http_keyval_module.html#keyval_zone">zone</link>.</para>
-<para>Deletes all key-value pairs from the keyval shared memory
-<link url="https://nginx.org/en/docs/http/ngx_http_keyval_module.html#keyval_zone">zone</link>.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>204 - Success</listitem>
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getStream">
 <literal>GET</literal> - Return list of stream-related endpoints
 <para>Returns a list of first level stream endpoints.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getStreamServerZones">
 <literal>GET</literal> - Return status of all stream server zones
+<para>Returns status information for each stream <link url="https://nginx.org/en/docs/http/ngx_http_status_module.html#status_zone">server zone</link>.</para>
-<para>Returns status information for each stream
-<link url="https://nginx.org/en/docs/http/ngx_http_status_module.html#status_zone">server zone</link>.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 (<literal>string</literal>, optional)</tag-name>
 <tag-desc>
-Limits which fields of server zones will be output.
+Limits which fields of server zones will be output. If the “<literal>fields</literal>” value is empty, then only server zone names are output.</tag-desc>
-If the “<literal>fields</literal>” value is empty,
-then only server zone names are output.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>200 - Success, returns a collection of "<link id="def_nginx_stream_server_zone">Stream Server Zone</link>" objects for all  stream server zones </listitem>
-<listitem>404 - <link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link>
+<listitem>404 - <link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link> not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 </list>
 </tag-desc>
 <tag-name id="stream_server_zones_stream_server_zone_name" name="/stream/server_zones/{streamServerZoneName}">
 </list>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getStreamServerZone">
 <literal>GET</literal> - Return status of a stream server zone
 <para>Returns status of a particular stream server zone.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>200 - Success, returns <link id="def_nginx_stream_server_zone">Stream Server Zone</link></listitem>
 <listitem>404 - Server zone not found (<literal>ServerZoneNotFound</literal>),
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link>
+<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link> not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteStreamServerZoneStat">
 <literal>DELETE</literal> - Reset statistics for a stream server zone
+<para>Resets statistics of accepted and discarded connections, sessions, received and sent bytes in a particular stream server zone.</para>
-<para>Resets statistics of accepted and discarded connections, sessions,
-received and sent bytes in a particular stream server zone.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>204 - Success</listitem>
 <listitem>404 - Server zone not found (<literal>ServerZoneNotFound</literal>),
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link>
+<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link> not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 </list>
 </tag-desc>
 <tag-name id="stream_upstreams_" name="/stream/upstreams/">
 <tag-desc>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getStreamUpstreams">
 <literal>GET</literal> - Return status of all stream upstream server groups
+<para>Returns status of each stream upstream server group and its servers.</para>
-<para>Returns status of each stream upstream server group
-and its servers.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 (<literal>string</literal>, optional)</tag-name>
 <tag-desc>
-Limits which fields of upstream server groups will be output.
+Limits which fields of upstream server groups will be output. If the “<literal>fields</literal>” value is empty, only names of upstreams are output.</tag-desc>
-If the “<literal>fields</literal>” value is empty,
-only names of upstreams are output.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>200 - Success, returns a collection of "<link id="def_nginx_stream_upstream">Stream Upstream</link>" objects for all  stream upstreams </listitem>
-<listitem>404 - <link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link>
+<listitem>404 - <link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link> not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 </list>
 </tag-desc>
 <tag-name id="stream_upstreams_stream_upstream_name_" name="/stream/upstreams/{streamUpstreamName}/">
 </list>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getStreamUpstream">
 <literal>GET</literal> - Return status of a stream upstream server group
+<para>Returns status of a particular stream upstream server group and its servers.</para>
-<para>Returns status of a particular stream upstream server group
-and its servers.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>fields</literal>
 (<literal>string</literal>, optional)</tag-name>
 </para>
 <list type="bullet">
 <listitem>200 - Success, returns <link id="def_nginx_stream_upstream">Stream Upstream</link></listitem>
 <listitem>400 - Upstream is static (<literal>UpstreamStatic</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>404 - Upstream not found (<literal>UpstreamNotFound</literal>),
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link>
+<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link> not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteStreamUpstreamStat">
 <literal>DELETE</literal> - Reset statistics of a stream upstream server group
+<para>Resets the statistics for each upstream server in an upstream server group.</para>
-<para>Resets the statistics for each upstream server
-in an upstream server group.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>204 - Success</listitem>
 <listitem>400 - Upstream is static (<literal>UpstreamStatic</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>404 - Upstream not found (<literal>UpstreamNotFound</literal>),
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link>
+<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link> not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 </list>
 </tag-desc>
 <tag-name id="stream_upstreams_stream_upstream_name_servers_" name="/stream/upstreams/{streamUpstreamName}/servers/">
 </list>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getStreamUpstreamServers">
 <literal>GET</literal> - Return configuration of all servers in a stream upstream server group
+<para>Returns configuration of each server in a particular stream upstream server group.</para>
-<para>Returns configuration of each server
-in a particular stream upstream server group.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>200 - Success, returns an array of <link id="def_nginx_stream_upstream_conf_server">Stream Upstream Servers</link></listitem>
 <listitem>400 - Upstream is static (<literal>UpstreamStatic</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>404 - Upstream not found (<literal>UpstreamNotFound</literal>),
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link>
+<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link> not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="postStreamUpstreamServer">
 <literal>POST</literal> - Add a server to a stream upstream server group
+<para>Adds a new server to a stream upstream server group. Server parameters are specified in the JSON format.</para>
-<para>Adds a new server to a stream upstream server group.
-Server parameters are specified in the JSON format.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>postStreamUpstreamServer</literal>
 (<link id="def_nginx_stream_upstream_conf_server">Stream Upstream Server</link>, required)</tag-name>
 <tag-desc>
-Address of a new server and other optional parameters
+Address of a new server and other optional parameters in the JSON format. The “<literal>ID</literal>”, “<literal>backup</literal>”, and “<literal>service</literal>” parameters cannot be changed.</tag-desc>
-in the JSON format.
-The “<literal>ID</literal>”, “<literal>backup</literal>”, and “<literal>service</literal>” parameters
-cannot be changed.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 “<literal>service</literal>” is empty (<literal>UpstreamBadService</literal>),
 no resolver defined to resolve (<literal>UpstreamConfNoResolver</literal>),
 upstream “<value>name</value>” has no backup (<literal>UpstreamNoBackup</literal>),
 upstream “<value>name</value>” memory exhausted (<literal>UpstreamOutOfMemory</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>404 - Upstream not found (<literal>UpstreamNotFound</literal>),
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link>
+<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link> not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>415 - JSON error (<literal>JsonError</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 </list>
 </tag-desc>
 </list>
 <para>Supported methods:</para>
 <list type="bullet" compact="yes">
 <listitem id="getStreamUpstreamServer">
 <literal>GET</literal> - Return configuration of a server in a stream upstream server group
+<para>Returns configuration of a particular server in the stream upstream server group.</para>
-<para>Returns configuration of a particular server
-in the stream upstream server group.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>200 - Success, returns <link id="def_nginx_stream_upstream_conf_server">Stream Upstream Server</link></listitem>
 <listitem>400 - Upstream is static (<literal>UpstreamStatic</literal>),
 invalid server ID (<literal>UpstreamBadServerId</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>404 - Upstream not found (<literal>UpstreamNotFound</literal>),
 server with ID “<value>id</value>” does not exist (<literal>UpstreamServerNotFound</literal>),
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link>
+<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link> not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="patchStreamUpstreamServer">
 <literal>PATCH</literal> - Modify a server in a stream upstream server group
+<para>Modifies settings of a particular server in a stream upstream server group. Server parameters are specified in the JSON format.</para>
-<para>Modifies settings of a particular server
-in a stream upstream server group.
-Server parameters are specified in the JSON format.</para>
 <para>
 Request parameters:
 <list type="tag">
 <tag-name><literal>patchStreamUpstreamServer</literal>
 (<link id="def_nginx_stream_upstream_conf_server">Stream Upstream Server</link>, required)</tag-name>
 <tag-desc>
-Server parameters, specified in the JSON format.
+Server parameters, specified in the JSON format. The “<literal>ID</literal>”, “<literal>backup</literal>”, and “<literal>service</literal>” parameters cannot be changed.</tag-desc>
-The “<literal>ID</literal>”, “<literal>backup</literal>”, and “<literal>service</literal>” parameters
-cannot be changed.</tag-desc>
 </list>
 </para>
 <para>
 Possible responses:
 </para>
 server “<value>ID</value>” address is immutable (<literal>UpstreamServerImmutable</literal>),
 server “<value>ID</value>” weight is immutable (<literal>UpstreamServerWeightImmutable</literal>),
 upstream “<literal>name</literal>” memory exhausted (<literal>UpstreamOutOfMemory</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>404 - Upstream not found (<literal>UpstreamNotFound</literal>),
 server with ID “<value>id</value>” does not exist (<literal>UpstreamServerNotFound</literal>),
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link>
+<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link> not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>415 - JSON error (<literal>JsonError</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 <listitem id="deleteStreamUpstreamServer">
 <literal>DELETE</literal> - Remove a server from a stream upstream server group
 <para>Removes a server from a stream server group.</para>
 <para>
 Possible responses:
 </para>
 <list type="bullet">
 <listitem>400 - Upstream is static (<literal>UpstreamStatic</literal>),
 invalid server ID (<literal>UpstreamBadServerId</literal>),
 server “<value>id</value>” not removable (<literal>UpstreamServerImmutable</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>404 - Upstream not found (<literal>UpstreamNotFound</literal>),
 server with ID “<value>id</value>” does not exist (<literal>UpstreamServerNotFound</literal>),
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link>
+<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#stream">stream</link> not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-not configured (<literal>StreamNotConfigured</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
 </list>
 </tag-desc>
 </list>
 </tag-desc>
 <tag-name>
 <literal>generation</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of configuration
+The total number of configuration <link url="https://nginx.org/en/docs/control.html#reconfiguration">reloads</link>.
-<link url="https://nginx.org/en/docs/control.html#reconfiguration">reloads</link>.
 </tag-desc>
 <tag-name>
 <literal>load_timestamp</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Time of the last reload of configuration,
+Time of the last reload of configuration, in milliseconds since Epoch.
-in milliseconds since Epoch.
 </tag-desc>
 <tag-name>
 <literal>timestamp</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name>
 <literal>ppid</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The ID of the master process that started the
+The ID of the master process that started the <link url="https://nginx.org/en/docs/http/ngx_http_status_module.html#pid">worker process</link>.
-<link url="https://nginx.org/en/docs/http/ngx_http_status_module.html#pid">worker process</link>.
 </tag-desc>
 </list>
 <para>Example:</para>
 <example>
 {
 <list type="tag">
 <tag-name>
 <literal>respawned</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of abnormally terminated
+The total number of abnormally terminated and respawned child processes.
-and respawned child processes.
 </tag-desc>
 </list>
 <para>Example:</para>
 <example>
 {
 </tag-desc>
 <tag-name>
 <literal>reqs</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of attempts
+The total number of attempts to allocate memory of specified size.
-to allocate memory of specified size.
 </tag-desc>
 <tag-name>
 <literal>fails</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The number of unsuccessful attempts
+The number of unsuccessful attempts to allocate memory of specified size.
-to allocate memory of specified size.
 </tag-desc>
 </list>
 </listitem>
 <listitem id="def_nginx_http_requests">
 <para>HTTP Requests:</para>
 <list type="tag">
 <tag-name>
 <literal>processing</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The number of client requests
+The number of client requests that are currently being processed.
-that are currently being processed.
 </tag-desc>
 <tag-name>
 <literal>requests</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 The total number of client requests received from clients.
 </tag-desc>
 <tag-name>
 <literal>responses</literal></tag-name>
 <tag-desc>
-The total number of responses sent to clients and the
+The total number of responses sent to clients and the number of responses with status codes “<literal>1xx</literal>”, “<literal>2xx</literal>”, “<literal>3xx</literal>”, “<literal>4xx</literal>”, and “<literal>5xx</literal>”.<list type="tag">
-number of responses with status codes
-“<literal>1xx</literal>”, “<literal>2xx</literal>”, “<literal>3xx</literal>”,
-“<literal>4xx</literal>”, and “<literal>5xx</literal>”.<list type="tag">
 <tag-name>
 <literal>1xx</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 The number of responses with “<literal>1xx</literal>” status codes.
 </tag-desc>
 <tag-name>
 <literal>discarded</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of
+The total number of requests completed without sending a response.
-requests completed without sending a response.
 </tag-desc>
 <tag-name>
 <literal>received</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name>
 <literal>max_size</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The limit on the maximum size of the cache
+The limit on the maximum size of the cache specified in the configuration.
-specified in the configuration.
 </tag-desc>
 <tag-name>
 <literal>cold</literal> (<literal>boolean</literal>)
 </tag-name>
 <tag-desc>
-A boolean value indicating whether the “cache loader” process
+A boolean value indicating whether the “cache loader” process is still loading data from disk into the cache.
-is still loading data from disk into the cache.
 </tag-desc>
 <tag-name>
 <literal>hit</literal></tag-name>
 <tag-desc>
 <list type="tag">
 <tag-name>
 <literal>responses</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of
+The total number of <link url="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_valid">valid</link> responses read from the cache.
-<link url="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_valid">valid</link>
-responses read from the cache.
 </tag-desc>
 <tag-name>
 <literal>bytes</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 <list type="tag">
 <tag-name>
 <literal>responses</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of expired responses read from the cache (see
+The total number of expired responses read from the cache (see <link url="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_use_stale">proxy_cache_use_stale</link> and other “<literal>*_cache_use_stale</literal>” directives).
-<link url="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_use_stale">proxy_cache_use_stale</link>
-and other “<literal>*_cache_use_stale</literal>” directives).
 </tag-desc>
 <tag-name>
 <literal>bytes</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 <list type="tag">
 <tag-name>
 <literal>responses</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of expired responses read from the cache
+The total number of expired responses read from the cache while responses were being updated (see <link url="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_use_stale_updating">proxy_cache_use_stale</link> and other “<literal>*_cache_use_stale</literal>” directives).
-while responses were being updated (see
-<link url="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_use_stale_updating">proxy_cache_use_stale</link>
-and other “<literal>*_cache_use_stale</literal>” directives).
 </tag-desc>
 <tag-name>
 <literal>bytes</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 <list type="tag">
 <tag-name>
 <literal>responses</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of expired and revalidated responses
+The total number of expired and revalidated responses read from the cache (see <link url="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_revalidate">proxy_cache_revalidate</link> and other “<literal>*_cache_revalidate</literal>” directives.
-read from the cache (see
-<link url="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_revalidate">proxy_cache_revalidate</link>
-and other “<literal>*_cache_revalidate</literal>” directives.
 </tag-desc>
 <tag-name>
 <literal>bytes</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 <list type="tag">
 <tag-name>
 <literal>responses</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of responses not looked up in the cache due to the
+The total number of responses not looked up in the cache due to the <link url="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_bypass">proxy_cache_bypass</link> and other “<literal>*_cache_bypass</literal>” directives.
-<link url="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_bypass">proxy_cache_bypass</link>
-and other “<literal>*_cache_bypass</literal>” directives.
 </tag-desc>
 <tag-name>
 <literal>bytes</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name>
 <literal>server</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-An  <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#server">address</link>
+An  <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#server">address</link> of the server.
-of the server.
 </tag-desc>
 <tag-name>
 <literal>service</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-The
+The <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#service">service</link> parameter value of the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#server">server</link> directive.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#service">service</link>
-parameter value of the
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#server">server</link>
-directive.
 </tag-desc>
 <tag-name>
 <literal>name</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-The name of the server specified in the
+The name of the server specified in the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#server">server</link> directive.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#server">server</link>
-directive.
 </tag-desc>
 <tag-name>
 <literal>backup</literal> (<literal>boolean</literal>)
 </tag-name>
 <tag-desc>
-A boolean value indicating whether the server is a
+A boolean value indicating whether the server is a <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#backup">backup</link> server.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#backup">backup</link>
-server.
 </tag-desc>
 <tag-name>
 <literal>weight</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#weight">Weight</link>
+<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#weight">Weight</link> of the server.
-of the server.
 </tag-desc>
 <tag-name>
 <literal>state</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Current state, which may be one of
+Current state, which may be one of “<literal>up</literal>”, “<literal>draining</literal>”, “<literal>down</literal>”, “<literal>unavail</literal>”, “<literal>checking</literal>”, and “<literal>unhealthy</literal>”.
-“<literal>up</literal>”, “<literal>draining</literal>”, “<literal>down</literal>”,
-“<literal>unavail</literal>”, “<literal>checking</literal>”,
-and “<literal>unhealthy</literal>”.
 </tag-desc>
 <tag-name>
 <literal>active</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name>
 <literal>max_conns</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The
+The <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#max_conns">max_conns</link> limit for the server.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#max_conns">max_conns</link>
-limit for the server.
 </tag-desc>
 <tag-name>
 <literal>requests</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name>
 <literal>fails</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of unsuccessful attempts
+The total number of unsuccessful attempts to communicate with the server.
-to communicate with the server.
 </tag-desc>
 <tag-name>
 <literal>unavail</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-How many times the server became unavailable for client requests
+How many times the server became unavailable for client requests (state “<literal>unavail</literal>”) due to the number of unsuccessful attempts reaching the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#max_fails">max_fails</link> threshold.
-(state “<literal>unavail</literal>”) due to the number of unsuccessful
-attempts reaching the
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#max_fails">max_fails</link>
-threshold.
 </tag-desc>
 <tag-name>
 <literal>health_checks</literal></tag-name>
 <tag-desc>
 <list type="tag">
 <tag-name>
 <literal>checks</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of
+The total number of <link url="https://nginx.org/en/docs/http/ngx_http_upstream_hc_module.html#health_check">health check</link> requests made.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_hc_module.html#health_check">health check</link>
-requests made.
 </tag-desc>
 <tag-name>
 <literal>fails</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name>
 <literal>unhealthy</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-How many times the server became unhealthy
+How many times the server became unhealthy (state “<literal>unhealthy</literal>”).
-(state “<literal>unhealthy</literal>”).
 </tag-desc>
 <tag-name>
 <literal>last_passed</literal> (<literal>boolean</literal>)
 </tag-name>
 <tag-desc>
-Boolean indicating if the last health check request was successful
+Boolean indicating if the last health check request was successful and passed <link url="https://nginx.org/en/docs/http/ngx_http_upstream_hc_module.html#match">tests</link>.
-and passed
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_hc_module.html#match">tests</link>.
 </tag-desc>
 </list>
 </tag-desc>
 <tag-name>
 <literal>downtime</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-Total time the server was in the “<literal>unavail</literal>”,
+Total time the server was in the “<literal>unavail</literal>”, “<literal>checking</literal>”, and “<literal>unhealthy</literal>” states.
-“<literal>checking</literal>”, and “<literal>unhealthy</literal>” states.
 </tag-desc>
 <tag-name>
 <literal>downstart</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-The time (in milliseconds since Epoch) when the server became
+The time (in milliseconds since Epoch) when the server became “<literal>unavail</literal>”, “<literal>checking</literal>”, or “<literal>unhealthy</literal>”.
-“<literal>unavail</literal>”, “<literal>checking</literal>”,
-or “<literal>unhealthy</literal>”.
 </tag-desc>
 <tag-name>
 <literal>selected</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-The time (in milliseconds since Epoch)
+The time (in milliseconds since Epoch) when the server was last selected to process a request.
-when the server was last selected to process a request.
 </tag-desc>
 <tag-name>
 <literal>header_time</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The average time to get the
+The average time to get the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#var_upstream_header_time">response header</link> from the server.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#var_upstream_header_time">response header</link>
-from the server.
 </tag-desc>
 <tag-name>
 <literal>response_time</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The average time to get the
+The average time to get the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#var_upstream_response_time">full response</link> from the server.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#var_upstream_response_time">full response</link>
-from the server.
 </tag-desc>
 </list>
 </tag-desc>
 <tag-name>
 <literal>keepalive</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The current number of idle
+The current number of idle <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive">keepalive</link> connections.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive">keepalive</link>
-connections.
 </tag-desc>
 <tag-name>
 <literal>zombies</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The current number of servers removed
+The current number of servers removed from the group but still processing active client requests.
-from the group but still processing active client requests.
 </tag-desc>
 <tag-name>
 <literal>zone</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-The name of the shared memory
+The name of the shared memory <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#zone">zone</link> that keeps the group’s configuration and run-time state.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#zone">zone</link>
-that keeps the group’s configuration and run-time state.
 </tag-desc>
 <tag-name>
 <literal>queue</literal></tag-name>
 <tag-desc>
-For the requests
+For the requests <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#queue">queue</link>, the following data are provided:<list type="tag">
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#queue">queue</link>,
-the following data are provided:<list type="tag">
 <tag-name>
 <literal>size</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 The current number of requests in the queue.
 </tag-desc>
 <tag-name>
 <literal>max_size</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The maximum number of requests that can be in the queue
+The maximum number of requests that can be in the queue at the same time.
-at the same time.
 </tag-desc>
 <tag-name>
 <literal>overflows</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#server">server</link>:<list type="tag">
 <tag-name>
 <literal>id</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The ID of the HTTP upstream server.
+The ID of the HTTP upstream server. The ID is assigned automatically and cannot be changed.
-The ID is assigned automatically and cannot be changed.
 </tag-desc>
 <tag-name>
 <literal>server</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#address">address</link> 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 <link url="https://nginx.org/en/docs/http/ngx_http_core_module.html#resolver">resolver</link> directive in the “<literal>http</literal>” block. See also the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#resolve">resolve</link> parameter of the HTTP upstream server.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#address">address</link>
-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
-<link url="https://nginx.org/en/docs/http/ngx_http_core_module.html#resolver">resolver</link>
-directive in the “<literal>http</literal>” block.
-See also the
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#resolve">resolve</link>
-parameter of the HTTP upstream server.
 </tag-desc>
 <tag-name>
 <literal>service</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#service">service</link> parameter of the HTTP upstream server. This parameter cannot be changed.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#service">service</link>
-parameter of the HTTP upstream server.
-This parameter cannot be changed.
 </tag-desc>
 <tag-name>
 <literal>weight</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#weight">weight</link> parameter of the HTTP upstream server.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#weight">weight</link>
-parameter of the HTTP upstream server.
 </tag-desc>
 <tag-name>
 <literal>max_conns</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#max_conns">max_conns</link> parameter of the HTTP upstream server.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#max_conns">max_conns</link>
-parameter of the HTTP upstream server.
 </tag-desc>
 <tag-name>
 <literal>max_fails</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#max_fails">max_fails</link> parameter of the HTTP upstream server.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#max_fails">max_fails</link>
-parameter of the HTTP upstream server.
 </tag-desc>
 <tag-name>
 <literal>fail_timeout</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#fail_timeout">fail_timeout</link> parameter of the HTTP upstream server.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#fail_timeout">fail_timeout</link>
-parameter of the HTTP upstream server.
 </tag-desc>
 <tag-name>
 <literal>slow_start</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#slow_start">slow_start</link> parameter of the HTTP upstream server.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#slow_start">slow_start</link>
-parameter of the HTTP upstream server.
 </tag-desc>
 <tag-name>
 <literal>route</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#route">route</link> parameter of the HTTP upstream server.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#route">route</link>
-parameter of the HTTP upstream server.
 </tag-desc>
 <tag-name>
 <literal>backup</literal> (<literal>boolean</literal>)
 </tag-name>
 <tag-desc>
-When <literal>true</literal>, adds a
+When <literal>true</literal>, adds a <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#backup">backup</link> server. This parameter cannot be changed.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#backup">backup</link>
-server.
-This parameter cannot be changed.
 </tag-desc>
 <tag-name>
 <literal>down</literal> (<literal>boolean</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#down">down</link> parameter of the HTTP upstream server.
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#down">down</link>
-parameter of the HTTP upstream server.
 </tag-desc>
 <tag-name>
 <literal>parent</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Parent server ID of the resolved server.
+Parent server ID of the resolved server. The ID is assigned automatically and cannot be changed.
-The ID is assigned automatically and cannot be changed.
 </tag-desc>
 <tag-name>
 <literal>host</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Hostname of the resolved server.
+Hostname of the resolved server. The hostname is assigned automatically and cannot be changed.
-The hostname is assigned automatically and cannot be changed.
 </tag-desc>
 <tag-name>
 <literal>drain</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Puts the HTTP upstream server into the “draining” mode.
+Puts the HTTP upstream server into the “draining” mode. In this mode, only requests <link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#sticky">bound</link> to the server will be proxied to it. The parameter cannot be initially set, it can only be changed with the <literal>PATCH</literal> method.
-In this mode, only requests
-<link url="https://nginx.org/en/docs/http/ngx_http_upstream_module.html#sticky">bound</link>
-to the server will be proxied to it.
-The parameter cannot be initially set,
-it can only be changed with the <literal>PATCH</literal> method.
 </tag-desc>
 </list>
 <para>Example:</para>
 <example>
 {
 <list type="tag">
 <tag-name>
 <literal>processing</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The number of client connections
+The number of client connections that are currently being processed.
-that are currently being processed.
 </tag-desc>
 <tag-name>
 <literal>connections</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 The total number of connections accepted from clients.
 </tag-desc>
 <tag-name>
 <literal>sessions</literal></tag-name>
 <tag-desc>
-Total number of completed sessions,
+The total number of completed sessions, and the number of sessions completed with status codes “<literal>2xx</literal>”, “<literal>4xx</literal>”, or “<literal>5xx</literal>”.<list type="tag">
-and the number of sessions completed with status codes
-“<literal>2xx</literal>”, “<literal>4xx</literal>”, or “<literal>5xx</literal>”.<list type="tag">
 <tag-name>
 <literal>2xx</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of sessions completed with
+The total number of sessions completed with <link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#var_status">status codes</link> “<literal>2xx</literal>”.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#var_status">status codes</link>
-“<literal>2xx</literal>”.
 </tag-desc>
 <tag-name>
 <literal>4xx</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of sessions completed with
+The total number of sessions completed with <link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#var_status">status codes</link> “<literal>4xx</literal>”.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#var_status">status codes</link>
-“<literal>4xx</literal>”.
 </tag-desc>
 <tag-name>
 <literal>5xx</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of sessions completed with
+The total number of sessions completed with <link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#var_status">status codes</link> “<literal>5xx</literal>”.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#var_status">status codes</link>
-“<literal>5xx</literal>”.
 </tag-desc>
 <tag-name>
 <literal>total</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name>
 <literal>discarded</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of
+The total number of connections completed without creating a session.
-connections completed without creating a session.
 </tag-desc>
 <tag-name>
 <literal>received</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name>
 <literal>server</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-An
+An <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#server">address</link> of the server.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#server">address</link>
-of the server.
 </tag-desc>
 <tag-name>
 <literal>service</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-The
+The <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#service">service</link> parameter value of the <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#server">server</link> directive.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#service">service</link>
-parameter value of the
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#server">server</link>
-directive.
 </tag-desc>
 <tag-name>
 <literal>name</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-The name of the server specified in the
+The name of the server specified in the <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#server">server</link> directive.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#server">server</link>
-directive.
 </tag-desc>
 <tag-name>
 <literal>backup</literal> (<literal>boolean</literal>)
 </tag-name>
 <tag-desc>
-A boolean value indicating whether the server is a
+A boolean value indicating whether the server is a <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#backup">backup</link> server.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#backup">backup</link>
-server.
 </tag-desc>
 <tag-name>
 <literal>weight</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#weight">Weight</link>
+<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#weight">Weight</link> of the server.
-of the server.
 </tag-desc>
 <tag-name>
 <literal>state</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Current state, which may be one of
+Current state, which may be one of “<literal>up</literal>”, “<literal>down</literal>”, “<literal>unavail</literal>”, “<literal>checking</literal>”, or “<literal>unhealthy</literal>”.
-“<literal>up</literal>”, “<literal>down</literal>”, “<literal>unavail</literal>”,
-“<literal>checking</literal>”, or “<literal>unhealthy</literal>”.
 </tag-desc>
 <tag-name>
 <literal>active</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name>
 <literal>max_conns</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The
+The <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#max_conns">max_conns</link> limit for the server.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#max_conns">max_conns</link>
-limit for the server.
 </tag-desc>
 <tag-name>
 <literal>connections</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name>
 <literal>fails</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of unsuccessful attempts
+The total number of unsuccessful attempts to communicate with the server.
-to communicate with the server.
 </tag-desc>
 <tag-name>
 <literal>unavail</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-How many times the server became unavailable for client connections
+How many times the server became unavailable for client connections (state “<literal>unavail</literal>”) due to the number of unsuccessful attempts reaching the <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#max_fails">max_fails</link> threshold.
-(state “<literal>unavail</literal>”) due to the number of unsuccessful
-attempts reaching the
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#max_fails">max_fails</link>
-threshold.
 </tag-desc>
 <tag-name>
 <literal>health_checks</literal></tag-name>
 <tag-desc>
 <list type="tag">
 <tag-name>
 <literal>checks</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The total number of
+The total number of <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_hc_module.html#health_check">health check</link> requests made.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_hc_module.html#health_check">health check</link>
-requests made.
 </tag-desc>
 <tag-name>
 <literal>fails</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name>
 <literal>unhealthy</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-How many times the server became unhealthy
+How many times the server became unhealthy (state “<literal>unhealthy</literal>”).
-(state “<literal>unhealthy</literal>”).
 </tag-desc>
 <tag-name>
 <literal>last_passed</literal> (<literal>boolean</literal>)
 </tag-name>
 <tag-desc>
-Boolean indicating whether the last health check request
+Boolean indicating whether the last health check request was successful and passed <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_hc_module.html#match">tests</link>.
-was successful and passed
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_hc_module.html#match">tests</link>.
 </tag-desc>
 </list>
 </tag-desc>
 <tag-name>
 <literal>downtime</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-Total time the server was in the
+Total time the server was in the “<literal>unavail</literal>”, “<literal>checking</literal>”, and “<literal>unhealthy</literal>” states.
-“<literal>unavail</literal>”, “<literal>checking</literal>”,
-and “<literal>unhealthy</literal>” states.
 </tag-desc>
 <tag-name>
 <literal>downstart</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-The time (in milliseconds since Epoch) when the server became
+The time (in milliseconds since Epoch) when the server became “<literal>unavail</literal>”, “<literal>checking</literal>”, or “<literal>unhealthy</literal>”.
-“<literal>unavail</literal>”, “<literal>checking</literal>”,
-or “<literal>unhealthy</literal>”.
 </tag-desc>
 <tag-name>
 <literal>selected</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-The time (in milliseconds since Epoch)
+The time (in milliseconds since Epoch) when the server was last selected to process a connection.
-when the server was last selected to process a connection.
 </tag-desc>
 </list>
 </tag-desc>
 <tag-name>
 <literal>zombies</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The current number of servers removed from the group
+The current number of servers removed from the group but still processing active client connections.
-but still processing active client connections.
 </tag-desc>
 <tag-name>
 <literal>zone</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-The name of the shared memory
+The name of the shared memory <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#zone">zone</link> that keeps the group’s configuration and run-time state.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#zone">zone</link>
-that keeps the group’s configuration and run-time state.
 </tag-desc>
 </list>
 <para>Example:</para>
 <example>
 {
 <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#server">server</link>:<list type="tag">
 <tag-name>
 <literal>id</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-The ID of the stream upstream server.
+The ID of the stream upstream server. The ID is assigned automatically and cannot be changed.
-The ID is assigned automatically and cannot be changed.
 </tag-desc>
 <tag-name>
 <literal>server</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#server">address</link> parameter of the stream 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 <link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#resolver">resolver</link> directive in the “<literal>stream</literal>” block. See also the <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#resolve">resolve</link> parameter of the stream upstream server.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#server">address</link>
-parameter of the stream 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
-<link url="https://nginx.org/en/docs/stream/ngx_stream_core_module.html#resolver">resolver</link>
-directive in the “<literal>stream</literal>” block.
-See also the
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#resolve">resolve</link>
-parameter of the stream upstream server.
 </tag-desc>
 <tag-name>
 <literal>service</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#service">service</link> parameter of the stream upstream server. This parameter cannot be changed.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#service">service</link>
-parameter of the stream upstream server.
-This parameter cannot be changed.
 </tag-desc>
 <tag-name>
 <literal>weight</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#weight">weight</link> parameter of the stream upstream server.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#weight">weight</link>
-parameter of the stream upstream server.
 </tag-desc>
 <tag-name>
 <literal>max_conns</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#max_conns">max_conns</link> parameter of the stream upstream server.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#max_conns">max_conns</link>
-parameter of the stream upstream server.
 </tag-desc>
 <tag-name>
 <literal>max_fails</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#max_fails">max_fails</link> parameter of the stream upstream server.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#max_fails">max_fails</link>
-parameter of the stream upstream server.
 </tag-desc>
 <tag-name>
 <literal>fail_timeout</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#fail_timeout">fail_timeout</link> parameter of the stream upstream server.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#fail_timeout">fail_timeout</link>
-parameter of the stream upstream server.
 </tag-desc>
 <tag-name>
 <literal>slow_start</literal> (<literal>integer</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#slow_start">slow_start</link> parameter of the stream upstream server.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#slow_start">slow_start</link>
-parameter of the stream upstream server.
 </tag-desc>
 <tag-name>
 <literal>backup</literal> (<literal>boolean</literal>)
 </tag-name>
 <tag-desc>
-When <literal>true</literal>, adds a
+When <literal>true</literal>, adds a <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#backup">backup</link> server. This parameter cannot be changed.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#backup">backup</link>
-server.
-This parameter cannot be changed.
 </tag-desc>
 <tag-name>
 <literal>down</literal> (<literal>boolean</literal>)
 </tag-name>
 <tag-desc>
-Same as the
+Same as the <link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#down">down</link> parameter of the stream upstream server.
-<link url="https://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#down">down</link>
-parameter of the stream upstream server.
 </tag-desc>
 <tag-name>
 <literal>parent</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Parent server ID of the resolved server.
+Parent server ID of the resolved server. The ID is assigned automatically and cannot be changed.
-The ID is assigned automatically and cannot be changed.
 </tag-desc>
 <tag-name>
 <literal>host</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-Hostname of the resolved server.
+Hostname of the resolved server. The hostname is assigned automatically and cannot be changed.
-The hostname is assigned automatically and cannot be changed.
 </tag-desc>
 </list>
 <para>Example:</para>
 <example>
 {
 </tag-desc>
 <tag-name>
 <literal>request_id</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>
-The ID of the request, equals the value of the
+The ID of the request, equals the value of the <link url="https://nginx.org/en/docs/http/ngx_http_core_module.html#var_request_id">$request_id</link> variable.
-<link url="https://nginx.org/en/docs/http/ngx_http_core_module.html#var_request_id">$request_id</link>
-variable.
 </tag-desc>
 <tag-name>
 <literal>href</literal> (<literal>string</literal>)
 </tag-name>
 <tag-desc>

Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_api_module.xml @ 2046:a810103f8a75