OpenSearch/docs/reference/rest-api/common-parms.asciidoc

129 lines
3.4 KiB
Plaintext
Raw Normal View History

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::bytes[]
`bytes`::
(Optional, <<byte-units,byte size units>>) Unit used to display byte values.
end::bytes[]
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[]
2019-08-05 08:27:15 -04:00
tag::cat-h[]
`h`::
2019-08-05 08:27:15 -04:00
(Optional, string) Comma-separated list of column names to display.
end::cat-h[]
tag::flat-settings[]
`flat_settings`::
(Optional, boolean) If `true`, returns settings in flat format. Defaults to
`false`.
end::flat-settings[]
2019-08-05 08:27:15 -04:00
tag::help[]
`help`::
(Optional, boolean) If `true`, the response returns help information. Defaults
to `false`.
end::help[]
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::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[]
2019-08-06 08:36:22 -04:00
tag::index[]
`{index}`::
(Optional, string) Comma-separated list or wildcard expression of index names
used to limit the request.
2019-08-06 08:36:22 -04:00
end::index[]
2019-08-05 08:27:15 -04:00
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::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[]
2019-08-05 08:27:15 -04:00
tag::cat-s[]
`s`::
2019-08-05 08:27:15 -04:00
(Optional, string) Comma-separated list of column names or column aliases used
to sort the response.
end::cat-s[]
tag::cat-v[]
`v`::
2019-08-05 08:27:15 -04:00
(Optional, boolean) If `true`, the response includes column headings. Defaults
to `false`.
end::cat-v[]
tag::timeoutparms[]
2019-08-05 08:27:15 -04:00
`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`.
2019-08-05 08:27:15 -04:00
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`.
2019-08-05 08:27:15 -04:00
end::master-timeout[]
end::timeoutparms[]