372 lines
9.7 KiB
Plaintext
372 lines
9.7 KiB
Plaintext
|
|
tag::index-alias[]
|
|
Comma-separated list or wildcard expression of index alias names
|
|
used to limit the request.
|
|
end::index-alias[]
|
|
|
|
tag::index-alias-filter[]
|
|
<<query-dsl-bool-query, Filter query>>
|
|
used to limit the index alias.
|
|
+
|
|
If specified,
|
|
the index alias only applies to documents returned by the filter.
|
|
end::index-alias-filter[]
|
|
|
|
tag::allow-no-indices[]
|
|
`allow_no_indices`::
|
|
(Optional, boolean) If `true`, the request returns an error if a wildcard
|
|
expression or `_all` value retrieves only missing or closed indices. This
|
|
parameter also applies to <<indices-aliases,index aliases>> that point to a
|
|
missing or closed index.
|
|
end::allow-no-indices[]
|
|
|
|
tag::analyzer[]
|
|
analyzer`::
|
|
(Optional, string) Analyzer to use for the query string.
|
|
end::analyzer[]
|
|
|
|
tag::analyze_wildcard[]
|
|
`analyze_wildcard`::
|
|
(Optional, boolean) If `true`, wildcard and prefix queries are
|
|
analyzed. Defaults to `false`.
|
|
end::analyze_wildcard[]
|
|
|
|
tag::bytes[]
|
|
`bytes`::
|
|
(Optional, <<byte-units,byte size units>>) Unit used to display byte values.
|
|
end::bytes[]
|
|
|
|
tag::default_operator[]
|
|
`default_operator`::
|
|
(Optional, string) The default operator for query string query: AND or OR.
|
|
Defaults to `OR`.
|
|
end::default_operator[]
|
|
|
|
tag::df[]
|
|
`df`::
|
|
(Optional, string) Field to use as default where no field prefix is
|
|
given in the query string.
|
|
end::df[]
|
|
|
|
tag::expand-wildcards[]
|
|
`expand_wildcards`::
|
|
+
|
|
--
|
|
(Optional, string) Controls what kind of indices that wildcard
|
|
expressions can expand to. Valid values are:
|
|
|
|
`all`::
|
|
Expand to open and closed indices.
|
|
|
|
`open`::
|
|
Expand only to open indices.
|
|
|
|
`closed`::
|
|
Expand only to closed indices.
|
|
|
|
`none`::
|
|
Wildcard expressions are not accepted.
|
|
--
|
|
end::expand-wildcards[]
|
|
|
|
tag::flat-settings[]
|
|
`flat_settings`::
|
|
(Optional, boolean) If `true`, returns settings in flat format. Defaults to
|
|
`false`.
|
|
end::flat-settings[]
|
|
|
|
tag::http-format[]
|
|
`format`::
|
|
(Optional, string) Short version of the
|
|
https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html[HTTP accept header].
|
|
Valid values include JSON, YAML, etc.
|
|
end::http-format[]
|
|
|
|
tag::from[]
|
|
`from`::
|
|
(Optional, integer) Starting document offset. Defaults to `0`.
|
|
end::from[]
|
|
|
|
tag::cat-h[]
|
|
`h`::
|
|
(Optional, string) Comma-separated list of column names to display.
|
|
end::cat-h[]
|
|
|
|
tag::help[]
|
|
`help`::
|
|
(Optional, boolean) If `true`, the response returns help information. Defaults
|
|
to `false`.
|
|
end::help[]
|
|
|
|
tag::if_primary_term[]
|
|
`if_primary_term`::
|
|
(Optional, integer) Only perform the operation if the document has
|
|
this primary term. See <<optimistic-concurrency-control-index>>.
|
|
end::if_primary_term[]
|
|
|
|
tag::if_seq_no[]
|
|
`if_seq_no`::
|
|
(Optional, integer) Only perform the operation if the document has this
|
|
sequence number. See <<optimistic-concurrency-control-index>>.
|
|
end::if_seq_no[]
|
|
|
|
tag::cat-h[]
|
|
`h`::
|
|
(Optional, string) Comma-separated list of column names to display.
|
|
end::cat-h[]
|
|
|
|
tag::help[]
|
|
`help`::
|
|
(Optional, boolean) If `true`, the response returns help information. Defaults
|
|
to `false`.
|
|
end::help[]
|
|
|
|
tag::include-defaults[]
|
|
`include_defaults`::
|
|
(Optional, string) If `true`, return all default settings in the response.
|
|
Defaults to `false`.
|
|
end::include-defaults[]
|
|
|
|
tag::include-type-name[]
|
|
`include_type_name`::
|
|
deprecated:[7.0.0, Mapping types have been deprecated. See <<removal-of-types>>.]
|
|
(Optional, boolean) If `true`, a mapping type is expected in the body of
|
|
mappings. Defaults to `false`.
|
|
end::include-type-name[]
|
|
|
|
tag::index-ignore-unavailable[]
|
|
`ignore_unavailable`::
|
|
(Optional, boolean) If `true`, missing or closed indices are not included in the
|
|
response. Defaults to `false`.
|
|
end::index-ignore-unavailable[]
|
|
|
|
tag::include-unloaded-segments[]
|
|
`include_unloaded_segments`::
|
|
(Optional, boolean) If `true`, the response includes information from segments
|
|
that are **not** loaded into memory. Defaults to `false`.
|
|
end::include-unloaded-segments[]
|
|
|
|
tag::index[]
|
|
`<index>`::
|
|
(Optional, string) Comma-separated list or wildcard expression of index names
|
|
used to limit the request.
|
|
end::index[]
|
|
|
|
tag::index-template[]
|
|
`<index-template>`::
|
|
(Required, string)
|
|
Comma-separated list or wildcard expression of index template names
|
|
used to limit the request.
|
|
end::index-template[]
|
|
|
|
tag::lenient[]
|
|
`lenient`::
|
|
(Optional, boolean) If `true`, format-based query failures (such as
|
|
providing text to a numeric field) will be ignored. Defaults to `false`.
|
|
end::lenient[]
|
|
|
|
tag::local[]
|
|
`local`::
|
|
(Optional, boolean) If `true`, the request retrieves information from the local
|
|
node only. Defaults to `false`, which means information is retrieved from
|
|
the master node.
|
|
end::local[]
|
|
|
|
tag::max_docs[]
|
|
`max_docs`::
|
|
(Optional, integer) Maximum number of documents to process. Defaults to all
|
|
documents.
|
|
end::max_docs[]
|
|
|
|
tag::name[]
|
|
`<name>`::
|
|
(Optional, string) Comma-separated list of alias names to return.
|
|
end::name[]
|
|
|
|
tag::node-id[]
|
|
`<node_id>`::
|
|
(Optional, string) Comma-separated list of node IDs or names used to limit
|
|
returned information.
|
|
end::node-id[]
|
|
|
|
tag::pipeline[]
|
|
`pipeline`::
|
|
(Optional, string) ID of the pipeline to use to preprocess incoming documents.
|
|
end::pipeline[]
|
|
|
|
tag::preference[]
|
|
`preference`::
|
|
(Optional, string) Specifies the node or shard the operation should be
|
|
performed on. Random by default.
|
|
end::preference[]
|
|
|
|
tag::search-q[]
|
|
`q`::
|
|
(Optional, string) Query in the Lucene query string syntax.
|
|
end::search-q[]
|
|
|
|
tag::refresh[]
|
|
`refresh`::
|
|
(Optional, enum) If `true`, {es} refreshes the affected shards to make this
|
|
operation visible to search, if `wait_for` then wait for a refresh to make
|
|
this operation visible to search, if `false` do nothing with refreshes.
|
|
Valid values: `true`, `false`, `wait_for`. Default: `false`.
|
|
end::refresh[]
|
|
|
|
tag::request_cache[]
|
|
`request_cache`::
|
|
(Optional, boolean) Specifies if the request cache should be used for this
|
|
request. Defaults to the index-level setting.
|
|
end::request_cache[]
|
|
|
|
tag::requests_per_second[]
|
|
`requests_per_second`::
|
|
(Optional, integer) The throttle for this request in sub-requests per second.
|
|
-1 means no throttle. Defaults to 0.
|
|
end::requests_per_second[]
|
|
|
|
tag::routing[]
|
|
`routing`::
|
|
(Optional, string) Target the specified primary shard.
|
|
end::routing[]
|
|
|
|
tag::index-routing[]
|
|
`routing`::
|
|
(Optional, string)
|
|
Custom <<mapping-routing-field, routing value>>
|
|
used to route operations to a specific shard.
|
|
end::index-routing[]
|
|
|
|
tag::cat-s[]
|
|
`s`::
|
|
(Optional, string) Comma-separated list of column names or column aliases used
|
|
to sort the response.
|
|
end::cat-s[]
|
|
|
|
tag::scroll[]
|
|
`scroll`::
|
|
(Optional, <<time-units, time units>>) Specifies how long a consistent view of
|
|
the index should be maintained for scrolled search.
|
|
end::scroll[]
|
|
|
|
tag::scroll_size[]
|
|
`scroll_size`::
|
|
(Optional, integer) Size of the scroll request that powers the operation.
|
|
Defaults to 100.
|
|
end::scroll_size[]
|
|
|
|
tag::search_timeout[]
|
|
`search_timeout`::
|
|
(Optional, <<time-units, time units>> Explicit timeout for each search
|
|
request. Defaults to no timeout.
|
|
end::search_timeout[]
|
|
|
|
tag::search_type[]
|
|
`search_type`::
|
|
(Optional, string) The type of the search operation. Available options:
|
|
* `query_then_fetch`
|
|
* `dfs_query_then_fetch`
|
|
end::search_type[]
|
|
|
|
tag::slices[]
|
|
`slices`::
|
|
(Optional, integer) The number of slices this task should be divided into.
|
|
Defaults to 1 meaning the task isn't sliced into subtasks.
|
|
end::slices[]
|
|
|
|
tag::sort[]
|
|
`sort`::
|
|
(Optional, string) A comma-separated list of <field>:<direction> pairs.
|
|
end::sort[]
|
|
|
|
tag::source[]
|
|
`_source`::
|
|
(Optional, string) True or false to return the `_source` field or not, or a
|
|
list of fields to return.
|
|
end::source[]
|
|
|
|
tag::source_excludes[]
|
|
`_source_excludes`::
|
|
(Optional, string) A list of fields to exclude from the returned `_source`
|
|
field.
|
|
end::source_excludes[]
|
|
|
|
tag::source_includes[]
|
|
`_source_includes`::
|
|
(Optional, string) A list of fields to extract and return from the `_source`
|
|
field.
|
|
end::source_includes[]
|
|
|
|
tag::stats[]
|
|
`stats`::
|
|
(Optional, string) Specific `tag` of the request for logging and statistical
|
|
purposes.
|
|
end::stats[]
|
|
|
|
tag::terminate_after[]
|
|
`terminate_after`::
|
|
(Optional, integer) The maximum number of documents to collect for each shard,
|
|
upon reaching which the query execution will terminate early.
|
|
end::terminate_after[]
|
|
|
|
tag::timeoutparms[]
|
|
|
|
tag::timeout[]
|
|
`timeout`::
|
|
(Optional, <<time-units, time units>>) Specifies the period of time to wait for
|
|
a response. If no response is received before the timeout expires, the request
|
|
fails and returns an error. Defaults to `30s`.
|
|
end::timeout[]
|
|
|
|
tag::master-timeout[]
|
|
`master_timeout`::
|
|
(Optional, <<time-units, time units>>) Specifies the period of time to wait for
|
|
a connection to the master node. If no response is received before the timeout
|
|
expires, the request fails and returns an error. Defaults to `30s`.
|
|
end::master-timeout[]
|
|
|
|
end::timeoutparms[]
|
|
|
|
tag::cat-v[]
|
|
`v`::
|
|
(Optional, boolean) If `true`, the response includes column headings. Defaults
|
|
to `false`.
|
|
end::cat-v[]
|
|
|
|
tag::version[]
|
|
`version`::
|
|
(Optional, boolean) If `true`, returns the document version as part of a hit.
|
|
end::version[]
|
|
|
|
tag::doc-version[]
|
|
`version`::
|
|
(Optional, integer) Explicit version number for concurrency control.
|
|
The specified version must match the current version of the document for the
|
|
request to succeed.
|
|
end::doc-version[]
|
|
|
|
tag::version_type[]
|
|
`version_type`::
|
|
(Optional, enum) Specific version type: `internal`, `external`,
|
|
`external_gte`, `force`.
|
|
end::version_type[]
|
|
|
|
tag::wait_for_active_shards[]
|
|
`wait_for_active_shards`::
|
|
+
|
|
--
|
|
(Optional, string) The number of shard copies that must be active before
|
|
proceeding with the operation. Set to `all` or any positive integer up
|
|
to the total number of shards in the index (`number_of_replicas+1`).
|
|
Default: 1, the primary shard.
|
|
|
|
See <<index-wait-for-active-shards>>.
|
|
--
|
|
end::wait_for_active_shards[]
|
|
|
|
tag::wait_for_completion[]
|
|
`wait_for_completion`::
|
|
(Optional, boolean) Should the request block until the operation is
|
|
complete. Defaults to `true`.
|
|
end::wait_for_completion[]
|