elasticsearch-api 8.19.0 → 8.19.2

data/lib/elasticsearch/api/actions/termvectors.rb

@@ -21,7 +21,7 @@
 module Elasticsearch
   module API
     module Actions
-      # Returns information and statistics about terms in the fields of a particular document.
+      # Get term vector information
       #
       # @option arguments [String] :index The index in which the document resides.
       # @option arguments [String] :id The id of the document, when not specified a doc param should be supplied.
@@ -34,12 +34,12 @@ module Elasticsearch
       # @option arguments [String] :preference Specify the node or shard the operation should be performed on (default: random).
       # @option arguments [String] :routing Specific routing value.
       # @option arguments [Boolean] :realtime Specifies if request is real-time as opposed to near-real-time (default: true).
-      # @option arguments [Number] :version Explicit version number for concurrency control
+      # @option arguments [Long] :version Explicit version number for concurrency control
       # @option arguments [String] :version_type Specific version type (options: internal, external, external_gte)
       # @option arguments [Hash] :headers Custom HTTP headers
       # @option arguments [Hash] :body Define parameters and or supply a document to get termvectors for. See documentation.
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/docs-termvectors.html
+      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/docs-termvectors.html
       #
       def termvectors(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'termvectors' }

data/lib/elasticsearch/api/actions/text_structure/find_field_structure.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module TextStructure
       module Actions
-        # Finds the structure of a text field in an index.
+        # Find the structure of a text field
         #
         # @option arguments [String] :index The index containing the analyzed field (*Required*)
         # @option arguments [String] :field The field that should be analyzed (*Required*)
@@ -40,7 +40,7 @@ module Elasticsearch
         # @option arguments [Boolean] :explain Whether to include a commentary on how the structure was derived
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/find-field-structure.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/find-field-structure.html
         #
         def find_field_structure(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'text_structure.find_field_structure' }

data/lib/elasticsearch/api/actions/text_structure/find_message_structure.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module TextStructure
       module Actions
-        # Finds the structure of a list of messages. The messages must contain data that is suitable to be ingested into Elasticsearch.
+        # Find the structure of text messages
         #
         # @option arguments [Time] :timeout Timeout after which the analysis will be aborted
         # @option arguments [String] :format Optional parameter to specify the high level file format (options: ndjson, xml, delimited, semi_structured_text)
@@ -38,7 +38,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body JSON object with one field [messages], containing an array of messages to be analyzed (*Required*)
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/find-message-structure.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/find-message-structure.html
         #
         def find_message_structure(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'text_structure.find_message_structure' }

data/lib/elasticsearch/api/actions/text_structure/find_structure.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module TextStructure
       module Actions
-        # Finds the structure of a text file. The text file must contain data that is suitable to be ingested into Elasticsearch.
+        # Find the structure of a text file
         #
         # @option arguments [Integer] :lines_to_sample How many lines of the file should be included in the analysis
         # @option arguments [Integer] :line_merge_size_limit Maximum number of characters permitted in a single message when lines are merged to create messages.
@@ -42,7 +42,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The contents of the file to be analyzed (*Required*)
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/find-structure.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/find-structure.html
         #
         def find_structure(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'text_structure.find_structure' }

data/lib/elasticsearch/api/actions/text_structure/test_grok_pattern.rb

@@ -22,13 +22,13 @@ module Elasticsearch
   module API
     module TextStructure
       module Actions
-        # Tests a Grok pattern on some text.
+        # Test a Grok pattern
         #
         # @option arguments [String] :ecs_compatibility Optional parameter to specify the compatibility mode with ECS Grok patterns - may be either 'v1' or 'disabled'
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The Grok pattern and text. (*Required*)
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/test-grok-pattern.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/test-grok-pattern.html
         #
         def test_grok_pattern(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'text_structure.test_grok_pattern' }

data/lib/elasticsearch/api/actions/transform/delete_transform.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Deletes an existing transform.
+        # Delete a transform
         #
         # @option arguments [String] :transform_id The id of the transform to delete
         # @option arguments [Boolean] :force When `true`, the transform is deleted regardless of its current state. The default value is `false`, meaning that the transform must be `stopped` before it can be deleted.
