Mercurial > hg > nginx-site

changeset 1956:dd96a09dd4f7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented support for "429 Too Many Requests" response.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 04 Apr 2017 17:43:25 +0300
parents 182bbf9034c4
children 0cda46808207
files xml/en/docs/http/ngx_http_fastcgi_module.xml xml/en/docs/http/ngx_http_proxy_module.xml xml/en/docs/http/ngx_http_scgi_module.xml xml/en/docs/http/ngx_http_uwsgi_module.xml xml/ru/docs/http/ngx_http_fastcgi_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_scgi_module.xml xml/ru/docs/http/ngx_http_uwsgi_module.xml
diffstat 8 files changed, 64 insertions(+), 16 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="44">
+        rev="45">
 
 <section id="summary">
 
@@ -613,6 +613,7 @@ header fields.
     <literal>http_503</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>off</literal>
     ...</syntax>
 <default>off</default>
@@ -1031,6 +1032,7 @@ or <link id="fastcgi_store">stored</link
     <literal>http_503</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>non_idempotent</literal> |
     <literal>off</literal>
     ...</syntax>
@@ -1066,6 +1068,9 @@ server, passing a request to it, or read
 <tag-name><literal>http_404</literal></tag-name>
 <tag-desc>a server returned a response with the code 404;</tag-desc>
 
+<tag-name><literal>http_429</literal></tag-name>
+<tag-desc>a server returned a response with the code 429 (1.11.13);</tag-desc>
+
 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
 <tag-desc>normally, requests with a
 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">non-idempotent</link>
@@ -1096,7 +1101,8 @@ attempt</link> of communication with a s
 The cases of <literal>error</literal>, <literal>timeout</literal> and
 <literal>invalid_header</literal> are always considered unsuccessful attempts,
 even if they are not specified in the directive.
-The cases of <literal>http_500</literal> and <literal>http_503</literal> are
+The cases of <literal>http_500</literal>, <literal>http_503</literal>,
+and <literal>http_429</literal> are
 considered unsuccessful attempts only if they are specified in the directive.
 The cases of <literal>http_403</literal> and <literal>http_404</literal>
 are never considered unsuccessful attempts.
--- a/xml/en/docs/http/ngx_http_proxy_module.xml
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="58">
+        rev="59">
 
 <section id="summary">
 
@@ -631,6 +631,7 @@ header fields.
     <literal>http_504</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>off</literal>
     ...</syntax>
 <default>off</default>
