激活 watch API
一个 watch 可以处于活动或非活动状态。此 API 使你能够激活当前处于非活动状态的 watch。
PUT _watcher/watch/<watch_id>/_activate
前置条件
- 你必须具有
manage_watcher集群权限才能使用此 API。
路径参数
<watch_id>
(必需,字符串)watch 的标识符。
示例
以下示例展示激活一个 watch 的步骤:
- 通过获取 watch API 检查 watch 的状态(非活动 watch 的状态会随 watch 定义一起返回):
GET _watcher/watch/my_watch
响应显示该 watch 处于非活动状态(active 为 false):
{
"found": true,
"_id": "my_watch",
"_seq_no": 0,
"_primary_term": 1,
"_version": 1,
"status": {
"state": {
"active": false,
"timestamp": "2015-08-20T12:21:32.734Z"
},
"actions": "...",
"version": 1
},
"watch": "..."
}
- 激活该 watch:
PUT _watcher/watch/my_watch/_activate
响应将 watch 的新状态作为其整体状态的一部分返回(active 为 true):
{
"status": {
"state": {
"active": true,
"timestamp": "2015-09-04T08:39:46.816Z"
},
"actions": "...",
"version": 1
}
}