Skip to content

Commit d4fee27

Browse files
authored
[DOCS] Fix system index refs in restore tutorial (#78582) (#78798)
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 # Conflicts: # docs/reference/snapshot-restore/restore-snapshot.asciidoc
1 parent ea94ed2 commit d4fee27

File tree

1 file changed

+10
-9
lines changed

1 file changed

+10
-9
lines changed

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

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -97,10 +97,11 @@ stream before restoring it. To prevent the accidental re-creation of the index
9797
or data stream, we recommend you temporarily stop all indexing until the restore
9898
operation is complete.
9999

100-
WARNING: Don't use the <<indices-delete-index,delete index API>> to target the
101-
`*` or `.*` wildcard expression. If you use {es}'s security features, this will
102-
delete system indices required for authentication. To delete all regular
103-
indices, use `*,-.*` instead.
100+
WARNING: Don't use the <<indices-delete-index,delete index API>> to
101+
target the `*` or `.*` wildcard pattern. If you use {es}'s security features,
102+
this will delete system indices required for authentication. Instead, target the
103+
`*,-.*` wildcard pattern to exclude these system indices and other index names
104+
that begin with a dot (`.`).
104105

105106
[source,console]
106107
----
@@ -116,9 +117,10 @@ By default, a restore request attempts to restore all indices and data
116117
streams in the snapshot, including system indices. If your cluster already
117118
contains one or more of these system indices, the request will return an error.
118119

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

123125
[source,console]
124126
----
@@ -321,8 +323,7 @@ PUT _cluster/settings
321323
----
322324
// TEST[setup:setup-snapshots]
323325

324-
. Delete all existing indices and data streams on the cluster, including all
325-
system indices.
326+
. Delete existing indices and data streams on the cluster.
326327
+
327328
[source,console]
328329
----

0 commit comments

Comments
 (0)