Skip to content

Conversation

@stefnestor
Copy link
Contributor

👋 howdy, team!

This

  • adds in the two most common errors encountered when snapshot restoring feature states / system indices wrong
  • cross-links how to get the needed restricted permissions to restore system feature states (and removes outdated-since-v8.0 information which no longer works)
  • adds in an example API outline of reading the feature state to its snapshot appearance to determining which to restore

Related changed pages

@stefnestor
Copy link
Contributor Author

👋 may I have help on failing check

info ::e.d.i.atedBuildService:: Finished building and exporting exporters Html, LLMText, Configuration, DocumentationState, LinkMetadata, Redirects

	The following errors and warnings were found in the documentation

Error: 'reference/cloud/cloud-hosted/ec-api-console.md' is not a valid link in the 'cloud' cross link index: https://elastic-docs-link-index.s3.us-east-2.amazonaws.com/elastic/cloud/master/links.json
     ┌─[/github/workspace/deploy-manage/tools/snapshot-and-restore/restore-snapshot.md]
     │
 233 │ Restoring the `security` feature state overwrites system indices used for authentication. If you use {{ech}} or {{ece}}, ensure you have access to the [{{es}} API console](cloud://reference/cloud/cloud-hosted/ec-api-console.md) before restoring the `security` feature state. If you run {{es}} on your own hardware or in {{eck}}, [create a temporary user with elevated permissions to edit restricted indices in the file realm](/troubleshoot/elasticsearch/file-based-recovery.md) to ensure you’ll still be able to access your cluster.
     ·                                                                                                                                                       ──────────────────────────────────────────────────────                                                                                                                                                                                                                                                                                                                                        
     ·                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      
     │
     └─



	1 Errors / 0 Warnings / 0 Hints

related documentation doesn't say how to cross-link cloud reference section 🙏

@github-actions
Copy link

github-actions bot commented Nov 10, 2025

Copy link
Contributor

@yetanothertw yetanothertw left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @stefnestor -- thank you so much for your contributions! 🌻

I've fixed the link that was causing the check to fail, and the docs build fine now. I've also left a few suggestions for style and clarity for your consideration.

@stefnestor stefnestor merged commit cbff4c0 into elastic:main Nov 10, 2025
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants