Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_upstream_module.xml @ 2914:3a2d342533fb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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).