ウォッチの有効化（Activate watch）

ウォッチAPIの有効化

ウォッチはアクティブまたは非アクティブのいずれかです。このAPIを使用すると、現在非アクティブなウォッチを有効化できます。

リクエスト

PUT _watcher/watch/<watch_id>/_activate

前提条件

• このAPIを使用するには、manage_watcherクラスターの権限が必要です。詳細については、セキュリティ権限を参照してください。

パスパラメータ

• <watch_id>
• （必須、文字列）ウォッチの識別子。

例

非アクティブなウォッチの状態は、ウォッチ取得APIを呼び出すと、ウォッチ定義と共に返されます：

Python

resp = client.watcher.get_watch(
   id="my_watch",
)
print(resp)

Js

const response = await client.watcher.getWatch({
  id: "my_watch",
});
console.log(response);

コンソール

GET _watcher/watch/my_watch

コンソール-結果

{
  "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": ...
}

次のAPI呼び出しを実行することで、ウォッチを有効化できます：

Python

resp = client.watcher.activate_watch(
   watch_id="my_watch",
)
print(resp)

Js

const response = await client.watcher.activateWatch({
  watch_id: "my_watch",
});
console.log(response);

コンソール

PUT _watcher/watch/my_watch/_activate

ウォッチの新しい状態は、その全体の状態の一部として返されます：

コンソール-結果

{
  "status": {
   "state" : {
   "active" : true,
   "timestamp" : "2015-09-04T08:39:46.816Z"
   },
   "actions": ...,
   "version": 1
  }
}