root
/
elasticsearch
mirror of https://github.com/elastic/elasticsearch.git
1
0
Fork 0
Code Issues Actions 1 Packages Projects Releases Wiki Activity
elasticsearch/docs/reference/snapshot-restore/apis/snapshot-restore-apis.asciidoc

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

41 lines
1.4 KiB
Plaintext
Raw Normal View History

[DOCS] Add clean up snapshot repository API docs (#56519)
2020-05-12 20:56:29 +08:00
[[snapshot-restore-apis]]
== Snapshot and restore APIs
You can use the following APIs to set up snapshot repositories, manage snapshot
backups, and restore snapshots to a running cluster.
For more information, see <<snapshot-restore>>.
[discrete]
[[snapshot-restore-repo-apis]]
=== Snapshot repository management APIs
[DOCS] Fix missing word for snapshot API (#74657)
2021-06-29 15:07:17 +08:00
* <<put-snapshot-repo-api,Create or update snapshot repository>>
[DOCS] Add verify snapshot repository API docs (#57253)
2020-05-28 21:35:19 +08:00
* <<verify-snapshot-repo-api,Verify snapshot repository>>
[DOCS] Adding delete snapshot API docs. (#58865) * [DOCS] Adding delete snapshot API docs. * Adding TESTSETUP snippets and fixing original TEST. * Removing extraneous TESTSETUP. * Revising <snapshot> description. * Removing TEST. * Streamline delete API description. * Improve TESTSETUP for snippets.
2020-07-02 02:34:02 +08:00
* <<get-snapshot-repo-api,Get snapshot repository>>
* <<delete-snapshot-repo-api,Delete snapshot repository>>
* <<clean-up-snapshot-repo-api,Clean up snapshot repository>>
[DOCS] Add clean up snapshot repository API docs (#56519)
2020-05-12 20:56:29 +08:00
[DOCS] Adding create index snapshot API docs (#58519) * Adding create index snapshot API page. * Condense API description. * Remove parameter from query. * Add POST method and remove `-name` from the snapshot variable. * Expand description of `<snapshot>`. * Add data streams to introduction and expand the overall description. * Add support for data streams. * Add support for data streams. * Add data stream and reference for "point-in-time view". * Add data streams. * Change `my_backup` to `my_repository`. * Add description of boolean options for `wait_for_completion` parameter. * Change command --> response * Clarify `indices` parameter description * Update `ignore-unavailable` parameter description * Reword example description * Remove "index" from API name * Incorporating review comments from James R. * Adding a much better request + response * Clarify `include_global_state` description * Incorporating additional edits. * Changing my_backup to my_repository in example. * Update snippet test to avoid failures * Update TESTRESPONSE snippets * Remove errant space * Removing the parameter per reviewer comments
2020-06-30 02:53:30 +08:00
[discrete]
[[snapshot-management-apis]]
=== Snapshot management APIs
* <<create-snapshot-api,Create snapshot>>
Move clone snapshot API page. (#63902)
2020-10-20 20:45:38 +08:00
* <<clone-snapshot-api,Clone snapshot>>
[DOCS] Adding get snapshot API docs (#59098) * Adding page for get snapshot API. * Adding values for state and cleaning up some other formatting. * Adding missing forward slash to GET request. * Updating values for start_time and end_time in TESTRESPONSE. * Swap "return" for "retrieve" * Swap "return" for "retrieve" 2 * Change .snapshot to .response * Adding response parameters and incorporating edits from review. * Update response example to include repository info * Change dash to underscore * Add data type for snapshot in response * Incorporating review comments and adding missing response definitions. * Minor rewording in description.
2020-07-08 23:28:24 +08:00
* <<get-snapshot-api,Get snapshot>>
[DOCS] Adding get snapshot status API docs (#59355) * Adding get snapshot status API docs. * Adding more fields and a link to the new page. * Adding missing spaces in TESTRESPONSES * Adding more parameters and making some edits. * Marking snapshot as optional * Marking repository as optional * Add data type for stats * Add data type for shard_stats * Incorporating review feedback. * Lots of review feedback incorporated. * Fixing tests to unbreak CI builds. * Changing indices to index.
2020-07-16 04:28:43 +08:00
* <<get-snapshot-status-api,Get snapshot status>>
[DOCS] Adding new page for restore snapshot API (#59937) * Adding new page for restore snapshot API. * Improving test cases, lots of edits, and streamlining content. * Incorporating review suggestions and feedback. * Specify `index alias` vs `alias` * Change parameter order * Provide clarity around regular expression * Add link to SLM parameters * Split sentences in example * Adding link to master node page.
2020-07-22 23:42:17 +08:00
* <<restore-snapshot-api,Restore snapshot>>
[DOCS] Adding delete snapshot API docs. (#58865) * [DOCS] Adding delete snapshot API docs. * Adding TESTSETUP snippets and fixing original TEST. * Removing extraneous TESTSETUP. * Revising <snapshot> description. * Removing TEST. * Streamline delete API description. * Improve TESTSETUP for snippets.
2020-07-02 02:34:02 +08:00
* <<delete-snapshot-api,Delete snapshot>>
[DOCS] Add clean up snapshot repository API docs (#56519)
2020-05-12 20:56:29 +08:00
[DOCS] Add verify snapshot repository API docs (#57253)
2020-05-28 21:35:19 +08:00
include::put-repo-api.asciidoc[]
[DOCS] Adding create index snapshot API docs (#58519) * Adding create index snapshot API page. * Condense API description. * Remove parameter from query. * Add POST method and remove `-name` from the snapshot variable. * Expand description of `<snapshot>`. * Add data streams to introduction and expand the overall description. * Add support for data streams. * Add support for data streams. * Add data stream and reference for "point-in-time view". * Add data streams. * Change `my_backup` to `my_repository`. * Add description of boolean options for `wait_for_completion` parameter. * Change command --> response * Clarify `indices` parameter description * Update `ignore-unavailable` parameter description * Reword example description * Remove "index" from API name * Incorporating review comments from James R. * Adding a much better request + response * Clarify `include_global_state` description * Incorporating additional edits. * Changing my_backup to my_repository in example. * Update snippet test to avoid failures * Update TESTRESPONSE snippets * Remove errant space * Removing the parameter per reviewer comments
2020-06-30 02:53:30 +08:00
include::verify-repo-api.asciidoc[]
Introduce repository test kit/analyser (#67247) Today we rely on blob stores behaving in a certain way so that they can be used as a snapshot repository. There are an increasing number of third-party blob stores that claim to be S3-compatible, but which may not offer a suitably correct or performant implementation of the S3 API. We rely on somesubtle semantics with concurrent readers and writers, but some blob stores may not implement it correctly. Hitting a corner case in the implementation may be rare in normal use, and may be hard to reproduce or to distinguish from an Elasticsearch bug. This commit introduces a new `POST /_snapshot/.../_analyse` API which exercises the more problematic corners of the repository implementation looking for correctness bugs and measures the details of the performance of the repository under concurrent load.
2021-02-16 22:24:40 +08:00
include::repo-analysis-api.asciidoc[]
[DOCS] Adding delete snapshot API docs. (#58865) * [DOCS] Adding delete snapshot API docs. * Adding TESTSETUP snippets and fixing original TEST. * Removing extraneous TESTSETUP. * Revising <snapshot> description. * Removing TEST. * Streamline delete API description. * Improve TESTSETUP for snippets.
2020-07-02 02:34:02 +08:00
include::get-repo-api.asciidoc[]
include::delete-repo-api.asciidoc[]
include::clean-up-repo-api.asciidoc[]
Move clone snapshot API page. (#63902)
2020-10-20 20:45:38 +08:00
include::clone-snapshot-api.asciidoc[]
[DOCS] Adding delete snapshot API docs. (#58865) * [DOCS] Adding delete snapshot API docs. * Adding TESTSETUP snippets and fixing original TEST. * Removing extraneous TESTSETUP. * Revising <snapshot> description. * Removing TEST. * Streamline delete API description. * Improve TESTSETUP for snippets.
2020-07-02 02:34:02 +08:00
include::create-snapshot-api.asciidoc[]
[DOCS] Adding get snapshot API docs (#59098) * Adding page for get snapshot API. * Adding values for state and cleaning up some other formatting. * Adding missing forward slash to GET request. * Updating values for start_time and end_time in TESTRESPONSE. * Swap "return" for "retrieve" * Swap "return" for "retrieve" 2 * Change .snapshot to .response * Adding response parameters and incorporating edits from review. * Update response example to include repository info * Change dash to underscore * Add data type for snapshot in response * Incorporating review comments and adding missing response definitions. * Minor rewording in description.
2020-07-08 23:28:24 +08:00
include::get-snapshot-api.asciidoc[]
[DOCS] Adding get snapshot status API docs (#59355) * Adding get snapshot status API docs. * Adding more fields and a link to the new page. * Adding missing spaces in TESTRESPONSES * Adding more parameters and making some edits. * Marking snapshot as optional * Marking repository as optional * Add data type for stats * Add data type for shard_stats * Incorporating review feedback. * Lots of review feedback incorporated. * Fixing tests to unbreak CI builds. * Changing indices to index.
2020-07-16 04:28:43 +08:00
include::get-snapshot-status-api.asciidoc[]
[DOCS] Adding new page for restore snapshot API (#59937) * Adding new page for restore snapshot API. * Improving test cases, lots of edits, and streamlining content. * Incorporating review suggestions and feedback. * Specify `index alias` vs `alias` * Change parameter order * Provide clarity around regular expression * Add link to SLM parameters * Split sentences in example * Adding link to master node page.
2020-07-22 23:42:17 +08:00
include::restore-snapshot-api.asciidoc[]
[DOCS] Adding delete snapshot API docs. (#58865) * [DOCS] Adding delete snapshot API docs. * Adding TESTSETUP snippets and fixing original TEST. * Removing extraneous TESTSETUP. * Revising <snapshot> description. * Removing TEST. * Streamline delete API description. * Improve TESTSETUP for snippets.
2020-07-02 02:34:02 +08:00
include::delete-snapshot-api.asciidoc[]
Change Get Snapshottable Features endpoint to `_features` (#69755) The endpoint `_snapshottable_features` is long and implies incorrect things about this API - it is used not just for snapshots, but also for the upcoming reset API. Following discussions on the team, this commit changes the endpoint to `_features` and removes the connection between this API and snapshots, as snapshots are not the only use for the output of this API.
2021-03-03 02:30:02 +08:00