58 lines
1.9 KiB
Plaintext
58 lines
1.9 KiB
Plaintext
[[breaking_50_document_api_changes]]
|
|
=== Document API changes
|
|
|
|
==== `?refresh` no longer supports truthy and falsy values
|
|
The `?refresh` request parameter used to accept any value other than `false`,
|
|
`0`, `off`, and `no` to mean "make the changes from this request visible for
|
|
search immediately." Now it only accepts `?refresh` and `?refresh=true` to
|
|
mean that. You can set it to `?refresh=false` and the request will take no
|
|
refresh-related action. The same is true if you leave `refresh` off of the
|
|
url entirely. If you add `?refresh=wait_for` Elasticsearch will wait for the
|
|
changes to become visible before replying to the request but won't take any
|
|
immediate refresh related action. See <<docs-refresh>>.
|
|
|
|
==== `created` field deprecated in the Index API
|
|
|
|
The `created` field has been deprecated in the Index API. It now returns
|
|
`operation`, returning `"operation": "create"` when it created a document and
|
|
`"operation": "index"` when it updated the document. This is also true for
|
|
`index` bulk operations.
|
|
|
|
==== `found` field deprecated in the Delete API
|
|
|
|
The `found` field has been deprecated in the Delete API. It now returns
|
|
`operation`, returning `"operation": "deleted"` when it deleted a document and
|
|
`"operation": "noop"` when it didn't found the document. This is also true for
|
|
`index` bulk operations.
|
|
|
|
==== Reindex and Update By Query
|
|
Before 5.0.0 `_reindex` and `_update_by_query` only retried bulk failures so
|
|
they used the following response format:
|
|
|
|
[source,js]
|
|
----------------------
|
|
{
|
|
...
|
|
"retries": 10
|
|
...
|
|
}
|
|
----------------------
|
|
|
|
Where `retries` counts the number of bulk retries. Now they retry on search
|
|
failures as well and use this response format:
|
|
|
|
[source,js]
|
|
----------------------
|
|
{
|
|
...
|
|
"retries": {
|
|
"bulk": 10,
|
|
"search": 1
|
|
}
|
|
...
|
|
}
|
|
----------------------
|
|
|
|
Where `bulk` counts the number of bulk retries and `search` counts the number
|
|
of search retries.
|