5
5
<titleabbrev>Put watch</titleabbrev>
6
6
++++
7
7
8
- The PUT watch API either registers a new watch in {watcher} or update an
8
+ The PUT watch API either registers a new watch in {watcher} or updates an
9
9
existing one.
10
10
11
11
[float]
@@ -21,13 +21,13 @@ the `.watches` index and its trigger is immediately registered with the relevant
21
21
trigger engine. Typically for the `schedule` trigger, the scheduler is the
22
22
trigger engine.
23
23
24
- IMPORTANT: Putting a watch must be done via this API only . Do not put a watch
25
- directly to the `.watches` index using the Elasticsearch Index API.
26
- If {es} {security-features} are enabled, make sure no `write`
27
- privileges are granted to anyone over the `.watches` index.
24
+ IMPORTANT: You must use {kib} or this API to create a watch . Do not put a watch
25
+ directly to the `.watches` index using the Elasticsearch index API.
26
+ If {es} {security-features} are enabled, do not give users `write`
27
+ privileges on the `.watches` index.
28
28
29
29
When adding a watch you can also define its initial
30
- {xpack-ref }/how-watcher-works.html#watch-active-state[active state]. You do that
30
+ {stack-ov }/how-watcher-works.html#watch-active-state[active state]. You do that
31
31
by setting the `active` parameter.
32
32
33
33
[float]
@@ -52,16 +52,16 @@ A watch has the following fields:
52
52
|======
53
53
| Name | Description
54
54
55
- | `trigger` | The {xpack-ref }/trigger.html[trigger] that defines when
55
+ | `trigger` | The {stack-ov }/trigger.html[trigger] that defines when
56
56
the watch should run.
57
57
58
- | `input` | The {xpack-ref }/input.html[input] that defines the input
58
+ | `input` | The {stack-ov }/input.html[input] that defines the input
59
59
that loads the data for the watch.
60
60
61
- | `condition` | The {xpack-ref }/condition.html[condition] that defines if
61
+ | `condition` | The {stack-ov }/condition.html[condition] that defines if
62
62
the actions should be run.
63
63
64
- | `actions` | The list of {xpack-ref }/actions.html[actions] that will be
64
+ | `actions` | The list of {stack-ov }/actions.html[actions] that will be
65
65
run if the condition matches
66
66
67
67
| `metadata` | Metadata json that will be copied into the history entries.
@@ -75,7 +75,7 @@ A watch has the following fields:
75
75
==== Authorization
76
76
77
77
You must have `manage_watcher` cluster privileges to use this API. For more
78
- information, see {xpack-ref }/security-privileges.html[Security Privileges].
78
+ information, see {stack-ov }/security-privileges.html[Security Privileges].
79
79
80
80
[float]
81
81
==== Security Integration
@@ -148,7 +148,7 @@ PUT _watcher/watch/my-watch
148
148
// CONSOLE
149
149
150
150
When you add a watch you can also define its initial
151
- {xpack-ref }/how-watcher-works.html#watch-active-state[active state]. You do that
151
+ {stack-ov }/how-watcher-works.html#watch-active-state[active state]. You do that
152
152
by setting the `active` parameter. The following command adds a watch and sets
153
153
it to be inactive by default:
154
154
0 commit comments