@@ -1189,6 +1190,7 @@ Parameter value can contain variables (1
     <literal>http_504</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>non_idempotent</literal> |
     <literal>off</literal>
     ...</syntax>
@@ -1230,6 +1232,9 @@ server, passing a request to it, or read
 <tag-name><literal>http_404</literal></tag-name>
 <tag-desc>a server returned a response with the code 404;</tag-desc>
 
+<tag-name><literal>http_429</literal></tag-name>
+<tag-desc>a server returned a response with the code 429 (1.11.13);</tag-desc>
+
 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
 <tag-desc>normally, requests with a
 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">non-idempotent</link>
@@ -1261,7 +1266,8 @@ The cases of <literal>error</literal>, <
 <literal>invalid_header</literal> are always considered unsuccessful attempts,
 even if they are not specified in the directive.
 The cases of <literal>http_500</literal>, <literal>http_502</literal>,
-<literal>http_503</literal> and <literal>http_504</literal> are
+<literal>http_503</literal>, <literal>http_504</literal>,
+and <literal>http_429</literal> are
 considered unsuccessful attempts only if they are specified in the directive.
 The cases of <literal>http_403</literal> and <literal>http_404</literal>
 are never considered unsuccessful attempts.
--- a/xml/en/docs/http/ngx_http_scgi_module.xml
+++ b/xml/en/docs/http/ngx_http_scgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_scgi_module"
         link="/en/docs/http/ngx_http_scgi_module.html"
         lang="en"
-        rev="33">
+        rev="34">
 
 <section id="summary">
 
@@ -604,6 +604,7 @@ header fields.
     <literal>http_503</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>off</literal>
     ...</syntax>
 <default>off</default>
@@ -950,6 +951,7 @@ or <link id="scgi_store">stored</link> o
     <literal>http_503</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>non_idempotent</literal> |
     <literal>off</literal>
     ...</syntax>
@@ -985,6 +987,9 @@ server, passing a request to it, or read
 <tag-name><literal>http_404</literal></tag-name>
 <tag-desc>a server returned a response with the code 404;</tag-desc>
 
+<tag-name><literal>http_429</literal></tag-name>
+<tag-desc>a server returned a response with the code 429 (1.11.13);</tag-desc>
+
 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
 <tag-desc>normally, requests with a
 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">non-idempotent</link>
@@ -1015,7 +1020,8 @@ attempt</link> of communication with a s
 The cases of <literal>error</literal>, <literal>timeout</literal> and
 <literal>invalid_header</literal> are always considered unsuccessful attempts,
 even if they are not specified in the directive.
-The cases of <literal>http_500</literal> and <literal>http_503</literal> are
+The cases of <literal>http_500</literal>, <literal>http_503</literal>,
+and <literal>http_429</literal> are
 considered unsuccessful attempts only if they are specified in the directive.
 The cases of <literal>http_403</literal> and <literal>http_404</literal>
 are never considered unsuccessful attempts.
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml
+++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_uwsgi_module"
         link="/en/docs/http/ngx_http_uwsgi_module.html"
         lang="en"
-        rev="36">
+        rev="37">
 
 <section id="summary">
 
@@ -604,6 +604,7 @@ header fields.
     <literal>http_503</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>off</literal>
     ...</syntax>
 <default>off</default>
@@ -981,6 +982,7 @@ packet header</link>.
     <literal>http_503</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>non_idempotent</literal> |
     <literal>off</literal>
     ...</syntax>
@@ -1016,6 +1018,9 @@ server, passing a request to it, or read
 <tag-name><literal>http_404</literal></tag-name>
 <tag-desc>a server returned a response with the code 404;</tag-desc>
 
+<tag-name><literal>http_429</literal></tag-name>
+<tag-desc>a server returned a response with the code 429 (1.11.13);</tag-desc>
+
 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
 <tag-desc>normally, requests with a
 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">non-idempotent</link>
@@ -1046,7 +1051,8 @@ attempt</link> of communication with a s
 The cases of <literal>error</literal>, <literal>timeout</literal> and
 <literal>invalid_header</literal> are always considered unsuccessful attempts,
 even if they are not specified in the directive.
-The cases of <literal>http_500</literal> and <literal>http_503</literal> are
+The cases of <literal>http_500</literal>, <literal>http_503</literal>,
+and <literal>http_429</literal> are
 considered unsuccessful attempts only if they are specified in the directive.
 The cases of <literal>http_403</literal> and <literal>http_404</literal>
 are never considered unsuccessful attempts.
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="44">
+        rev="45">
 
 <section id="summary">
 
@@ -612,6 +612,7 @@ server {
     <literal>http_503</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>off</literal>
     ...</syntax>
 <default>off</default>
@@ -1030,6 +1031,7 @@ FastCGI-сервера, и ответ не вмещается целиком в буферы,
     <literal>http_503</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>non_idempotent</literal> |
     <literal>off</literal>
     ...</syntax>
@@ -1065,6 +1067,9 @@ FastCGI-сервера, и ответ не вмещается целиком в буферы,
 <tag-name><literal>http_404</literal></tag-name>
 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
 
+<tag-name><literal>http_429</literal></tag-name>
+<tag-desc>сервер вернул ответ с кодом 429 (1.11.13);</tag-desc>
+
 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
 <tag-desc>обычно запросы с
 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">неидемпотентным</link>
@@ -1096,7 +1101,8 @@ FastCGI-сервера, и ответ не вмещается целиком в буферы,
 Случаи <literal>error</literal>, <literal>timeout</literal> и
 <literal>invalid_header</literal>
 всегда считаются неудачными попытками, даже если они не указаны в директиве.
-Случаи <literal>http_500</literal> и <literal>http_503</literal>
+Случаи <literal>http_500</literal>, <literal>http_503</literal>
+и <literal>http_429</literal>
 считаются неудачными попытками, только если они указаны в директиве.
 Случаи <literal>http_403</literal> и <literal>http_404</literal>
 никогда не считаются неудачными попытками.
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="58">
+        rev="59">
 
 <section id="summary">
 
@@ -631,6 +631,7 @@ server {
     <literal>http_504</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>off</literal>
     ...</syntax>
 <default>off</default>
@@ -1190,6 +1191,7 @@ NTLM</link> рекомендуется версия 1.1.
     <literal>http_504</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>non_idempotent</literal> |
     <literal>off</literal>
     ...</syntax>
@@ -1231,6 +1233,9 @@ NTLM</link> рекомендуется версия 1.1.
 <tag-name><literal>http_404</literal></tag-name>
 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
 
+<tag-name><literal>http_429</literal></tag-name>
+<tag-desc>сервер вернул ответ с кодом 429 (1.11.13);</tag-desc>
+
 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
 <tag-desc>обычно запросы с
 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">неидемпотентным</link>
@@ -1263,7 +1268,8 @@ NTLM</link> рекомендуется версия 1.1.
 <literal>invalid_header</literal>
 всегда считаются неудачными попытками, даже если они не указаны в директиве.
 Случаи <literal>http_500</literal>, <literal>http_502</literal>,
-<literal>http_503</literal> и <literal>http_504</literal>
+<literal>http_503</literal>, <literal>http_504</literal>
+и <literal>http_429</literal>
 считаются неудачными попытками, только если они указаны в директиве.
 Случаи <literal>http_403</literal> и <literal>http_404</literal>
 никогда не считаются неудачными попытками.
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_scgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_scgi_module"
         link="/ru/docs/http/ngx_http_scgi_module.html"
         lang="ru"
-        rev="33">
+        rev="34">
 
 <section id="summary">
 
@@ -603,6 +603,7 @@ server {
     <literal>http_503</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>off</literal>
     ...</syntax>
 <default>off</default>
@@ -948,6 +949,7 @@ SCGI-сервера, и ответ не вмещается целиком в буферы,
     <literal>http_503</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>non_idempotent</literal> |
     <literal>off</literal>
     ...</syntax>
@@ -983,6 +985,9 @@ SCGI-сервера, и ответ не вмещается целиком в буферы,
 <tag-name><literal>http_404</literal></tag-name>
 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
 
+<tag-name><literal>http_429</literal></tag-name>
+<tag-desc>сервер вернул ответ с кодом 429 (1.11.13);</tag-desc>
+
 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
 <tag-desc>обычно запросы с
 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">неидемпотентным</link>
@@ -1014,7 +1019,8 @@ SCGI-сервера, и ответ не вмещается целиком в буферы,
 Случаи <literal>error</literal>, <literal>timeout</literal> и
 <literal>invalid_header</literal>
 всегда считаются неудачными попытками, даже если они не указаны в директиве.
-Случаи <literal>http_500</literal> и <literal>http_503</literal>
+Случаи <literal>http_500</literal>, <literal>http_503</literal>
+и <literal>http_429</literal>
 считаются неудачными попытками, только если они указаны в директиве.
 Случаи <literal>http_403</literal> и <literal>http_404</literal>
 никогда не считаются неудачными попытками.
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_uwsgi_module"
         link="/ru/docs/http/ngx_http_uwsgi_module.html"
         lang="ru"
-        rev="36">
+        rev="37">
 
 <section id="summary">
 
@@ -602,6 +602,7 @@ server {
     <literal>http_503</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>off</literal>
     ...</syntax>
 <default>off</default>
@@ -977,6 +978,7 @@ uwsgi-сервера, и ответ не вмещается целиком в буферы,
     <literal>http_503</literal> |
     <literal>http_403</literal> |
     <literal>http_404</literal> |
+    <literal>http_429</literal> |
     <literal>non_idempotent</literal> |
     <literal>off</literal>
     ...</syntax>
@@ -1012,6 +1014,9 @@ uwsgi-сервера, и ответ не вмещается целиком в буферы,
 <tag-name><literal>http_404</literal></tag-name>
 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
 
+<tag-name><literal>http_429</literal></tag-name>
+<tag-desc>сервер вернул ответ с кодом 429 (1.11.13);</tag-desc>
+
 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
 <tag-desc>обычно запросы с
 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">неидемпотентным</link>
@@ -1042,7 +1047,8 @@ uwsgi-сервера, и ответ не вмещается целиком в буферы,
 Случаи <literal>error</literal>, <literal>timeout</literal> и
 <literal>invalid_header</literal>
 всегда считаются неудачными попытками, даже если они не указаны в директиве.
-Случаи <literal>http_500</literal> и <literal>http_503</literal>
+Случаи <literal>http_500</literal>, <literal>http_503</literal>
+и <literal>http_429</literal>
 считаются неудачными попытками, только если они указаны в директиве.
 Случаи <literal>http_403</literal> и <literal>http_404</literal>
 никогда не считаются неудачными попытками.