elasticsearch/docs/reference/rest-api/watcher/update-settings.asciidoc
James Rodewig 255c9a7f95
[DOCS] Move x-pack docs to docs/reference dir (#99209)
**Problem:**
For historical reasons, source files for the Elasticsearch Guide's security, watcher, and Logstash API docs are housed in the `x-pack/docs` directory. This can confuse new contributors who expect Elasticsearch Guide docs to be located in `docs/reference`. 

**Solution:**
- Move the security, watcher, and Logstash API doc source files to the `docs/reference` directory
- Update doc snippet tests to use security

Rel: https://github.com/elastic/platform-docs-team/issues/208
2023-09-12 14:53:41 -04:00

48 lines
1.1 KiB
Text

[role="xpack"]
[[watcher-api-update-settings]]
=== Update Watcher index settings
++++
<titleabbrev>Update Watcher settings</titleabbrev>
++++
This API allows a user to modify the settings for the Watcher internal index (`.watches`). Only a subset of settings are allowed to by modified. This includes:
- `index.auto_expand_replicas`
- `index.number_of_replicas`
An example of modifying the Watcher settings:
[source,console]
----------------------------------------------------------------
PUT /_watcher/watch/test_watch
{
"trigger": {
"schedule": {
"hourly": {
"minute": [ 0, 5 ]
}
}
},
"input": {
"simple": {
"payload": {
"send": "yes"
}
}
},
"condition": {
"always": {}
}
}
----------------------------------------------------------------
// TESTSETUP
[source,console]
-----------------------------------------------------------
PUT /_watcher/settings
{
"index.auto_expand_replicas": "0-4"
}
-----------------------------------------------------------
The configurable settings can be retrieved using the <<watcher-api-get-settings,Get Watcher index settings>> API.