comparison xml/en/docs/http/ngx_http_proxy_module.xml @ 1956:dd96a09dd4f7

Documented support for "429 Too Many Requests" response.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 04 Apr 2017 17:43:25 +0300
parents 66a30a380fba
children 3460bd328287
comparison
equal deleted inserted replaced
1955:182bbf9034c4 1956:dd96a09dd4f7
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Module ngx_http_proxy_module" 10 <module name="Module ngx_http_proxy_module"
11 link="/en/docs/http/ngx_http_proxy_module.html" 11 link="/en/docs/http/ngx_http_proxy_module.html"
12 lang="en" 12 lang="en"
13 rev="58"> 13 rev="59">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 The <literal>ngx_http_proxy_module</literal> module allows passing 18 The <literal>ngx_http_proxy_module</literal> module allows passing
629 <literal>http_502</literal> | 629 <literal>http_502</literal> |
630 <literal>http_503</literal> | 630 <literal>http_503</literal> |
631 <literal>http_504</literal> | 631 <literal>http_504</literal> |
632 <literal>http_403</literal> | 632 <literal>http_403</literal> |
633 <literal>http_404</literal> | 633 <literal>http_404</literal> |
634 <literal>http_429</literal> |
634 <literal>off</literal> 635 <literal>off</literal>
635 ...</syntax> 636 ...</syntax>
636 <default>off</default> 637 <default>off</default>
637 <context>http</context> 638 <context>http</context>
638 <context>server</context> 639 <context>server</context>
1187 <literal>http_502</literal> | 1188 <literal>http_502</literal> |
1188 <literal>http_503</literal> | 1189 <literal>http_503</literal> |
1189 <literal>http_504</literal> | 1190 <literal>http_504</literal> |
1190 <literal>http_403</literal> | 1191 <literal>http_403</literal> |
1191 <literal>http_404</literal> | 1192 <literal>http_404</literal> |
1193 <literal>http_429</literal> |
1192 <literal>non_idempotent</literal> | 1194 <literal>non_idempotent</literal> |
1193 <literal>off</literal> 1195 <literal>off</literal>
1194 ...</syntax> 1196 ...</syntax>
1195 <default>error timeout</default> 1197 <default>error timeout</default>
1196 <context>http</context> 1198 <context>http</context>
1227 <tag-name><literal>http_403</literal></tag-name> 1229 <tag-name><literal>http_403</literal></tag-name>
1228 <tag-desc>a server returned a response with the code 403;</tag-desc> 1230 <tag-desc>a server returned a response with the code 403;</tag-desc>
1229 1231
1230 <tag-name><literal>http_404</literal></tag-name> 1232 <tag-name><literal>http_404</literal></tag-name>
1231 <tag-desc>a server returned a response with the code 404;</tag-desc> 1233 <tag-desc>a server returned a response with the code 404;</tag-desc>
1234
1235 <tag-name><literal>http_429</literal></tag-name>
1236 <tag-desc>a server returned a response with the code 429 (1.11.13);</tag-desc>
1232 1237
1233 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name> 1238 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
1234 <tag-desc>normally, requests with a 1239 <tag-desc>normally, requests with a
1235 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">non-idempotent</link> 1240 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">non-idempotent</link>
1236 method 1241 method
1259 attempt</link> of communication with a server. 1264 attempt</link> of communication with a server.
1260 The cases of <literal>error</literal>, <literal>timeout</literal> and 1265 The cases of <literal>error</literal>, <literal>timeout</literal> and
1261 <literal>invalid_header</literal> are always considered unsuccessful attempts, 1266 <literal>invalid_header</literal> are always considered unsuccessful attempts,
1262 even if they are not specified in the directive. 1267 even if they are not specified in the directive.
1263 The cases of <literal>http_500</literal>, <literal>http_502</literal>, 1268 The cases of <literal>http_500</literal>, <literal>http_502</literal>,
1264 <literal>http_503</literal> and <literal>http_504</literal> are 1269 <literal>http_503</literal>, <literal>http_504</literal>,
1270 and <literal>http_429</literal> are
1265 considered unsuccessful attempts only if they are specified in the directive. 1271 considered unsuccessful attempts only if they are specified in the directive.
1266 The cases of <literal>http_403</literal> and <literal>http_404</literal> 1272 The cases of <literal>http_403</literal> and <literal>http_404</literal>
1267 are never considered unsuccessful attempts. 1273 are never considered unsuccessful attempts.
1268 </para> 1274 </para>
1269 1275