elasticsearch-api 9.1.1 → 9.2.0

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

@@ -38,6 +38,14 @@ module Elasticsearch
       # @option arguments [String] :preference The node or shard the operation should be performed on.
       #  It is random by default.
       # @option arguments [Boolean] :profile If `true`, the query execution is profiled.
+      # @option arguments [String] :project_routing Specifies a subset of projects to target for the search using project
+      #  metadata tags in a subset of Lucene query syntax.
+      #  Allowed Lucene queries: the _alias tag and a single value (possibly wildcarded).
+      #  Examples:
+      #   _alias:my-project
+      #   _alias:_origin
+      #   _alias:*pr*
+      #  Supported in serverless only.
       # @option arguments [String] :routing A custom value used to route operations to a specific shard.
       # @option arguments [Time] :scroll Specifies how long a consistent view of the index
       #  should be maintained for scrolled search.

data/lib/elasticsearch/api/actions/searchable_snapshots/stats.rb

@@ -25,7 +25,7 @@ module Elasticsearch
         # Get searchable snapshot statistics.
         #
         # @option arguments [String, Array] :index A comma-separated list of data streams and indices to retrieve statistics for.
-        # @option arguments [String] :level Return stats aggregated at cluster, index or shard level
+        # @option arguments [String] :level Return stats aggregated at cluster, index or shard level Server default: indices.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.
         # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

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

@@ -30,7 +30,7 @@ module Elasticsearch
         # * `index.number_of_replicas`
         #
         # @option arguments [Time] :master_timeout Period to wait for a connection to the master node.
-        #  If no response is received before the timeout expires, the request fails and returns an error.
+        #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.
         # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

data/lib/elasticsearch/api/actions/security/get_stats.rb

@@ -0,0 +1,62 @@
+# 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.
+#
+# 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 Security
+      module Actions
+        # Get security stats.
+        # Gather security usage statistics from all node(s) within the cluster.
+        #
+        # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
+        #  when they occur.
+        # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response
+        #  returned by Elasticsearch.
+        # @option arguments [Boolean] :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.
+        # @option arguments [Boolean] :pretty If set to `true` the returned JSON will be "pretty-formatted". Only use
+        #  this option for debugging only.
+        # @option arguments [Hash] :headers Custom HTTP headers
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-get-stats
+        #
+        def get_stats(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'security.get_stats' }
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = nil
+
+          method = Elasticsearch::API::HTTP_GET
+          path   = '_security/stats'
+          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/security/update_settings.rb

@@ -29,7 +29,7 @@ module Elasticsearch
         # This API does not yet support configuring the settings for indices before they are in use.
         #
         # @option arguments [Time] :master_timeout The period to wait for a connection to the master node.
-        #  If no response is received before the timeout expires, the request fails and returns an error.
+        #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
         # @option arguments [Time] :timeout The period to wait for a response.
         #  If no response is received before the timeout expires, the request fails and returns an error.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors

data/lib/elasticsearch/api/actions/simulate/ingest.rb

@@ -45,6 +45,10 @@ module Elasticsearch
         #  If you specify this parameter in the request path, it is used for any documents that do not explicitly specify an index argument.
         # @option arguments [String] :pipeline The pipeline to use as the default pipeline.
         #  This value can be used to override the default pipeline of the index.
+        # @option arguments [String] :merge_type The mapping merge type if mapping overrides are being provided in mapping_addition.
+        #  The allowed values are one of index or template.
+        #  The index option merges mappings the way they would be merged into an existing index.
+        #  The template option merges mappings the way they would be merged into a template. Server default: index.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.
         # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

data/lib/elasticsearch/api/actions/snapshot/get_repository.rb

@@ -30,7 +30,7 @@ module Elasticsearch
         #  If `false`, the request gets information from the master node.
         # @option arguments [Time] :master_timeout The period to wait for the master node.
         #  If the master node is not available before the timeout expires, the request fails and returns an error.
-        #  To indicate that the request should never timeout, set it to `-1`. Server default: to 30s.
+        #  To indicate that the request should never timeout, set it to `-1`. Server default: 30s.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.
         # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

data/lib/elasticsearch/api/actions/snapshot/repository_analyze.rb

