Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_api_module_head.xml @ 2139:f6e578b1b02d
Updated docs for the upcoming NGINX Plus release.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Mon, 09 Apr 2018 11:52:48 +0300 |
parents | fee7627f6a5a |
children | 45a2b90247ad |
comparison
equal
deleted
inserted
replaced
2138:cf86c259c9a0 | 2139:f6e578b1b02d |
---|---|
99 </example> | 99 </example> |
100 All API requests include | 100 All API requests include |
101 a supported API <link id="api_version">version</link> in the URI. | 101 a supported API <link id="api_version">version</link> in the URI. |
102 Examples of API requests with this configuration: | 102 Examples of API requests with this configuration: |
103 <example> | 103 <example> |
104 http://127.0.0.1/api/2/ | 104 http://127.0.0.1/api/3/ |
105 http://127.0.0.1/api/2/nginx | 105 http://127.0.0.1/api/3/nginx |
106 http://127.0.0.1/api/2/connections | 106 http://127.0.0.1/api/3/connections |
107 http://127.0.0.1/api/2/http/requests | 107 http://127.0.0.1/api/3/http/requests |
108 http://127.0.0.1/api/2/http/server_zones/server_backend | 108 http://127.0.0.1/api/3/http/server_zones/server_backend |
109 http://127.0.0.1/api/2/http/caches/cache_backend | 109 http://127.0.0.1/api/3/http/caches/cache_backend |
110 http://127.0.0.1/api/2/http/upstreams/backend | 110 http://127.0.0.1/api/3/http/upstreams/backend |
111 http://127.0.0.1/api/2/http/upstreams/backend/servers/ | 111 http://127.0.0.1/api/3/http/upstreams/backend/servers/ |
112 http://127.0.0.1/api/2/http/upstreams/backend/servers/1 | 112 http://127.0.0.1/api/3/http/upstreams/backend/servers/1 |
113 http://127.0.0.1/api/2/http/keyvals/one?key=arg1 | 113 http://127.0.0.1/api/3/http/keyvals/one?key=arg1 |
114 http://127.0.0.1/api/2/stream/ | 114 http://127.0.0.1/api/3/stream/ |
115 http://127.0.0.1/api/2/stream/server_zones/server_backend | 115 http://127.0.0.1/api/3/stream/server_zones/server_backend |
116 http://127.0.0.1/api/2/stream/upstreams/ | 116 http://127.0.0.1/api/3/stream/upstreams/ |
117 http://127.0.0.1/api/2/stream/upstreams/backend | 117 http://127.0.0.1/api/3/stream/upstreams/backend |
118 http://127.0.0.1/api/2/stream/upstreams/backend/servers/1 | 118 http://127.0.0.1/api/3/stream/upstreams/backend/servers/1 |
119 </example> | 119 </example> |
120 </para> | 120 </para> |
121 | 121 |
122 </section> | 122 </section> |
123 | 123 |
144 | 144 |
145 <para id="api_version"> | 145 <para id="api_version"> |
146 All API requests should contain a supported API version in the URI. | 146 All API requests should contain a supported API version in the URI. |
147 If the request URI equals the location prefix, | 147 If the request URI equals the location prefix, |
148 the list of supported API versions is returned. | 148 the list of supported API versions is returned. |
149 The current API version is “<literal>2</literal>”. | 149 The current API version is “<literal>3</literal>”. |
150 </para> | 150 </para> |
151 | 151 |
152 <para> | 152 <para> |
153 The optional “<literal>fields</literal>” argument in the request line | 153 The optional “<literal>fields</literal>” argument in the request line |
154 specifies which fields of the requested objects will be output: | 154 specifies which fields of the requested objects will be output: |
155 <example> | 155 <example> |
156 http://127.0.0.1/api/2/nginx?fields=version,build | 156 http://127.0.0.1/api/3/nginx?fields=version,build |
157 </example> | 157 </example> |
158 </para> | 158 </para> |
159 | 159 |
160 </directive> | 160 </directive> |
161 | 161 |
163 | 163 |
164 <section id="compatibility" name="Compatibility"> | 164 <section id="compatibility" name="Compatibility"> |
165 | 165 |
166 <para> | 166 <para> |
167 <list type="bullet"> | 167 <list type="bullet"> |
168 | |
169 <listitem> | |
170 The <link id="stream_zone_sync_">/stream/zone_sync/</link> data | |
171 were added in <link id="api_version">version</link> 3. | |
172 </listitem> | |
168 | 173 |
169 <listitem> | 174 <listitem> |
170 The <link id="def_nginx_http_upstream_conf_server">drain</link> parameter | 175 The <link id="def_nginx_http_upstream_conf_server">drain</link> parameter |
171 was added in <link id="api_version">version</link> 2. | 176 was added in <link id="api_version">version</link> 2. |
172 </listitem> | 177 </listitem> |