[DOCS] Reformat get mapping API. Reformat and reuse multi-index params.#45699
[DOCS] Reformat get mapping API. Reformat and reuse multi-index params.#45699jrodewig merged 4 commits intoelastic:masterfrom jrodewig:get-mapping-reformat
Conversation
* Updates the get mapping API to use the new Elastic API reference template: https://github.com/elastic/docs/blob/master/shared/api-ref-ex.asciidoc * Adds documentation for several multi-index parameters to common-parms.asciidoc for reuse throughout API reference documentation. * Updates API conventions chapter to reuse parameters from common-parms.asciidoc
|
Pinging @elastic/es-core-features |
|
Pinging @elastic/es-search |
|
Pinging @elastic/es-docs |
szabosteve
left a comment
There was a problem hiding this comment.
I left one comment regarding the common param changes.
| (Optional, string) Controls what kind of indices that wildcard | ||
| expressions can expand to. Valid values are: | ||
|
|
||
| `open`:: |
There was a problem hiding this comment.
Should it be open,closed rather than simply open? The next value is also open, based on the descriptions, the first one should be changed.
There was a problem hiding this comment.
Thanks for catching that. It should be all. Fixed with b8653d3.
| 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[] |
There was a problem hiding this comment.
@jrodewig It seems this behaves opposite of the description here. afaict allow_no_indices = true will allow empty indices and thus not return an error. allow_no_indices = false will not allow empty and will return an error if empty indicies are encountered.
cc @weltenwort
Changes
Updates the get mapping API to use the new Elastic API reference
template.
Adds documentation for several multi-index parameters to
common-parms.asciidocfor reuse throughout API referencedocumentation.
Updates API conventions chapter to reuse parameters from
common-parms.asciidoc.Relates to elastic/docs#937 and #43765
Preview
http://elasticsearch_45699.docs-preview.app.elstc.co/guide/en/elasticsearch/reference/master/indices-get-mapping.html