原文地址: https://www.elastic.co/guide/en/elasticsearch/reference/7.7/watcher-api-deactivate-watch.html, 原文档版权归 www.elastic.co 所有
IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Deactivate watch APIedit
A watch can be either active or inactive. This API enables you to deactivate a currently active watch.
Requestedit
PUT _watcher/watch/<watch_id>/_deactivate
Prerequisitesedit
-
You must have
manage_watchercluster privileges to use this API. For more information, see Security privileges.
Path parametersedit
-
<watch_id> - (Required, string) Identifier for the watch.
Examplesedit
The status of an active watch is returned with the watch definition when you call the get watch API:
GET _watcher/watch/my_watch
{
"found": true,
"_id": "my_watch",
"_version": 1,
"_seq_no": 0,
"_primary_term": 1,
"status": {
"state" : {
"active" : true,
"timestamp" : "2015-08-20T12:21:32.734Z"
},
"actions": ...,
"version": 1
},
"watch": ...
}
You can deactivate the watch by executing the following API call:
PUT _watcher/watch/my_watch/_deactivate
The new state of the watch is returned as part of its overall status:
{
"status": {
"state" : {
"active" : false,
"timestamp" : "2015-09-04T08:39:46.816Z"
},
"actions": ...,
"version": 1
}
}