elasticsearch-api 8.19.2 → 9.0.0

data/lib/elasticsearch/api/actions/machine_learning/update_model_snapshot.rb

@@ -15,26 +15,27 @@
 # 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
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Update a snapshot
+        # Update a snapshot.
+        # Updates certain properties of a snapshot.
         #
-        # @option arguments [String] :job_id The ID of the job to fetch
-        # @option arguments [String] :snapshot_id The ID of the snapshot to update
+        # @option arguments [String] :job_id Identifier for the anomaly detection job. (*Required*)
+        # @option arguments [String] :snapshot_id Identifier for the model snapshot. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The model snapshot properties to update (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/ml-update-snapshot.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-update-model-snapshot
         #
         def update_model_snapshot(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.update_model_snapshot' }
 
-          defined_params = %i[job_id snapshot_id].each_with_object({}) do |variable, set_variables|
+          defined_params = [:job_id, :snapshot_id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
@@ -53,7 +54,7 @@ module Elasticsearch
           _snapshot_id = arguments.delete(:snapshot_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/model_snapshots/#{Utils.__listify(_snapshot_id)}/_update"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/model_snapshots/#{Utils.listify(_snapshot_id)}/_update"
           params = {}
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/update_trained_model_deployment.rb

@@ -15,21 +15,26 @@
 # 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
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Update a trained model deployment
+        # Update a trained model deployment.
         #
-        # @option arguments [String] :model_id The unique identifier of the trained model.
-        # @option arguments [Integer] :number_of_allocations Update the model deployment to this number of allocations.
+        # @option arguments [String] :model_id The unique identifier of the trained model. Currently, only PyTorch models are supported. (*Required*)
+        # @option arguments [Integer] :number_of_allocations The number of model allocations on each node where the model is deployed.
+        #  All allocations on a node share the same copy of the model in memory but use
+        #  a separate set of threads to evaluate the model.
+        #  Increasing this value generally increases the throughput.
+        #  If this setting is greater than the number of hardware threads
+        #  it will automatically be changed to a value less than the number of hardware threads. Server default: 1.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The updated trained model deployment settings
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-ml-update-trained-model-deployment
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-update-trained-model-deployment
         #
         def update_trained_model_deployment(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.update_trained_model_deployment' }
@@ -49,7 +54,7 @@ module Elasticsearch
           _model_id = arguments.delete(:model_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/trained_models/#{Utils.__listify(_model_id)}/deployment/_update"
+          path   = "_ml/trained_models/#{Utils.listify(_model_id)}/deployment/_update"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/upgrade_job_snapshot.rb

@@ -15,27 +15,37 @@
 # 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
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Upgrade a snapshot
+        # Upgrade a snapshot.
+        # Upgrade an anomaly detection model snapshot to the latest major version.
+        # Over time, older snapshot formats are deprecated and removed. Anomaly
+        # detection jobs support only snapshots that are from the current or previous
+        # major version.
+        # This API provides a means to upgrade a snapshot to the current major version.
+        # This aids in preparing the cluster for an upgrade to the next major version.
+        # Only one snapshot per anomaly detection job can be upgraded at a time and the
+        # upgraded snapshot cannot be the current snapshot of the anomaly detection
+        # job.
         #
-        # @option arguments [String] :job_id The ID of the job
-        # @option arguments [String] :snapshot_id The ID of the snapshot
-        # @option arguments [Time] :timeout How long should the API wait for the job to be opened and the old snapshot to be loaded.
-        # @option arguments [Boolean] :wait_for_completion Should the request wait until the task is complete before responding to the caller. Default is false.
+        # @option arguments [String] :job_id Identifier for the anomaly detection job. (*Required*)
+        # @option arguments [String] :snapshot_id A numerical character string that uniquely identifies the model snapshot. (*Required*)
+        # @option arguments [Boolean] :wait_for_completion When true, the API won’t respond until the upgrade is complete.
+        #  Otherwise, it responds as soon as the upgrade task is assigned to a node.
+        # @option arguments [Time] :timeout Controls the time to wait for the request to complete. Server default: 30m.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/ml-upgrade-job-model-snapshot.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-upgrade-job-snapshot
         #
         def upgrade_job_snapshot(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.upgrade_job_snapshot' }
 
-          defined_params = %i[job_id snapshot_id].each_with_object({}) do |variable, set_variables|
+          defined_params = [:job_id, :snapshot_id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
@@ -53,7 +63,7 @@ module Elasticsearch
           _snapshot_id = arguments.delete(:snapshot_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/model_snapshots/#{Utils.__listify(_snapshot_id)}/_upgrade"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/model_snapshots/#{Utils.listify(_snapshot_id)}/_upgrade"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,28 +15,44 @@
 # 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
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Actions
-      # Get multiple documents
+      # Get multiple documents.
+      # Get multiple JSON documents by ID from one or more indices.
+      # If you specify an index in the request URI, you only need to specify the document IDs in the request body.
+      # To ensure fast responses, this multi get (mget) API responds with partial results if one or more shards fail.
+      # **Filter source fields**
+      # By default, the +_source+ field is returned for every document (if stored).
+      # Use the +_source+ and +_source_include+ or +source_exclude+ attributes to filter what fields are returned for a particular document.
+      # You can include the +_source+, +_source_includes+, and +_source_excludes+ query parameters in the request URI to specify the defaults to use when there are no per-document instructions.
+      # **Get stored fields**
+      # Use the +stored_fields+ attribute to specify the set of stored fields you want to retrieve.
+      # Any requested fields that are not stored are ignored.
+      # You can include the +stored_fields+ query parameter in the request URI to specify the defaults to use when there are no per-document instructions.
       #
-      # @option arguments [String] :index The name of the index
-      # @option arguments [Boolean] :force_synthetic_source Should this request force synthetic _source? Use this to test if the mapping supports synthetic _source and to get a sense of the worst case performance. Fetches with this enabled will be slower the enabling synthetic source natively in the index.
-      # @option arguments [List] :stored_fields A comma-separated list of stored fields to return in the response
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on (default: random)
-      # @option arguments [Boolean] :realtime Specify whether to perform the operation in realtime or search mode
-      # @option arguments [Boolean] :refresh Refresh the shard containing the document before performing the operation
-      # @option arguments [String] :routing Specific routing value
-      # @option arguments [List] :_source True or false to return the _source field or not, or a list of fields to return
-      # @option arguments [List] :_source_excludes A list of fields to exclude from the returned _source field
-      # @option arguments [List] :_source_includes A list of fields to extract and return from the _source field
+      # @option arguments [String] :index Name of the index to retrieve documents from when +ids+ are specified, or when a document in the +docs+ array does not specify an index.
+      # @option arguments [Boolean] :force_synthetic_source Should this request force synthetic _source?
+      #  Use this to test if the mapping supports synthetic _source and to get a sense of the worst case performance.
+      #  Fetches with this enabled will be slower the enabling synthetic source natively in the index.
+      # @option arguments [String] :preference Specifies the node or shard the operation should be performed on. Random by default.
+      # @option arguments [Boolean] :realtime If +true+, the request is real-time as opposed to near-real-time. Server default: true.
+      # @option arguments [Boolean] :refresh If +true+, the request refreshes relevant shards before retrieving documents.
+      # @option arguments [String] :routing Custom value used to route operations to a specific shard.
+      # @option arguments [Boolean, String, Array<String>] :_source True or false to return the +_source+ field or not, or a list of fields to return.
+      # @option arguments [String, Array<String>] :_source_excludes A comma-separated list of source fields to exclude from the response.
+      #  You can also use this parameter to exclude fields from the subset specified in +_source_includes+ query parameter.
+      # @option arguments [String, Array<String>] :_source_includes A comma-separated list of source fields to include in the response.
+      #  If this parameter is specified, only these source fields are returned. You can exclude fields from this subset using the +_source_excludes+ query parameter.
+      #  If the +_source+ parameter is +false+, this parameter is ignored.
+      # @option arguments [String, Array<String>] :stored_fields If +true+, retrieves the document fields stored in the index rather than the document +_source+. Server default: false.
       # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body Document identifiers; can be either `docs` (containing full document information) or `ids` (when index is provided in the URL. (*Required*)
+      # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/docs-multi-get.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-mget
       #
       def mget(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'mget' }
@@ -51,13 +67,13 @@ module Elasticsearch
         arguments = arguments.clone
         headers = arguments.delete(:headers) || {}
 
-        body   = arguments.delete(:body)
+        body = arguments.delete(:body)
 
         _index = arguments.delete(:index)
 
         method = Elasticsearch::API::HTTP_POST
         path   = if _index
-                   "#{Utils.__listify(_index)}/_mget"
+                   "#{Utils.listify(_index)}/_mget"
                  else
                    '_mget'
                  end

data/lib/elasticsearch/api/actions/migration/deprecations.rb

@@ -15,19 +15,22 @@
 # 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
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Migration
       module Actions
-        # Get deprecation information
+        # Get deprecation information.
+        # Get information about different cluster, node, and index level settings that use deprecated features that will be removed or changed in the next major version.
+        # TIP: This APIs is designed for indirect use by the Upgrade Assistant.
+        # You are strongly recommended to use the Upgrade Assistant.
         #
-        # @option arguments [String] :index Index pattern
+        # @option arguments [String] :index Comma-separate list of data streams or indices to check. Wildcard (*) expressions are supported.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/migration-api-deprecation.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-migration-deprecations
         #
         def deprecations(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'migration.deprecations' }
@@ -40,13 +43,13 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           _index = arguments.delete(:index)
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _index
-                     "#{Utils.__listify(_index)}/_migration/deprecations"
+                     "#{Utils.listify(_index)}/_migration/deprecations"
                    else
                      '_migration/deprecations'
                    end

data/lib/elasticsearch/api/actions/migration/get_feature_upgrade_status.rb

@@ -15,18 +15,22 @@
 # 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
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Migration
       module Actions
-        # Get feature migration information
+        # Get feature migration information.
+        # Version upgrades sometimes require changes to how features store configuration information and data in system indices.
+        # Check which features need to be migrated and the status of any migrations that are in progress.
+        # TIP: This API is designed for indirect use by the Upgrade Assistant.
+        # You are strongly recommended to use the Upgrade Assistant.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/feature-migration-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-migration-get-feature-upgrade-status
         #
         def get_feature_upgrade_status(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'migration.get_feature_upgrade_status' }
@@ -34,7 +38,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_migration/system_features'

data/lib/elasticsearch/api/actions/migration/post_feature_upgrade.rb

@@ -15,18 +15,22 @@
 # 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
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Migration
       module Actions
-        # Start the feature migration
+        # Start the feature migration.
+        # Version upgrades sometimes require changes to how features store configuration information and data in system indices.
+        # This API starts the automatic migration process.
+        # Some functionality might be temporarily unavailable during the migration process.
+        # TIP: The API is designed for indirect use by the Upgrade Assistant. We strongly recommend you use the Upgrade Assistant.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/feature-migration-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-migration-get-feature-upgrade-status
         #
         def post_feature_upgrade(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'migration.post_feature_upgrade' }
@@ -34,7 +38,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_migration/system_features'

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

@@ -15,32 +15,50 @@
 # 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
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Actions
-      # Run multiple searches
+      # Run multiple searches.
+      # The format of the request is similar to the bulk API format and makes use of the newline delimited JSON (NDJSON) format.
+      # The structure is as follows:
+      # +
+      # header\n
+      # body\n
+      # header\n
+      # body\n
+      # +
+      # This structure is specifically optimized to reduce parsing if a specific search ends up redirected to another node.
+      # IMPORTANT: The final line of data must end with a newline character +\n+.
+      # Each newline character may be preceded by a carriage return +\r+.
+      # When sending requests to this endpoint the +Content-Type+ header should be set to +application/x-ndjson+.
       #
-      # @option arguments [List] :index A comma-separated list of index names to use as default
-      # @option arguments [String] :search_type Search operation type (options: query_then_fetch, dfs_query_then_fetch)
-      # @option arguments [Integer] :max_concurrent_searches Controls the maximum number of concurrent searches the multi search api will execute
-      # @option arguments [Boolean] :typed_keys Specify whether aggregation and suggester names should be prefixed by their respective types in the response
-      # @option arguments [Long] :pre_filter_shard_size A threshold that enforces a pre-filter roundtrip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter roundtrip can limit the number of shards significantly if for instance a shard can not match any documents based on its rewrite method ie. if date filters are mandatory to match but the shard bounds and the query are disjoint.
-      # @option arguments [Integer] :max_concurrent_shard_requests The number of concurrent shard requests each sub search executes concurrently per node. This value should be used to limit the impact of the search on the cluster in order to limit the number of concurrent shard requests
-      # @option arguments [Boolean] :rest_total_hits_as_int Indicates whether hits.total should be rendered as an integer or an object in the rest search response
-      # @option arguments [Boolean] :ccs_minimize_roundtrips Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution
-      # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when unavailable (missing or closed)
-      # @option arguments [Boolean] :ignore_throttled Whether specified concrete, expanded or aliased indices should be ignored when throttled *Deprecated*
-      # @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] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. (options: open, closed, hidden, none, all)
-      # @option arguments [List] :routing A comma-separated list of specific routing values
-      # @option arguments [Boolean] :include_named_queries_score Indicates whether hit.matched_queries should be rendered as a map that includes the name of the matched query associated with its score (true) or as an array containing the name of the matched queries (false)
+      # @option arguments [String, Array] :index Comma-separated list of data streams, indices, and index aliases to search.
+      # @option arguments [Boolean] :allow_no_indices If false, the request returns an error if any wildcard expression, index alias, or _all value targets only missing or closed indices. This behavior applies even if the request targets other open indices. For example, a request targeting foo*,bar* returns an error if an index starts with foo but no index starts with bar.
+      # @option arguments [Boolean] :ccs_minimize_roundtrips If true, network roundtrips between the coordinating node and remote clusters are minimized for cross-cluster search requests. Server default: true.
+      # @option arguments [String, Array<String>] :expand_wildcards Type of index that wildcard expressions can match. If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.
+      # @option arguments [Boolean] :ignore_throttled If true, concrete, expanded or aliased indices are ignored when frozen.
+      # @option arguments [Boolean] :ignore_unavailable If true, missing or closed indices are not included in the response.
+      # @option arguments [Boolean] :include_named_queries_score Indicates whether hit.matched_queries should be rendered as a map that includes
+      #  the name of the matched query associated with its score (true)
+      #  or as an array containing the name of the matched queries (false)
+      #  This functionality reruns each named query on every hit in a search response.
+      #  Typically, this adds a small overhead to a request.
+      #  However, using computationally expensive named queries on a large number of hits may add significant overhead.
+      # @option arguments [Integer] :max_concurrent_searches Maximum number of concurrent searches the multi search API can execute.
+      #  Defaults to +max(1, (# of data nodes * min(search thread pool size, 10)))+.
+      # @option arguments [Integer] :max_concurrent_shard_requests Maximum number of concurrent shard requests that each sub-search request executes per node. Server default: 5.
+      # @option arguments [Integer] :pre_filter_shard_size Defines a threshold that enforces a pre-filter roundtrip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter roundtrip can limit the number of shards significantly if for instance a shard can not match any documents based on its rewrite method i.e., if date filters are mandatory to match but the shard bounds and the query are disjoint.
+      # @option arguments [Boolean] :rest_total_hits_as_int If true, hits.total are returned as an integer in the response. Defaults to false, which returns an object.
+      # @option arguments [String] :routing Custom routing value used to route search operations to a specific shard.
+      # @option arguments [String] :search_type Indicates whether global term and document frequencies should be used when scoring returned documents.
+      # @option arguments [Boolean] :typed_keys Specifies whether aggregation and suggester names should be prefixed by their respective types in the response.
       # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body The request definitions (metadata-search request definition pairs), separated by newlines (*Required*)
+      # @option arguments [Hash] :body searches
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/search-multi-search.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-msearch
       #
       def msearch(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'msearch' }
@@ -55,19 +73,19 @@ module Elasticsearch
         arguments = arguments.clone
         headers = arguments.delete(:headers) || {}
 
-        body   = arguments.delete(:body)
+        body = arguments.delete(:body)
 
         _index = arguments.delete(:index)
 
         method = Elasticsearch::API::HTTP_POST
         path   = if _index
-                   "#{Utils.__listify(_index)}/_msearch"
+                   "#{Utils.listify(_index)}/_msearch"
                  else
                    '_msearch'
                  end
         params = Utils.process_params(arguments)
 
-        if body.is_a?(Array) && body.any? { |d| d.has_key? :search }
+        if body.is_a?(Array) && body.any? { |d| d.key? :search }
           payload = body.each_with_object([]) do |item, sum|
             meta = item
             data = meta.delete(:search)

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

@@ -15,24 +15,38 @@
 # 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
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Actions
-      # Run multiple templated searches
+      # Run multiple templated searches.
+      # Run multiple templated searches with a single request.
+      # If you are providing a text file or text input to +curl+, use the +--data-binary+ flag instead of +-d+ to preserve newlines.
+      # For example:
+      # +
+      # $ cat requests
+      # { "index": "my-index" }
+      # { "id": "my-search-template", "params": { "query_string": "hello world", "from": 0, "size": 10 }}
+      # { "index": "my-other-index" }
+      # { "id": "my-other-search-template", "params": { "query_type": "match_all" }}
+      # $ curl -H "Content-Type: application/x-ndjson" -XGET localhost:9200/_msearch/template --data-binary "@requests"; echo
+      # +
       #
-      # @option arguments [List] :index A comma-separated list of index names to use as default
-      # @option arguments [String] :search_type Search operation type (options: query_then_fetch, dfs_query_then_fetch)
-      # @option arguments [Boolean] :typed_keys Specify whether aggregation and suggester names should be prefixed by their respective types in the response
-      # @option arguments [Long] :max_concurrent_searches Controls the maximum number of concurrent searches the multi search api will execute
-      # @option arguments [Boolean] :rest_total_hits_as_int Indicates whether hits.total should be rendered as an integer or an object in the rest search response
-      # @option arguments [Boolean] :ccs_minimize_roundtrips Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution
+      # @option arguments [String, Array] :index A comma-separated list of data streams, indices, and aliases to search.
+      #  It supports wildcards (+*+).
+      #  To search all data streams and indices, omit this parameter or use +*+.
+      # @option arguments [Boolean] :ccs_minimize_roundtrips If +true+, network round-trips are minimized for cross-cluster search requests. Server default: true.
+      # @option arguments [Integer] :max_concurrent_searches The maximum number of concurrent searches the API can run.
+      # @option arguments [String] :search_type The type of the search operation.
+      # @option arguments [Boolean] :rest_total_hits_as_int If +true+, the response returns +hits.total+ as an integer.
+      #  If +false+, it returns +hits.total+ as an object.
+      # @option arguments [Boolean] :typed_keys If +true+, the response prefixes aggregation and suggester names with their respective types.
       # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body The request definitions (metadata-search request definition pairs), separated by newlines (*Required*)
+      # @option arguments [Hash] :body search_templates
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/multi-search-template.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-msearch-template
       #
       def msearch_template(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'msearch_template' }
@@ -47,13 +61,13 @@ module Elasticsearch
         arguments = arguments.clone
         headers = arguments.delete(:headers) || {}
 
-        body   = arguments.delete(:body)
+        body = arguments.delete(:body)
 
         _index = arguments.delete(:index)
 
         method = Elasticsearch::API::HTTP_POST
         path   = if _index
-                   "#{Utils.__listify(_index)}/_msearch/template"
+                   "#{Utils.listify(_index)}/_msearch/template"
                  else
                    '_msearch/template'
                  end