NAME
Search::Elasticsearch::Client::7_0::Direct::Watcher - Plugin providing Watcher API for Search::Elasticsearch 7.x
VERSION
version 8.12
SYNOPSIS
my $response = $es->watcher->start();
DESCRIPTION
This class extends the Search::Elasticsearch client with a watcher
namespace, to support the Watcher APIs.
METHODS
The full documentation for the Watcher feature is available here: https://www.elastic.co/guide/en/x-pack/current/xpack-alerting.html
put_watch()
$response = $es->watcher->put_watch(
id => $watch_id, # required
body => {...}
);
The put_watch()
method is used to register a new watcher or to update an existing watcher.
See the put_watch docs for more information.
Query string parameters: active
, error_trace
, human
, if_primary_term
, if_seq_no
, master_timeout
, version
get_watch()
$response = $es->watcher->get_watch(
id => $watch_id, # required
);
The get_watch()
method is used to retrieve a watch by ID.
See the get_watch docs for more information.
Query string parameters: error_trace
, human
delete_watch()
$response = $es->watcher->delete_watch(
id => $watch_id, # required
);
The delete_watch()
method is used to delete a watch by ID.
Query string parameters: error_trace
, force
, human
, master_timeout
See the delete_watch docs for more information.
execute_watch()
$response = $es->watcher->execute_watch(
id => $watch_id, # optional
body => {...} # optional
);
The execute_watch()
method forces the execution of a previously registered watch. Optional parameters may be passed in the body
.
Query string parameters: debug
, error_trace
, human
See the execute_watch docs for more information.
ack_watch()
$response = $es->watcher->ack_watch(
watch_id => $watch_id, # required
action_id => $action_id | \@action_ids # optional
);
The ack_watch()
method is used to manually throttle the execution of a watch.
Query string parameters: error_trace
, human
, master_timeout
See the ack_watch docs for more information.
activate_watch()
$response = $es->watcher->activate_watch(
watch_id => $watch_id, # required
);
The activate_watch()
method is used to activate a deactive watch.
Query string parameters: error_trace
, human
, master_timeout
See the activate_watch docs for more information.
deactivate_watch()
$response = $es->watcher->deactivate_watch(
watch_id => $watch_id, # required
);
The deactivate_watch()
method is used to deactivate an active watch.
Query string parameters: error_trace
, human
, master_timeout
See the deactivate_watch docs for more information.
stats()
$response = $es->watcher->stats(
metric => $metric # optional
);
The stats()
method returns information about the status of the watcher plugin.
See the stats docs for more information.
Query string parameters: error_trace
, human
stop()
$response = $es->watcher->stop();
The stop()
method stops the watcher service if it is running.
See the stop docs for more information.
Query string parameters: error_trace
, human
start()
$response = $es->watcher->start();
The start()
method starts the watcher service if it is not already running.
See the start docs for more information.
Query string parameters: error_trace
, human
restart()
$response = $es->watcher->restart();
The restart()
method stops then starts the watcher service.
See the restart docs for more information.
Query string parameters: error_trace
, human
AUTHOR
Enrico Zimuel <enrico.zimuel@elastic.co>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2024 by Elasticsearch BV.
This is free software, licensed under:
The Apache License, Version 2.0, January 2004