Skip to content

Commit 8055f68

Browse files
Fix clone API settings docs bug (#74175)
In #74138 we noted that index settings aren't copied in a clone. In fact that's not true, we copy everything except explicitly-excluded ones, `number_of_replicas` and `auto_expand_replicas`. This fixes the mistake. Co-authored-by: James Rodewig <[email protected]>
1 parent a5adc7d commit 8055f68

File tree

1 file changed

+11
-3
lines changed

1 file changed

+11
-3
lines changed

docs/reference/indices/clone-index.asciidoc

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -56,12 +56,20 @@ and then the previous write index can be cloned.
5656
Use the clone index API to clone an existing index into a new index, where each
5757
original primary shard is cloned into a new primary shard in the new index.
5858

59-
IMPORTANT: {es} doesn't apply index templates to the resulting index. The API
60-
also doesn't copy index settings or metadata from the original index. Index
61-
metadata includes aliases, {ilm-init} phase definitions, and {ccr-init} follower
59+
[IMPORTANT]
60+
====
61+
{es} doesn't apply index templates to the resulting index. The API
62+
also doesn't copy index metadata from the original index. Index metadata
63+
includes aliases, {ilm-init} phase definitions, and {ccr-init} follower
6264
information. For example, if you clone a {ccr-init} follower index, the
6365
resulting clone won't be a follower index.
6466
67+
The clone API copies most index settings from the source index to the resulting
68+
index, with the exception of `index.number_of_replicas` and
69+
`index.auto_expand_replicas`. To set the number of replicas in the resulting
70+
index, configure these settings in the clone request.
71+
====
72+
6573
[[cloning-works]]
6674
===== How cloning works
6775

0 commit comments

Comments
 (0)