Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_upstream_module.xml @ 2914:3a2d342533fb
Updated docs for the upcoming NGINX Plus release.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Mon, 28 Nov 2022 17:42:29 +0000 |
parents | 4add6ae1296f |
children | a2708cf6ebdb |
comparison
equal
deleted
inserted
replaced
2913:a20b51e84c32 | 2914:3a2d342533fb |
---|---|
898 | 898 |
899 <directive name="resolver"> | 899 <directive name="resolver"> |
900 <syntax> | 900 <syntax> |
901 <value>address</value> ... | 901 <value>address</value> ... |
902 [<literal>valid</literal>=<value>time</value>] | 902 [<literal>valid</literal>=<value>time</value>] |
903 [<literal>ipv4</literal>=<literal>on</literal>|<literal>off</literal>] | |
903 [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>] | 904 [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>] |
904 [<literal>status_zone</literal>=<value>zone</value>]</syntax> | 905 [<literal>status_zone</literal>=<value>zone</value>]</syntax> |
905 <default/> | 906 <default/> |
906 <context>upstream</context> | 907 <context>upstream</context> |
907 <appeared-in>1.17.5</appeared-in> | 908 <appeared-in>1.17.5</appeared-in> |
918 Name servers are queried in a round-robin fashion. | 919 Name servers are queried in a round-robin fashion. |
919 </para> | 920 </para> |
920 | 921 |
921 <para id="resolver_ipv6"> | 922 <para id="resolver_ipv6"> |
922 By default, nginx will look up both IPv4 and IPv6 addresses while resolving. | 923 By default, nginx will look up both IPv4 and IPv6 addresses while resolving. |
923 If looking up of IPv6 addresses is not desired, | 924 If looking up of IPv4 or IPv6 addresses is not desired, |
925 the <literal>ipv4=off</literal> (1.23.1) or | |
924 the <literal>ipv6=off</literal> parameter can be specified. | 926 the <literal>ipv6=off</literal> parameter can be specified. |
925 </para> | 927 </para> |
926 | 928 |
927 <para id="resolver_valid"> | 929 <para id="resolver_valid"> |
928 By default, nginx caches answers using the TTL value of a response. | 930 By default, nginx caches answers using the TTL value of a response. |
981 <syntax> | 983 <syntax> |
982 <literal>cookie</literal> <value>name</value> | 984 <literal>cookie</literal> <value>name</value> |
983 [<literal>expires=</literal><value>time</value>] | 985 [<literal>expires=</literal><value>time</value>] |
984 [<literal>domain=</literal><value>domain</value>] | 986 [<literal>domain=</literal><value>domain</value>] |
985 [<literal>httponly</literal>] | 987 [<literal>httponly</literal>] |
986 [<literal>samesite=</literal><literal>strict</literal>|<literal>lax</literal>|<literal>none</literal>] | 988 [<literal>samesite=</literal><literal>strict</literal>|<literal>lax</literal>|<literal>none</literal>|<value>$variable</value>] |
987 [<literal>secure</literal>] | 989 [<literal>secure</literal>] |
988 [<literal>path=</literal><value>path</value>]</syntax> | 990 [<literal>path=</literal><value>path</value>]</syntax> |
989 <syntax> | 991 <syntax> |
990 <literal>route</literal> <value>$variable</value> ...</syntax> | 992 <literal>route</literal> <value>$variable</value> ...</syntax> |
991 <syntax> | 993 <syntax> |
1079 <tag-desc> | 1081 <tag-desc> |
1080 Adds the <literal>HttpOnly</literal> attribute to the cookie (1.7.11). | 1082 Adds the <literal>HttpOnly</literal> attribute to the cookie (1.7.11). |
1081 </tag-desc> | 1083 </tag-desc> |
1082 | 1084 |
1083 <tag-name id="sticky_samesite"><literal>samesite=</literal><literal>strict</literal> | | 1085 <tag-name id="sticky_samesite"><literal>samesite=</literal><literal>strict</literal> | |
1084 <literal>lax</literal> | <literal>none</literal></tag-name> | 1086 <literal>lax</literal> | <literal>none</literal> | <value>$variable</value></tag-name> |
1085 <tag-desc> | 1087 <tag-desc> |
1086 Adds the <literal>SameSite</literal> attribute to the cookie | 1088 Adds the <literal>SameSite</literal> (1.19.4) attribute to the cookie |
1087 with one of the following values (1.19.4): | 1089 with one of the following values: |
1090 <literal>Strict</literal>, | |
1091 <literal>Lax</literal>, | |
1092 <literal>None</literal>, or | |
1093 using variables (1.23.3). | |
1094 In the latter case, if the variable value is empty, | |
1095 the <literal>SameSite</literal> attribute will not be added to the cookie, | |
1096 if the value is resolved to | |
1088 <literal>Strict</literal>, | 1097 <literal>Strict</literal>, |
1089 <literal>Lax</literal>, or | 1098 <literal>Lax</literal>, or |
1090 <literal>None</literal>. | 1099 <literal>None</literal>, |
1100 the the corresponding value will be assigned, | |
1101 otherwise the <literal>Strict</literal> value will be assigned. | |
1091 </tag-desc> | 1102 </tag-desc> |
1092 | 1103 |
1093 <tag-name><literal>secure</literal></tag-name> | 1104 <tag-name><literal>secure</literal></tag-name> |
1094 <tag-desc> | 1105 <tag-desc> |
1095 Adds the <literal>Secure</literal> attribute to the cookie (1.7.11). | 1106 Adds the <literal>Secure</literal> attribute to the cookie (1.7.11). |