Skip to content

Commit 05ef601

Browse files
authored
Reinstate missing documentation (#28781)
The documentation for settings index.routing.allocation.enable, index.routing.rebalance.enable and index.gc_deletes was lost in f123a53. This change reinstates it.
1 parent 0b4d2f5 commit 05ef601

File tree

2 files changed

+29
-5
lines changed

2 files changed

+29
-5
lines changed

docs/reference/docs/delete.asciidoc

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -39,11 +39,14 @@ The result of the above delete operation is:
3939
[[delete-versioning]]
4040
=== Versioning
4141

42-
Each document indexed is versioned. When deleting a document, the
43-
`version` can be specified to make sure the relevant document we are
44-
trying to delete is actually being deleted and it has not changed in the
45-
meantime. Every write operation executed on a document, deletes included,
46-
causes its version to be incremented.
42+
Each document indexed is versioned. When deleting a document, the `version` can
43+
be specified to make sure the relevant document we are trying to delete is
44+
actually being deleted and it has not changed in the meantime. Every write
45+
operation executed on a document, deletes included, causes its version to be
46+
incremented. The version number of a deleted document remains available for a
47+
short time after deletion to allow for control of concurrent operations. The
48+
length of time for which a deleted document's version remains available is
49+
determined by the `index.gc_deletes` index setting and defaults to 60 seconds.
4750

4851
[float]
4952
[[delete-routing]]

docs/reference/index-modules.asciidoc

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -214,6 +214,27 @@ specific index module:
214214
The maximum length of regex that can be used in Regexp Query.
215215
Defaults to `1000`.
216216

217+
`index.routing.allocation.enable`::
218+
219+
Controls shard allocation for this index. It can be set to:
220+
* `all` (default) - Allows shard allocation for all shards.
221+
* `primaries` - Allows shard allocation only for primary shards.
222+
* `new_primaries` - Allows shard allocation only for newly-created primary shards.
223+
* `none` - No shard allocation is allowed.
224+
225+
`index.routing.rebalance.enable`::
226+
227+
Enables shard rebalancing for this index. It can be set to:
228+
* `all` (default) - Allows shard rebalancing for all shards.
229+
* `primaries` - Allows shard rebalancing only for primary shards.
230+
* `replicas` - Allows shard rebalancing only for replica shards.
231+
* `none` - No shard rebalancing is allowed.
232+
233+
`index.gc_deletes`::
234+
235+
The length of time that a <<delete-versioning,deleted document's version number>> remains available for <<index-versioning,further versioned operations>>.
236+
Defaults to `60s`.
237+
217238
[float]
218239
=== Settings in other index modules
219240

0 commit comments

Comments
 (0)