@@ -108,26 +108,33 @@ module Elasticsearch
         #
         # @option arguments [String] :repository The name of the repository. (*Required*)
         # @option arguments [Integer] :blob_count The total number of blobs to write to the repository during the test.
-        #  For realistic experiments, you should set it to at least `2000`. Server default: 100.
-        # @option arguments [Integer] :concurrency The number of operations to run concurrently during the test. Server default: 10.
+        #  For realistic experiments, set this parameter to at least `2000`. Server default: 100.
+        # @option arguments [Integer] :concurrency The number of operations to run concurrently during the test.
+        #  For realistic experiments, leave this parameter unset. Server default: 10.
         # @option arguments [Boolean] :detailed Indicates whether to return detailed results, including timing information for every operation performed during the analysis.
         #  If false, it returns only a summary of the analysis.
         # @option arguments [Integer] :early_read_node_count The number of nodes on which to perform an early read operation while writing each blob.
-        #  Early read operations are only rarely performed. Server default: 2.
+        #  Early read operations are only rarely performed.
+        #  For realistic experiments, leave this parameter unset. Server default: 2.
         # @option arguments [Integer, String] :max_blob_size The maximum size of a blob to be written during the test.
-        #  For realistic experiments, you should set it to at least `2gb`. Server default: 10mb.
+        #  For realistic experiments, set this parameter to at least `2gb`. Server default: 10mb.
         # @option arguments [Integer, String] :max_total_data_size An upper limit on the total size of all the blobs written during the test.
-        #  For realistic experiments, you should set it to at least `1tb`. Server default: 1gb.
-        # @option arguments [Float] :rare_action_probability The probability of performing a rare action such as an early read, an overwrite, or an aborted write on each blob. Server default: 0.02.
-        # @option arguments [Boolean] :rarely_abort_writes Indicates whether to rarely cancel writes before they complete. Server default: true.
-        # @option arguments [Integer] :read_node_count The number of nodes on which to read a blob after writing. Server default: 10.
+        #  For realistic experiments, set this parameter to at least `1tb`. Server default: 1gb.
+        # @option arguments [Float] :rare_action_probability The probability of performing a rare action such as an early read, an overwrite, or an aborted write on each blob.
+        #  For realistic experiments, leave this parameter unset. Server default: 0.02.
+        # @option arguments [Boolean] :rarely_abort_writes Indicates whether to rarely cancel writes before they complete.
+        #  For realistic experiments, leave this parameter unset. Server default: true.
+        # @option arguments [Integer] :read_node_count The number of nodes on which to read a blob after writing.
+        #  For realistic experiments, leave this parameter unset. Server default: 10.
         # @option arguments [Integer] :register_operation_count The minimum number of linearizable register operations to perform in total.
-        #  For realistic experiments, you should set it to at least `100`. Server default: 10.
+        #  For realistic experiments, set this parameter to at least `100`. Server default: 10.
         # @option arguments [Integer] :seed The seed for the pseudo-random number generator used to generate the list of operations performed during the test.
         #  To repeat the same set of operations in multiple experiments, use the same seed in each experiment.
         #  Note that the operations are performed concurrently so might not always happen in the same order on each run.
+        #  For realistic experiments, leave this parameter unset.
         # @option arguments [Time] :timeout The period of time to wait for the test to complete.
-        #  If no response is received before the timeout expires, the test is cancelled and returns an error. Server default: 30s.
+        #  If no response is received before the timeout expires, the test is cancelled and returns an error.
+        #  For realistic experiments, set this parameter sufficiently long to allow the test to complete. Server default: 30s.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.
         # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

data/lib/elasticsearch/api/actions/snapshot/status.rb

@@ -29,6 +29,11 @@ module Elasticsearch
         # If you omit the `<snapshot>` request path parameter, the request retrieves information only for currently running snapshots.
         # This usage is preferred.
         # If needed, you can specify `<repository>` and `<snapshot>` to retrieve information for specific snapshots, even if they're not currently running.
