Skip to content

Commit 94f5887

Browse files
moljac024bleskes
authored andcommitted
Document removal of forced versioning for update API (#28834)
1 parent e285310 commit 94f5887

File tree

1 file changed

+6
-8
lines changed

1 file changed

+6
-8
lines changed

docs/reference/docs/update.asciidoc

+6-8
Original file line numberDiff line numberDiff line change
@@ -307,22 +307,20 @@ By default the updated source is not returned.
307307
See <<search-request-source-filtering, `source filtering`>> for details.
308308

309309

310-
`version` & `version_type`::
310+
`version`::
311311

312312
The update API uses the Elasticsearch's versioning support internally to make
313313
sure the document doesn't change during the update. You can use the `version`
314314
parameter to specify that the document should only be updated if its version
315-
matches the one specified. By setting version type to `force` you can force
316-
the new version of the document after update (use with care! with `force`
317-
there is no guarantee the document didn't change).
315+
matches the one specified.
318316

319317
[NOTE]
320-
.The update API does not support external versioning
318+
.The update API does not support versioning other than internal
321319
=====================================================
322320
323-
External versioning (version types `external` & `external_gte`) is not
324-
supported by the update API as it would result in Elasticsearch version
325-
numbers being out of sync with the external system. Use the
321+
External (version types `external` & `external_gte`) or forced (version type `force`)
322+
versioning is not supported by the update API as it would result in Elasticsearch
323+
version numbers being out of sync with the external system. Use the
326324
<<docs-index_,`index` API>> instead.
327325
328326
=====================================================

0 commit comments

Comments
 (0)