From 6953726a2beafc36de9a90030c0bb5914d1c9e69 Mon Sep 17 00:00:00 2001 From: Armin Braun Date: Wed, 18 Nov 2020 18:25:09 +0100 Subject: [PATCH] Fix Allocation `include` Filter Docs (#65202) (#65223) Fix documentation to match actual behavior of `include` type filters. Closes #65113 --- .../index-modules/allocation/filtering.asciidoc | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/docs/reference/index-modules/allocation/filtering.asciidoc b/docs/reference/index-modules/allocation/filtering.asciidoc index 27da952a36f..6b481fb9a51 100644 --- a/docs/reference/index-modules/allocation/filtering.asciidoc +++ b/docs/reference/index-modules/allocation/filtering.asciidoc @@ -59,16 +59,23 @@ PUT test/_settings ------------------------ // TEST[s/^/PUT test\n/] -If you specify multiple filters, all conditions must be satisfied for shards to -be relocated. For example, to move the `test` index to `big` nodes in `rack1`, -you could specify: +If you specify multiple filters the following conditions must be satisfied +simultaneously by a node in order for shards to be relocated to it: + +* If any `require` type conditions are specified, all of them must be satisfied +* If any `exclude` type conditions are specified, none of them may be satisfied +* If any `include` type conditions are specified, at least one of them must be +satisfied + +For example, to move the `test` index to `big` nodes in `rack1`, you could +specify: [source,console] ------------------------ PUT test/_settings { - "index.routing.allocation.include.size": "big", - "index.routing.allocation.include.rack": "rack1" + "index.routing.allocation.require.size": "big", + "index.routing.allocation.require.rack": "rack1" } ------------------------ // TEST[s/^/PUT test\n/]