honeymoose/OpenSearch
1
0
Fork 0
mirror of https://github.com/honeymoose/OpenSearch.git synced 2025-02-17 10:25:15 +00:00
Code Issues Packages Projects Releases Wiki Activity

Clarify _doc is a permanent part of certain document APIs. (#41727)

Browse Source 
We received some feedback that it is not completely clear why `_doc` is present
in the typeless document APIs:

> The new index APIs are PUT {index}/_doc/{id} in case of explicit ids and POST
{index}/_doc for auto-generated ids."_ Isn't this contradicting? Specifying
*types in requests is deprecated*, but we are supposed to still mention *_doc*
in write requests?

This PR updates the 'removal of types' documentation to try to clarify that
`_doc` now represents the endpoint name, as opposed to a type.
This commit is contained in:
Julie Tibshirani 2019-05-06 10:38:54 -07:00
parent 70bf432fa8
commit eb9bce3930
1 changed files with 6 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
docs/reference/mapping/removal_of_types.asciidoc
View File

@ -270,7 +270,8 @@ Elasticsearch 7.x::
* Specifying types in requests is deprecated. For instance, indexing a
document no longer requires a document `type`. The new index APIs
are `PUT {index}/_doc/{id}` in case of explicit ids and `POST {index}/_doc`
for auto-generated ids.
for auto-generated ids. Note that in 7.0, `_doc` is a permanent part of the
path, and represents the endpoint name rather than the document type.
* The `include_type_name` parameter in the index creation, index template,
and mapping APIs will default to `false`. Setting the parameter at all will
@ -554,6 +555,10 @@ GET index/_doc/1
// CONSOLE
// TEST[continued]
NOTE: In 7.0, `_doc` represents the endpoint name instead of the document type.
The `_doc` component is a permanent part of the path for the document `index`,
`get`, and `delete` APIs going forward, and will not be removed in 8.0.
For API paths that contain both a type and endpoint name like `_update`,
in 7.0 the endpoint will immediately follow the index name: