WARNING: Version 1.3 of Elasticsearch has passed its EOL date.

This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

« Local Gateway Indices »
Elastic Docs ›Elasticsearch Guide [1.3] ›Modules

HTTP

edit

HTTP

edit

The http module allows to expose elasticsearch APIs over HTTP.

The http mechanism is completely asynchronous in nature, meaning that there is no blocking thread waiting for a response. The benefit of using asynchronous communication for HTTP is solving the C10k problem.

When possible, consider using HTTP keep alive when connecting for better performance and try to get your favorite client not to do HTTP chunking.

HTTP pipelining is not supported and should be disabled in your HTTP client.

Settings

edit

The following are the settings that can be configured for HTTP:

Setting Description

http.port

A bind port range. Defaults to 9200-9300.

http.bind_host

The host address to bind the HTTP service to. Defaults to http.host (if set) or network.bind_host.

http.publish_host

The host address to publish for HTTP clients to connect to. Defaults to http.host (if set) or network.publish_host.

http.host

Used to set the http.bind_host and the http.publish_host Defaults to http.host or network.host.

http.max_content_length

The max content of an HTTP request. Defaults to 100mb

http.max_initial_line_length

The max length of an HTTP URL. Defaults to 4kb

http.compression

Support for compression when possible (with Accept-Encoding). Defaults to false.

http.compression_level

Defines the compression level to use. Defaults to 6.

http.cors.enabled

Enable or disable cross-origin resource sharing, i.e. whether a browser on another origin can do requests to Elasticsearch. Defaults to true.

http.cors.allow-origin

Which origins to allow. Defaults to *, i.e. any origin.

http.cors.max-age

Browsers send a "preflight" OPTIONS-request to determine CORS settings. max-age defines how long the result should be cached for. Defaults to 1728000 (20 days)

http.cors.allow-methods

Which methods to allow. Defaults to OPTIONS, HEAD, GET, POST, PUT, DELETE.

http.cors.allow-headers

Which headers to allow. Defaults to X-Requested-With, Content-Type, Content-Length.

It also uses the common network settings.

Disable HTTP

edit

The http module can be completely disabled and not started by setting http.enabled to false. This make sense when creating non data nodes which accept HTTP requests, and communicate with data nodes using the internal transport.

« Local Gateway Indices »