+        # Note that the stats will not be available for any shard snapshots in an ongoing snapshot completed by a node that (even momentarily) left the cluster.
+        # Loading the stats from the repository is an expensive operation (see the WARNING below).
+        # Therefore the stats values for such shards will be -1 even though the "stage" value will be "DONE", in order to minimize latency.
+        # A "description" field will be present for a shard snapshot completed by a departed node explaining why the shard snapshot's stats results are invalid.
+        # Consequently, the total stats for the index will be less than expected due to the missing values from these shards.
         # WARNING: Using the API to return the status of any snapshots other than currently running snapshots can be expensive.
         # The API requires a read from the repository for each shard in each snapshot.
         # For example, if you have 100 snapshots with 1,000 shards each, an API request that includes all snapshots will require 100,000 reads (100 snapshots x 1,000 shards).

data/lib/elasticsearch/api/actions/snapshot_lifecycle_management/put_lifecycle.rb

@@ -58,6 +58,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 'policy_id' missing" unless arguments[:policy_id]
 
           arguments = arguments.clone

data/lib/elasticsearch/api/actions/sql/get_async.rb

@@ -33,7 +33,7 @@ module Elasticsearch
         #  You must specify a format using this parameter or the `Accept` HTTP header.
         #  If you specify both, the API uses this parameter.
         # @option arguments [Time] :keep_alive The retention period for the search and its results.
-        #  It defaults to the `keep_alive` period for the original SQL search.
+        #  It defaults to the `keep_alive` period for the original SQL search. Server default: 5d.
         # @option arguments [Time] :wait_for_completion_timeout The period to wait for complete results.
         #  It defaults to no timeout, meaning the request waits for complete search results.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors

data/lib/elasticsearch/api/actions/sql/query.rb

@@ -28,6 +28,14 @@ module Elasticsearch
         # @option arguments [String] :format The format for the response.
         #  You can also specify a format using the `Accept` HTTP header.
         #  If you specify both this parameter and the `Accept` HTTP header, this parameter takes precedence.
+        # @option arguments [String] :project_routing Specifies a subset of projects to target for the search using project
+        #  metadata tags in a subset of Lucene query syntax.
+        #  Allowed Lucene queries: the _alias tag and a single value (possibly wildcarded).
+        #  Examples:
+        #   _alias:my-project
+        #   _alias:_origin
+        #   _alias:*pr*
+        #  Supported in serverless only.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.
         # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

data/lib/elasticsearch/api/actions/streams/logs_disable.rb

@@ -22,11 +22,31 @@ module Elasticsearch
   module API
     module Streams
       module Actions
-        # Disable the Logs Streams feature for this cluster
+        # Disable logs stream.
+        # Turn off the logs stream feature for this cluster.
+        # This functionality is Experimental and may be changed or removed
+        # completely in a future release. Elastic will take a best effort approach
+        # to fix any issues, but experimental features are not subject to the
+        # support SLA of official GA features.
         #
+        # @option arguments [Time] :master_timeout The period to wait for a connection to the master node.
+        #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
+        # @option arguments [Time] :timeout The period to wait for a response.
+        #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
+        # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
+        #  when they occur.
+        # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response
+        #  returned by Elasticsearch.
+        # @option arguments [Boolean] :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.
+        # @option arguments [Boolean] :pretty If set to `true` the returned JSON will be "pretty-formatted". Only use
+        #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/streams-logs-disable.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch#TODO
         #
         def logs_disable(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'streams.logs_disable' }
