Skip to content

Commit 7e5e055

Browse files
authored
[DOCS] Fix system index refs in restore tutorial (#78582)
Fixes a couple of erroneous references related to system indices in the snapshot restore tutorial: * Calling the delete index API on `*` will only delete some system indices, such as the `.security`. It won't delete others, such as `.geoip_databases`. * Not all dot indices are system indices. Some are just hidden indices. Relates to #76929
1 parent 548bd30 commit 7e5e055

File tree

1 file changed

+9
-8
lines changed

1 file changed

+9
-8
lines changed

docs/reference/snapshot-restore/restore-snapshot.asciidoc

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -100,9 +100,10 @@ operation is complete.
100100
WARNING: If the
101101
<<action-destructive-requires-name,`action.destructive_requires_name`>> cluster
102102
setting is `false`, don't use the <<indices-delete-index,delete index API>> to
103-
target the `*` or `.*` wildcard expression. If you use {es}'s security features,
104-
this will delete system indices required for authentication. To delete all
105-
regular indices, use `*,-.*` instead.
103+
target the `*` or `.*` wildcard pattern. If you use {es}'s security features,
104+
this will delete system indices required for authentication. Instead, target the
105+
`*,-.*` wildcard pattern to exclude these system indices and other index names
106+
that begin with a dot (`.`).
106107

107108
[source,console]
108109
----
@@ -118,9 +119,10 @@ By default, a restore request attempts to restore all indices and data
118119
streams in the snapshot, including system indices. If your cluster already
119120
contains one or more of these system indices, the request will return an error.
120121

121-
To avoid this error, specify the indices and data streams to restore. To
122-
exclude system indices, append the `-.*` wildcard pattern. To restore all
123-
indices and data streams except system indices, use `*,-.*`.
122+
To avoid this error, specify the indices and data streams to restore. To exclude
123+
system indices and other index names that begin with a dot (`.`), append the
124+
`-.*` wildcard pattern. To restore all indices and data streams except dot
125+
indices, use `*,-.*`.
124126

125127
[source,console]
126128
----
@@ -323,8 +325,7 @@ PUT _cluster/settings
323325
----
324326
// TEST[setup:setup-snapshots]
325327

326-
. Delete all existing indices and data streams on the cluster, including all
327-
system indices.
328+
. Delete existing indices and data streams on the cluster.
328329
+
329330
[source,console]
330331
----

0 commit comments

Comments
 (0)