Add support for new timezone field in watch schedules

[lukewhiting]

This change adds timezone support to Watcher schedules added in elastic/elasticsearch#117033

[github-actions]

Following you can find the validation results for the APIs you have changed.

API	Status	Request	Response
watcher.ack_watch	🟢	1/1	1/1
watcher.activate_watch	🟢	1/1	1/1
watcher.deactivate_watch	🟢	1/1	1/1
watcher.delete_watch	🟢	2/2	2/2
watcher.execute_watch	🟢	7/7	7/7
watcher.get_settings	🟠	Missing type	Missing type
watcher.get_watch	🟢	9/9	9/9
watcher.put_watch	🔴	29/38	38/38
watcher.query_watches	⚪	Missing test	Missing test
watcher.start	🟢	1/1	1/1
watcher.stats	🟢	1/1	1/1
watcher.stop	🟢	1/1	1/1
watcher.update_settings	🟠	Missing type	Missing type

You can validate these APIs yourself by using the make validate target.

[github-actions]

Following you can find the validation results for the APIs you have changed.

API	Status	Request	Response
watcher.ack_watch	🟢	1/1	1/1
watcher.activate_watch	🟢	1/1	1/1
watcher.deactivate_watch	🟢	1/1	1/1
watcher.delete_watch	🟢	2/2	2/2
watcher.execute_watch	🟢	7/7	7/7
watcher.get_settings	🟠	Missing type	Missing type
watcher.get_watch	🟢	9/9	9/9
watcher.put_watch	🔴	29/38	38/38
watcher.query_watches	⚪	Missing test	Missing test
watcher.start	🟢	1/1	1/1
watcher.stats	🟢	1/1	1/1
watcher.stop	🟢	1/1	1/1
watcher.update_settings	🟠	Missing type	Missing type

You can validate these APIs yourself by using the make validate target.

[lukewhiting]

I'm trying to run the validation locally (Ubuntu 24.04) to get more info about the fails on the watcher.put_watch endpoint however I get this when running make validate api=watcher.put_watch type=request branch=main:

✖ 
    at run (/home/lukewhiting/code/elasticsearch-specification/compiler/run-validations.js:114:12)
    exit code: 1
make: *** [Makefile:4: validate] Error 1

[pquentin]

Thank you! The failures are unrelated (#3188 fixes most of them), and I'll reach out to you offline to fix make validate.

This change isn't tested because we don't currently use the watcher plugin from the Elasticsearch YAML tests, but I'd love to do it at some point.

[github-actions]

The backport to 8.x failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-8.x 8.x
# Navigate to the new working tree
cd .worktrees/backport-8.x
# Create a new branch
git switch --create backport-3181-to-8.x
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 b8e3cf63b0432eed31014a2900eac5d791962edc
# Push it to GitHub
git push --set-upstream origin backport-3181-to-8.x
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-8.x

Then, create a pull request where the base branch is 8.x and the compare/head branch is backport-3181-to-8.x.

[pquentin]

💚 All backports created successfully

Status	Branch	Result
✅	8.x

Questions ?

Please refer to the Backport tool documentation

[pquentin]

💚 All backports created successfully

Status	Branch	Result
✅	8.x

Questions ?

Please refer to the Backport tool documentation