@@ -30,7 +30,7 @@ module Elasticsearch
         # @option arguments [Time] :timeout Controls the time to wait for the transform deletion
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/delete-transform.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/delete-transform.html
         #
         def delete_transform(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.delete_transform' }

data/lib/elasticsearch/api/actions/transform/get_node_stats.rb

@@ -22,11 +22,11 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Retrieves transform usage information for transform nodes.
+        # Retrieves transform usage information for transform nodes
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/get-transform-node-stats.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/get-transform-node-stats.html
         #
         def get_node_stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.get_node_stats' }

data/lib/elasticsearch/api/actions/transform/get_transform.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Retrieves configuration information for transforms.
+        # Get transforms
         #
         # @option arguments [String] :transform_id The id or comma delimited list of id expressions of the transforms to get, '_all' or '*' implies get all transforms
         # @option arguments [Integer] :from skips a number of transform configs, defaults to 0
@@ -31,7 +31,7 @@ module Elasticsearch
         # @option arguments [Boolean] :exclude_generated Omits fields that are illegal to set on transform PUT
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/get-transform.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/get-transform.html
         #
         def get_transform(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.get_transform' }

data/lib/elasticsearch/api/actions/transform/get_transform_stats.rb

@@ -22,16 +22,16 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Retrieves usage information for transforms.
+        # Get transform stats
         #
         # @option arguments [String] :transform_id The id of the transform for which to get stats. '_all' or '*' implies all transforms
-        # @option arguments [Number] :from skips a number of transform stats, defaults to 0
-        # @option arguments [Number] :size specifies a max number of transform stats to get, defaults to 100
+        # @option arguments [Long] :from skips a number of transform stats, defaults to 0
+        # @option arguments [Long] :size specifies a max number of transform stats to get, defaults to 100
         # @option arguments [Time] :timeout Controls the time to wait for the stats
         # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no transforms. (This includes `_all` string or when no transforms have been specified)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/get-transform-stats.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/get-transform-stats.html
         #
         def get_transform_stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.get_transform_stats' }

data/lib/elasticsearch/api/actions/transform/preview_transform.rb

@@ -22,14 +22,14 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Previews a transform.
+        # Preview a transform
         #
         # @option arguments [String] :transform_id The id of the transform to preview.
         # @option arguments [Time] :timeout Controls the time to wait for the preview
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The definition for the transform to preview
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/preview-transform.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/preview-transform.html
         #
         def preview_transform(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.preview_transform' }

data/lib/elasticsearch/api/actions/transform/put_transform.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Instantiates a transform.
+        # Create a transform
         #
         # @option arguments [String] :transform_id The id of the new transform.
         # @option arguments [Boolean] :defer_validation If validations should be deferred until transform starts, defaults to false.
@@ -30,7 +30,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The transform definition (*Required*)
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/put-transform.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/put-transform.html
         #
         def put_transform(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.put_transform' }

data/lib/elasticsearch/api/actions/transform/reset_transform.rb

@@ -22,14 +22,14 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Resets an existing transform.
+        # Reset a transform
         #
         # @option arguments [String] :transform_id The id of the transform to reset
         # @option arguments [Boolean] :force When `true`, the transform is reset regardless of its current state. The default value is `false`, meaning that the transform must be `stopped` before it can be reset.
         # @option arguments [Time] :timeout Controls the time to wait for the transform to reset
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/reset-transform.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/reset-transform.html
         #
         def reset_transform(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.reset_transform' }

data/lib/elasticsearch/api/actions/transform/schedule_now_transform.rb

@@ -22,13 +22,13 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Schedules now a transform.
+        # Schedule a transform to start now
         #
         # @option arguments [String] :transform_id The id of the transform. (*Required*)
         # @option arguments [Time] :timeout Controls the time to wait for the scheduling to take place
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/schedule-now-transform.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/schedule-now-transform.html
         #
         def schedule_now_transform(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.schedule_now_transform' }

data/lib/elasticsearch/api/actions/transform/set_upgrade_mode.rb

@@ -0,0 +1,52 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
+# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
+#
+module Elasticsearch
+  module API
+    module Transform
+      module Actions
+        # Set upgrade_mode for transform indices
+        #
+        # @option arguments [Boolean] :enabled Whether to enable upgrade_mode Transform setting or not. Defaults to false.
+        # @option arguments [Time] :timeout Controls the time to wait before action times out. Defaults to 30 seconds
+        # @option arguments [Hash] :headers Custom HTTP headers
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-transform-set-upgrade-mode
+        #
+        def set_upgrade_mode(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'transform.set_upgrade_mode' }
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body   = nil
+
+          method = Elasticsearch::API::HTTP_POST
+          path   = '_transform/set_upgrade_mode'
+          params = Utils.process_params(arguments)
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers, request_opts)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/api/actions/transform/start_transform.rb

@@ -22,14 +22,14 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Starts one or more transforms.
+        # Start a transform
         #
         # @option arguments [String] :transform_id The id of the transform to start
         # @option arguments [String] :from Restricts the set of transformed entities to those changed after this time
         # @option arguments [Time] :timeout Controls the time to wait for the transform to start
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/start-transform.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/start-transform.html
         #
         def start_transform(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.start_transform' }

data/lib/elasticsearch/api/actions/transform/stop_transform.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Stops one or more transforms.
+        # Stop transforms
         #
         # @option arguments [String] :transform_id The id of the transform to stop
         # @option arguments [Boolean] :force Whether to force stop a failed transform or not. Default to false
@@ -32,7 +32,7 @@ module Elasticsearch
         # @option arguments [Boolean] :wait_for_checkpoint Whether to wait for the transform to reach a checkpoint before stopping. Default to false
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/stop-transform.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/stop-transform.html
         #
         def stop_transform(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.stop_transform' }

data/lib/elasticsearch/api/actions/transform/update_transform.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Updates certain properties of a transform.
+        # Update a transform
         #
         # @option arguments [String] :transform_id The id of the transform. (*Required*)
         # @option arguments [Boolean] :defer_validation If validations should be deferred until transform starts, defaults to false.
@@ -30,7 +30,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The update transform definition (*Required*)
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/update-transform.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-transform-update-transform
         #
         def update_transform(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.update_transform' }

data/lib/elasticsearch/api/actions/transform/upgrade_transforms.rb

@@ -22,13 +22,13 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Upgrades all transforms.
+        # Upgrade all transforms
         #
         # @option arguments [Boolean] :dry_run Whether to only check for updates but don't execute
         # @option arguments [Time] :timeout Controls the time to wait for the upgrade
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/upgrade-transforms.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-transform-upgrade-transforms
         #
         def upgrade_transforms(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.upgrade_transforms' }

data/lib/elasticsearch/api/actions/update.rb

@@ -21,7 +21,7 @@
 module Elasticsearch
   module API
     module Actions
-      # Updates a document with a script or partial document.
+      # Update a document
       #
       # @option arguments [String] :id Document ID
       # @option arguments [String] :index The name of the index
@@ -31,17 +31,17 @@ module Elasticsearch
       # @option arguments [List] :_source_includes A list of fields to extract and return from the _source field
       # @option arguments [String] :lang The script language (default: painless)
       # @option arguments [String] :refresh If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes. (options: true, false, wait_for)
-      # @option arguments [Number] :retry_on_conflict Specify how many times should the operation be retried when a conflict occurs (default: 0)
+      # @option arguments [Integer] :retry_on_conflict Specify how many times should the operation be retried when a conflict occurs (default: 0)
       # @option arguments [String] :routing Specific routing value
       # @option arguments [Time] :timeout Explicit operation timeout
-      # @option arguments [Number] :if_seq_no only perform the update operation if the last operation that has changed the document has the specified sequence number
-      # @option arguments [Number] :if_primary_term only perform the update operation if the last operation that has changed the document has the specified primary term
+      # @option arguments [Long] :if_seq_no only perform the update operation if the last operation that has changed the document has the specified sequence number
+      # @option arguments [Long] :if_primary_term only perform the update operation if the last operation that has changed the document has the specified primary term
       # @option arguments [Boolean] :require_alias When true, requires destination is an alias. Default is false
       # @option arguments [Boolean] :include_source_on_error True or false if to include the document source in the error message in case of parsing errors. Defaults to true.
       # @option arguments [Hash] :headers Custom HTTP headers
       # @option arguments [Hash] :body The request definition requires either `script` or partial `doc` (*Required*)
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/docs-update.html
+      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/docs-update.html
       #
       def update(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'update' }

data/lib/elasticsearch/api/actions/update_by_query.rb

@@ -21,15 +21,14 @@
 module Elasticsearch
   module API
     module Actions
-      # Performs an update on every document in the index without changing the source,
-      # for example to pick up a mapping change.
+      # Update documents
       #
       # @option arguments [List] :index A comma-separated list of index names to search; use `_all` or empty string to perform the operation on all indices
       # @option arguments [String] :analyzer The analyzer to use for the query string
       # @option arguments [Boolean] :analyze_wildcard Specify whether wildcard and prefix queries should be analyzed (default: false)
       # @option arguments [String] :default_operator The default operator for query string query (AND or OR) (options: AND, OR)
       # @option arguments [String] :df The field to use as default where no field prefix is given in the query string
-      # @option arguments [Number] :from Starting offset (default: 0)
+      # @option arguments [Long] :from Starting offset (default: 0)
       # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when unavailable (missing or closed)
       # @option arguments [Boolean] :allow_no_indices Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)
       # @option arguments [String] :conflicts What to do when the update by query hits version conflicts? (options: abort, proceed)
@@ -42,9 +41,9 @@ module Elasticsearch
       # @option arguments [Time] :scroll Specify how long a consistent view of the index should be maintained for scrolled search
       # @option arguments [String] :search_type Search operation type (options: query_then_fetch, dfs_query_then_fetch)
       # @option arguments [Time] :search_timeout Explicit timeout for each search request. Defaults to no timeout.
-      # @option arguments [Number] :max_docs Maximum number of documents to process (default: all documents)
+      # @option arguments [Long] :max_docs Maximum number of documents to process (default: all documents)
       # @option arguments [List] :sort A comma-separated list of <field>:<direction> pairs
-      # @option arguments [Number] :terminate_after The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.
+      # @option arguments [Long] :terminate_after The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.
       # @option arguments [List] :stats Specific 'tag' of the request for logging and statistical purposes
       # @option arguments [Boolean] :version Specify whether to return document version as part of a hit
       # @option arguments [Boolean] :version_type Should the document increment the version number (internal) on hit or not (reindex)
@@ -52,14 +51,14 @@ module Elasticsearch
       # @option arguments [Boolean] :refresh Should the affected indexes be refreshed?
       # @option arguments [Time] :timeout Time each individual bulk request should wait for shards that are unavailable.
       # @option arguments [String] :wait_for_active_shards Sets the number of shard copies that must be active before proceeding with the update by query operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)
-      # @option arguments [Number] :scroll_size Size on the scroll request powering the update by query
+      # @option arguments [Long] :scroll_size Size on the scroll request powering the update by query
       # @option arguments [Boolean] :wait_for_completion Should the request should block until the update by query operation is complete.
       # @option arguments [Number] :requests_per_second The throttle to set on this request in sub-requests per second. -1 means no throttle.
       # @option arguments [Number|string] :slices The number of slices this task should be divided into. Defaults to 1, meaning the task isn't sliced into subtasks. Can be set to `auto`.
       # @option arguments [Hash] :headers Custom HTTP headers
       # @option arguments [Hash] :body The search definition using the Query DSL
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/docs-update-by-query.html
+      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/docs-update-by-query.html
       #
       def update_by_query(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'update_by_query' }

data/lib/elasticsearch/api/actions/update_by_query_rethrottle.rb

@@ -21,13 +21,13 @@
 module Elasticsearch
   module API
     module Actions
-      # Changes the number of requests per second for a particular Update By Query operation.
+      # Throttle an update by query operation
       #
       # @option arguments [String] :task_id The task id to rethrottle
       # @option arguments [Number] :requests_per_second The throttle to set on this request in floating sub-requests per second. -1 means set no throttle. (*Required*)
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/docs-update-by-query.html
+      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/docs-update-by-query.html#docs-update-by-query-rethrottle
       #
       def update_by_query_rethrottle(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'update_by_query_rethrottle' }

data/lib/elasticsearch/api/actions/watcher/ack_watch.rb

@@ -22,13 +22,13 @@ module Elasticsearch
   module API
     module Watcher
       module Actions
-        # Acknowledges a watch, manually throttling the execution of the watch's actions.
+        # Acknowledge a watch
         #
         # @option arguments [String] :watch_id Watch ID
         # @option arguments [List] :action_id A comma-separated list of the action ids to be acked
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/watcher-api-ack-watch.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-watcher-ack-watch
         #
         def ack_watch(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'watcher.ack_watch' }

data/lib/elasticsearch/api/actions/watcher/activate_watch.rb

@@ -22,12 +22,12 @@ module Elasticsearch
   module API
     module Watcher
       module Actions
-        # Activates a currently inactive watch.
+        # Activate a watch
         #
         # @option arguments [String] :watch_id Watch ID
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/watcher-api-activate-watch.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-watcher-activate-watch
         #
         def activate_watch(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'watcher.activate_watch' }

data/lib/elasticsearch/api/actions/watcher/deactivate_watch.rb

@@ -22,12 +22,12 @@ module Elasticsearch
   module API
     module Watcher
       module Actions
-        # Deactivates a currently active watch.
+        # Deactivate a watch
         #
         # @option arguments [String] :watch_id Watch ID
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/watcher-api-deactivate-watch.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-watcher-deactivate-watch
         #
         def deactivate_watch(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'watcher.deactivate_watch' }

data/lib/elasticsearch/api/actions/watcher/delete_watch.rb

@@ -22,12 +22,12 @@ module Elasticsearch
   module API
     module Watcher
       module Actions
-        # Removes a watch from Watcher.
+        # Delete a watch
         #
         # @option arguments [String] :id Watch ID
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/watcher-api-delete-watch.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-watcher-delete-watch
         #
         def delete_watch(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'watcher.delete_watch' }

data/lib/elasticsearch/api/actions/watcher/execute_watch.rb

@@ -22,14 +22,14 @@ module Elasticsearch
   module API
     module Watcher
       module Actions
-        # Forces the execution of a stored watch.
+        # Run a watch
         #
         # @option arguments [String] :id Watch ID
         # @option arguments [Boolean] :debug indicates whether the watch should execute in debug mode
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body Execution control
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/watcher-api-execute-watch.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-watcher-execute-watch
         #
         def execute_watch(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'watcher.execute_watch' }

data/lib/elasticsearch/api/actions/watcher/get_settings.rb

@@ -22,12 +22,12 @@ module Elasticsearch
   module API
     module Watcher
       module Actions
-        # Retrieve settings for the watcher system index
+        # Get Watcher index settings
         #
         # @option arguments [Time] :master_timeout Specify timeout for connection to master
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/watcher-api-get-settings.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-watcher-get-settings
         #
         def get_settings(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'watcher.get_settings' }

data/lib/elasticsearch/api/actions/watcher/get_watch.rb

@@ -22,12 +22,12 @@ module Elasticsearch
   module API
     module Watcher
       module Actions
-        # Retrieves a watch by its ID.
+        # Get a watch
         #
         # @option arguments [String] :id Watch ID
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/watcher-api-get-watch.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-watcher-get-watch
         #
         def get_watch(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'watcher.get_watch' }

data/lib/elasticsearch/api/actions/watcher/put_watch.rb

@@ -22,17 +22,17 @@ module Elasticsearch
   module API
     module Watcher
       module Actions
-        # Creates a new watch, or updates an existing one.
+        # Create or update a watch
         #
         # @option arguments [String] :id Watch ID
         # @option arguments [Boolean] :active Specify whether the watch is in/active by default
-        # @option arguments [Number] :version Explicit version number for concurrency control
-        # @option arguments [Number] :if_seq_no only update the watch if the last operation that has changed the watch has the specified sequence number
-        # @option arguments [Number] :if_primary_term only update the watch if the last operation that has changed the watch has the specified primary term
+        # @option arguments [Long] :version Explicit version number for concurrency control
+        # @option arguments [Long] :if_seq_no only update the watch if the last operation that has changed the watch has the specified sequence number
+        # @option arguments [Long] :if_primary_term only update the watch if the last operation that has changed the watch has the specified primary term
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The watch
+        # @option arguments [Hash] :body The watch (*Required*)
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/watcher-api-put-watch.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-watcher-put-watch
         #
         def put_watch(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'watcher.put_watch' }
@@ -42,6 +42,7 @@ module Elasticsearch
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
+          raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
           raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
 
           arguments = arguments.clone