stack es watcher put-watch cli command

elastic stack es watcher put-watch --id <id> [options]

Create or update a watch.

Behaviour flags:

--dry-run — validate all inputs and exit without performing any action

--id string required

The identifier for the watch.

--active

The initial state of the watch. The default value is true, which means the watch is active by default.

--if-primary-term number

Only update the watch if the last operation that has changed the watch has the specified primary term

--if-seq-no number

Only update the watch if the last operation that has changed the watch has the specified sequence number

--version number

Explicit version number for concurrency control

--actions string

The list of actions that will be run if the condition matches.

--condition string

The condition that defines if the actions should be run.

--input string

The input that defines the input that loads the data for the watch.

--metadata string

Metadata JSON that will be copied into the history entries.

--throttle-period string

The minimum time between actions being run. The default is 5 seconds. This default can be changed in the config file with the setting xpack.watcher.throttle.period.default_period. If both this value and the throttle_period_in_millis parameter are specified, Watcher uses the last parameter included in the request.

--throttle-period-in-millis string

Minimum time in milliseconds between actions being run. Defaults to 5000. If both this value and the throttle_period parameter are specified, Watcher uses the last parameter included in the request.

--transform string

The transform that processes the watch payload to prepare it for the watch actions.

--trigger string

The trigger that defines when the watch should run.

--error-trace

When set to true Elasticsearch will include the full stack trace of errors when they occur.

--filter-path string

Comma-separated list of filters in dot notation which reduce the response returned by Elasticsearch.

Repeatable: pass --filter-path multiple times to supply more than one value

--human

When set to true will return statistics in a format suitable for humans. For example "exists_time": "1h" for humans and "exists_time_in_millis": 3600000 for computers. When disabled the human readable values will be omitted. This makes sense for responses being consumed only by machines.

--pretty

If set to true the returned JSON will be "pretty-formatted". Only use this option for debugging only.

--input-file string

path to a JSON file to use as command input

--dry-run

validate all inputs and exit without performing any action (preview changes without applying them)

--no-validate

skip input validation and send the request as-is

--output-fields string

comma-separated list of fields to include in output (dot-notation supported)

--output-template string

Mustache-like template for custom text output (e.g. "{{id}}: {{name}}")

--json

output as JSON