@@ -38,7 +58,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_streams/logs/_disable'
-          params = {}
+          params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(
             perform_request(method, path, params, body, headers, request_opts)

data/lib/elasticsearch/api/actions/streams/logs_enable.rb

@@ -22,11 +22,34 @@ module Elasticsearch
   module API
     module Streams
       module Actions
-        # Enable the Logs Streams feature for this cluster
+        # Enable logs stream.
+        # Turn on the logs stream feature for this cluster.
+        # NOTE: To protect existing data, this feature can be turned on only if the
+        # cluster does not have existing indices or data streams that match the pattern `logs|logs.*`.
+        # If those indices or data streams exist, a `409 - Conflict` response and error is returned.
+        # This functionality is Experimental and may be changed or removed
+        # completely in a future release. Elastic will take a best effort approach
+        # to fix any issues, but experimental features are not subject to the
+        # support SLA of official GA features.
         #
+        # @option arguments [Time] :master_timeout The period to wait for a connection to the master node.
+        #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
+        # @option arguments [Time] :timeout The period to wait for a response.
+        #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
+        # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
+        #  when they occur.
+        # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response
+        #  returned by Elasticsearch.
+        # @option arguments [Boolean] :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.
+        # @option arguments [Boolean] :pretty If set to `true` the returned JSON will be "pretty-formatted". Only use
+        #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/streams-logs-enable.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch#TODO
         #
         def logs_enable(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'streams.logs_enable' }
@@ -38,7 +61,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_streams/logs/_enable'
-          params = {}
+          params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(
             perform_request(method, path, params, body, headers, request_opts)

data/lib/elasticsearch/api/actions/streams/status.rb

@@ -22,11 +22,28 @@ module Elasticsearch
   module API
     module Streams
       module Actions
-        # Return the current status of the streams feature for each streams type
+        # Get the status of streams.
+        # Get the current status for all types of streams.
+        # This functionality is Experimental and may be changed or removed
+        # completely in a future release. Elastic will take a best effort approach
+        # to fix any issues, but experimental features are not subject to the
+        # support SLA of official GA features.
         #
+        # @option arguments [Time] :master_timeout Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
+        # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
+        #  when they occur.
+        # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response
+        #  returned by Elasticsearch.
+        # @option arguments [Boolean] :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.
+        # @option arguments [Boolean] :pretty If set to `true` the returned JSON will be "pretty-formatted". Only use
+        #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/streams-status.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch#TODO
         #
         def status(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'streams.status' }
@@ -38,7 +55,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_streams/status'
-          params = {}
+          params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(
             perform_request(method, path, params, body, headers, request_opts)

data/lib/elasticsearch/api/actions/tasks/list.rb

@@ -88,7 +88,7 @@ module Elasticsearch
         # @option arguments [Boolean] :detailed If `true`, the response includes detailed information about the running tasks.
         #  This information is useful to distinguish tasks from each other but is more costly to run.
         # @option arguments [String] :group_by A key that is used to group tasks in the response.
-        #  The task lists can be grouped either by nodes or by parent tasks.
+        #  The task lists can be grouped either by nodes or by parent tasks. Server default: nodes.
         # @option arguments [String, Array] :nodes A comma-separated list of node IDs or names that is used to limit the returned information.
         # @option arguments [String] :parent_task_id A parent task identifier that is used to limit returned information.
         #  To return all tasks, omit this parameter or use a value of `-1`.

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

@@ -52,6 +52,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 'index' missing" unless arguments[:index]
 
         arguments = arguments.clone
@@ -61,12 +62,7 @@ module Elasticsearch
 
         _index = arguments.delete(:index)
 
-        method = if body
-                   Elasticsearch::API::HTTP_POST
-                 else
-                   Elasticsearch::API::HTTP_GET
-                 end
-
+        method = Elasticsearch::API::HTTP_POST
         path   = "#{Utils.listify(_index)}/_terms_enum"
         params = Utils.process_params(arguments)
 

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

@@ -136,9 +136,7 @@ module Elasticsearch
                       body
                     end
 
-          headers.merge!({
-                           'Content-Type' => 'application/vnd.elasticsearch+x-ndjson; compatible-with=9'
-                         })
+          Utils.update_ndjson_headers!(headers, client.transport.options.dig(:transport_options, :headers))
           Elasticsearch::API::Response.new(
             perform_request(method, path, params, payload, headers, request_opts)
           )

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

@@ -22,7 +22,7 @@ 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
         #

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

@@ -0,0 +1,77 @@
+# 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.
+#
+# 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 Transform
+      module Actions
+        # Set upgrade_mode for transform indices.
+        # Sets a cluster wide upgrade_mode setting that prepares transform
+        # indices for an upgrade.
+        # When upgrading your cluster, in some circumstances you must restart your
+        # nodes and reindex your transform indices. In those circumstances,
+        # there must be no transforms running. You can close the transforms,
+        # do the upgrade, then open all the transforms again. Alternatively,
+        # you can use this API to temporarily halt tasks associated with the transforms
+        # and prevent new transforms from opening. You can also use this API
+        # during upgrades that do not require you to reindex your transform
+        # indices, though stopping transforms is not a requirement in that case.
+        # You can see the current value for the upgrade_mode setting by using the get
+        # transform info API.
+        #
+        # @option arguments [Boolean] :enabled When `true`, it enables `upgrade_mode` which temporarily halts all
+        #  transform tasks and prohibits new transform tasks from
+        #  starting.
+        # @option arguments [Time] :timeout The time to wait for the request to be completed. Server default: 30s.
+        # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
+        #  when they occur.
+        # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response
+        #  returned by Elasticsearch.
+        # @option arguments [Boolean] :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.
+        # @option arguments [Boolean] :pretty If set to `true` the returned JSON will be "pretty-formatted". Only use
+        #  this option for debugging only.
+        # @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/update_by_query.rb

@@ -103,8 +103,8 @@ module Elasticsearch
       # @option arguments [Boolean] :analyze_wildcard If `true`, wildcard and prefix queries are analyzed.
       #  This parameter can be used only when the `q` query string parameter is specified.
       # @option arguments [String] :conflicts The preferred behavior when update by query hits version conflicts: `abort` or `proceed`. Server default: abort.
-      # @option arguments [String] :default_operator The default operator for query string query: `AND` or `OR`.
-      #  This parameter can be used only when the `q` query string parameter is specified. Server default: OR.
+      # @option arguments [String] :default_operator The default operator for query string query: `and` or `or`.
+      #  This parameter can be used only when the `q` query string parameter is specified. Server default: or.
       # @option arguments [String] :df The field to use as default where no field prefix is given in the query string.
       #  This parameter can be used only when the `q` query string parameter is specified.
       # @option arguments [String, Array<String>] :expand_wildcards The type of index that wildcard patterns can match.

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

@@ -27,7 +27,7 @@ module Elasticsearch
         # Only a subset of settings are shown, for example `index.auto_expand_replicas` and `index.number_of_replicas`.
         #
         # @option arguments [Time] :master_timeout The period to wait for a connection to the master node.
-        #  If no response is received before the timeout expires, the request fails and returns an error.
+        #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.
         # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

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

@@ -62,6 +62,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

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

@@ -31,7 +31,7 @@ module Elasticsearch
         # Watcher shards must always be in the `data_content` tier.
         #
         # @option arguments [Time] :master_timeout The period to wait for a connection to the master node.
-        #  If no response is received before the timeout expires, the request fails and returns an error.
+        #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
         # @option arguments [Time] :timeout The period to wait for a response.
         #  If no response is received before the timeout expires, the request fails and returns an error.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors

data/lib/elasticsearch/api/utils.rb

@@ -177,6 +177,21 @@ module Elasticsearch
         end
       end
 
+      # Updates ndjson headers for msearch, bulk, and others
+      #
+      def update_ndjson_headers!(headers, client_headers)
+        current_content = client_headers.keys.find { |c| c.match?(/content-?_?type/i) } || 'content-type'
+        current_accept = client_headers.keys.find { |c| c.match?(/accept/i) } || 'accept'
+        version = client_headers[current_content].match(/compatible-with=([0-9]+)/)[1] || 9
+
+        headers.merge!(
+          {
+            current_content => "application/vnd.elasticsearch+x-ndjson; compatible-with=#{version}",
+            current_accept => "application/vnd.elasticsearch+x-ndjson; compatible-with=#{version}"
+          }
+        )
+      end
+
       extend self
     end
   end

data/lib/elasticsearch/api/version.rb

@@ -17,7 +17,7 @@
 
 module Elasticsearch
   module API
-    VERSION = '9.1.1'.freeze
-    ES_SPECIFICATION_COMMIT = '569f8b3768762075a47e5fa16a694b41cbc90a34'.freeze
+    VERSION = '9.2.0'.freeze
+    ES_SPECIFICATION_COMMIT = 'd520d9e8cf14cad487de5e0654007686c395b494'.freeze
   end
 end

data/lib/elasticsearch/api.rb

@@ -71,6 +71,7 @@ module Elasticsearch
                       :migration,
                       :machine_learning,
                       :nodes,
+                      :project,
                       :query_rules,
                       :search_application,
                       :searchable_snapshots,