elasticsearch-api 8.18.0 → 9.0.1

data/lib/elasticsearch/api/actions/indices/segments.rb

@@ -15,23 +15,30 @@
 # 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 Indices
       module Actions
-        # Provides low-level information about segments in a Lucene index.
+        # Get index segments.
+        # Get low-level information about the Lucene segments in index shards.
+        # For data streams, the API returns information about the stream's backing indices.
         #
-        # @option arguments [List] :index A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices
-        # @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] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. (options: open, closed, hidden, none, all)
-        # @option arguments [Boolean] :verbose Includes detailed memory usage by Lucene. *Deprecated*
+        # @option arguments [String, Array] :index Comma-separated list of data streams, indices, and aliases used to limit the request.
+        #  Supports wildcards (+*+).
+        #  To target all data streams and indices, omit this parameter or use +*+ or +_all+.
+        # @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. Server default: true.
+        # @option arguments [String, Array<String>] :expand_wildcards Type of index that wildcard patterns can match.
+        #  If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.
+        #  Supports comma-separated values, such as +open,hidden+.
+        #  Valid values are: +all+, +open+, +closed+, +hidden+, +none+. Server default: open.
+        # @option arguments [Boolean] :ignore_unavailable If +false+, the request returns an error if it targets a missing or closed index.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-segments.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-segments
         #
         def segments(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.segments' }
@@ -44,13 +51,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)}/_segments"
+                     "#{Utils.listify(_index)}/_segments"
                    else
                      '_segments'
                    end

data/lib/elasticsearch/api/actions/indices/shard_stores.rb

@@ -15,23 +15,34 @@
 # 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 Indices
       module Actions
-        # Provides store information for shard copies of indices.
+        # Get index shard stores.
+        # Get store information about replica shards in one or more indices.
+        # For data streams, the API retrieves store information for the stream's backing indices.
+        # The index shard stores API returns the following information:
+        # * The node on which each replica shard exists.
+        # * The allocation ID for each replica shard.
+        # * A unique ID for each replica shard.
+        # * Any errors encountered while opening the shard index or from an earlier failure.
+        # By default, the API returns store information only for primary shards that are unassigned or have one or more unassigned replica shards.
         #
-        # @option arguments [List] :index A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices
-        # @option arguments [List] :status A comma-separated list of statuses used to filter on shards to get store information for (options: green, yellow, red, all)
-        # @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] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. (options: open, closed, hidden, none, all)
+        # @option arguments [String, Array] :index List of data streams, indices, and aliases used to limit the request.
+        # @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.
+        # @option arguments [String, Array<String>] :expand_wildcards Type of index that wildcard patterns can match. If the request can target data streams,
+        #  this argument determines whether wildcard expressions match hidden data streams. Server default: open.
+        # @option arguments [Boolean] :ignore_unavailable If true, missing or closed indices are not included in the response.
+        # @option arguments [Shardstorestatus] :status List of shard health statuses used to limit the request.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-shards-stores.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-shard-stores
         #
         def shard_stores(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.shard_stores' }
@@ -44,13 +55,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)}/_shard_stores"
+                     "#{Utils.listify(_index)}/_shard_stores"
                    else
                      '_shard_stores'
                    end

data/lib/elasticsearch/api/actions/indices/shrink.rb

@@ -15,29 +15,54 @@
 # 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 Indices
       module Actions
-        # Allow to shrink an existing index into a new index with fewer primary shards.
+        # Shrink an index.
+        # Shrink an index into a new index with fewer primary shards.
+        # Before you can shrink an index:
+        # * The index must be read-only.
+        # * A copy of every shard in the index must reside on the same node.
+        # * The index must have a green health status.
+        # To make shard allocation easier, we recommend you also remove the index's replica shards.
+        # You can later re-add replica shards as part of the shrink operation.
+        # The requested number of primary shards in the target index must be a factor of the number of shards in the source index.
+        # For example an index with 8 primary shards can be shrunk into 4, 2 or 1 primary shards or an index with 15 primary shards can be shrunk into 5, 3 or 1.
+        # If the number of shards in the index is a prime number it can only be shrunk into a single primary shard
+        #  Before shrinking, a (primary or replica) copy of every shard in the index must be present on the same node.
+        # The current write index on a data stream cannot be shrunk. In order to shrink the current write index, the data stream must first be rolled over so that a new write index is created and then the previous write index can be shrunk.
+        # A shrink operation:
+        # * Creates a new target index with the same definition as the source index, but with a smaller number of primary shards.
+        # * Hard-links segments from the source index into the target index. If the file system does not support hard-linking, then all segments are copied into the new index, which is a much more time consuming process. Also if using multiple data paths, shards on different data paths require a full copy of segment files if they are not on the same disk since hardlinks do not work across disks.
+        # * Recovers the target index as though it were a closed index which had just been re-opened. Recovers shards to the +.routing.allocation.initial_recovery._id+ index setting.
+        # IMPORTANT: Indices can only be shrunk if they satisfy the following requirements:
+        # * The target index must not exist.
+        # * The source index must have more primary shards than the target index.
+        # * The number of primary shards in the target index must be a factor of the number of primary shards in the source index. The source index must have more primary shards than the target index.
+        # * The index must not contain more than 2,147,483,519 documents in total across all shards that will be shrunk into a single shard on the target index as this is the maximum number of docs that can fit into a single shard.
+        # * The node handling the shrink process must have sufficient free disk space to accommodate a second copy of the existing index.
         #
-        # @option arguments [String] :index The name of the source index to shrink
-        # @option arguments [String] :target The name of the target index to shrink into
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
-        # @option arguments [String] :wait_for_active_shards Set the number of active shards to wait for on the shrunken index before the operation returns.
+        # @option arguments [String] :index Name of the source index to shrink. (*Required*)
+        # @option arguments [String] :target Name of the target index to create. (*Required*)
+        # @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 [Time] :timeout 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 [Integer, String] :wait_for_active_shards The number of shard copies that must be active before proceeding with the operation.
+        #  Set to +all+ or any positive integer up to the total number of shards in the index (+number_of_replicas+1+). Server default: 1.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The configuration for the target index (`settings` and `aliases`)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-shrink-index.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-shrink
         #
         def shrink(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.shrink' }
 
-          defined_params = %i[index target].each_with_object({}) do |variable, set_variables|
+          defined_params = [:index, :target].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?
@@ -48,14 +73,14 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           _index = arguments.delete(:index)
 
           _target = arguments.delete(:target)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "#{Utils.__listify(_index)}/_shrink/#{Utils.__listify(_target)}"
+          path   = "#{Utils.listify(_index)}/_shrink/#{Utils.listify(_target)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/indices/simulate_index_template.rb

@@ -15,24 +15,24 @@
 # 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 Indices
       module Actions
-        # Simulate matching the given index name against the index templates in the system
+        # Simulate an index.
+        # Get the index configuration that would be applied to the specified index from an existing index template.
         #
-        # @option arguments [String] :name The name of the index (it must be a concrete index name)
+        # @option arguments [String] :name Name of the index to simulate (*Required*)
         # @option arguments [Boolean] :create Whether the index template we optionally defined in the body should only be dry-run added if new or can also replace an existing one
-        # @option arguments [String] :cause User defined reason for dry-run creating the new template for simulation purposes
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
-        # @option arguments [Boolean] :include_defaults Return all relevant default configurations for this index template simulation (default: false)
+        # @option arguments [String] :cause User defined reason for dry-run creating the new template for simulation purposes Server default: false.
+        # @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] :include_defaults If true, returns all relevant default configurations for the index template.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body New index template definition, which will be included in the simulation, as if it already exists in the system
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-simulate-index.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-simulate-index-template
         #
         def simulate_index_template(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.simulate_index_template' }
@@ -47,12 +47,12 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body = arguments.delete(:body)
+          body = nil
 
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_index_template/_simulate_index/#{Utils.__listify(_name)}"
+          path   = "_index_template/_simulate_index/#{Utils.listify(_name)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/indices/simulate_template.rb

@@ -15,24 +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 Indices
       module Actions
-        # Simulate resolving the given template name or body
+        # Simulate an index template.
+        # Get the index configuration that would be applied by a particular index template.
         #
-        # @option arguments [String] :name The name of the index template
-        # @option arguments [Boolean] :create Whether the index template we optionally defined in the body should only be dry-run added if new or can also replace an existing one
+        # @option arguments [String] :name Name of the index template to simulate. To test a template configuration before you add it to the cluster, omit
+        #  this parameter and specify the template configuration in the request body.
+        # @option arguments [Boolean] :create If true, the template passed in the body is only used if no existing templates match the same index patterns. If false, the simulation uses the template with the highest priority. Note that the template is not permanently added or updated in either case; it is only used for the simulation.
         # @option arguments [String] :cause User defined reason for dry-run creating the new template for simulation purposes
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
-        # @option arguments [Boolean] :include_defaults Return all relevant default configurations for this template simulation (default: false)
+        # @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] :include_defaults If true, returns all relevant default configurations for the index template.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body New index template definition to be simulated, if no index template name is specified
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-simulate-template.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-simulate-template
         #
         def simulate_template(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.simulate_template' }
@@ -51,7 +53,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_POST
           path   = if _name
-                     "_index_template/_simulate/#{Utils.__listify(_name)}"
+                     "_index_template/_simulate/#{Utils.listify(_name)}"
                    else
                      '_index_template/_simulate'
                    end

data/lib/elasticsearch/api/actions/indices/split.rb

@@ -15,29 +15,55 @@
 # 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 Indices
       module Actions
-        # Allows you to split an existing index into a new index with more primary shards.
+        # Split an index.
+        # Split an index into a new index with more primary shards.
+        # * Before you can split an index:
+        # * The index must be read-only.
+        # * The cluster health status must be green.
+        # You can do make an index read-only with the following request using the add index block API:
+        # +
+        # PUT /my_source_index/_block/write
+        # +
+        # The current write index on a data stream cannot be split.
+        # In order to split the current write index, the data stream must first be rolled over so that a new write index is created and then the previous write index can be split.
+        # The number of times the index can be split (and the number of shards that each original shard can be split into) is determined by the +index.number_of_routing_shards+ setting.
+        # The number of routing shards specifies the hashing space that is used internally to distribute documents across shards with consistent hashing.
+        # For instance, a 5 shard index with +number_of_routing_shards+ set to 30 (5 x 2 x 3) could be split by a factor of 2 or 3.
+        # A split operation:
+        # * Creates a new target index with the same definition as the source index, but with a larger number of primary shards.
+        # * Hard-links segments from the source index into the target index. If the file system doesn't support hard-linking, all segments are copied into the new index, which is a much more time consuming process.
+        # * Hashes all documents again, after low level files are created, to delete documents that belong to a different shard.
+        # * Recovers the target index as though it were a closed index which had just been re-opened.
+        # IMPORTANT: Indices can only be split if they satisfy the following requirements:
+        # * The target index must not exist.
+        # * The source index must have fewer primary shards than the target index.
+        # * The number of primary shards in the target index must be a multiple of the number of primary shards in the source index.
+        # * The node handling the split process must have sufficient free disk space to accommodate a second copy of the existing index.
         #
-        # @option arguments [String] :index The name of the source index to split
-        # @option arguments [String] :target The name of the target index to split into
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
-        # @option arguments [String] :wait_for_active_shards Set the number of active shards to wait for on the shrunken index before the operation returns.
+        # @option arguments [String] :index Name of the source index to split. (*Required*)
+        # @option arguments [String] :target Name of the target index to create. (*Required*)
+        # @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 [Time] :timeout 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 [Integer, String] :wait_for_active_shards The number of shard copies that must be active before proceeding with the operation.
+        #  Set to +all+ or any positive integer up to the total number of shards in the index (+number_of_replicas+1+). Server default: 1.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The configuration for the target index (`settings` and `aliases`)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-split-index.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-split
         #
         def split(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.split' }
 
-          defined_params = %i[index target].each_with_object({}) do |variable, set_variables|
+          defined_params = [:index, :target].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?
@@ -48,14 +74,14 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           _index = arguments.delete(:index)
 
           _target = arguments.delete(:target)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "#{Utils.__listify(_index)}/_split/#{Utils.__listify(_target)}"
+          path   = "#{Utils.listify(_index)}/_split/#{Utils.listify(_target)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,34 +15,43 @@
 # 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 Indices
       module Actions
-        # Provides statistics on operations happening in an index.
+        # Get index statistics.
+        # For data streams, the API retrieves statistics for the stream's backing indices.
+        # By default, the returned statistics are index-level with +primaries+ and +total+ aggregations.
+        # +primaries+ are the values for only the primary shards.
+        # +total+ are the accumulated values for both primary and replica shards.
+        # To get shard-level statistics, set the +level+ parameter to +shards+.
+        # NOTE: When moving to another node, the shard-level statistics for a shard are cleared.
+        # Although the shard is no longer part of the node, that node retains any node-level statistics to which the shard contributed.
         #
-        # @option arguments [List] :metric Limit the information returned the specific metrics. (options: _all, completion, docs, fielddata, query_cache, flush, get, indexing, merge, request_cache, refresh, search, segments, store, warmer, bulk)
-        # @option arguments [List] :index A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices
-        # @option arguments [List] :completion_fields A comma-separated list of fields for the `completion` index metric (supports wildcards)
-        # @option arguments [List] :fielddata_fields A comma-separated list of fields for the `fielddata` index metric (supports wildcards)
-        # @option arguments [List] :fields A comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards)
-        # @option arguments [List] :groups A comma-separated list of search groups for `search` index metric
-        # @option arguments [String] :level Return stats aggregated at cluster, index or shard level (options: cluster, indices, shards)
-        # @option arguments [Boolean] :include_segment_file_sizes Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)
-        # @option arguments [Boolean] :include_unloaded_segments If set to true segment stats will include stats for segments that are not currently loaded into memory
-        # @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 [Boolean] :forbid_closed_indices If set to false stats will also collected from closed indices if explicitly specified or if expand_wildcards expands to closed indices
+        # @option arguments [String, Array<String>] :metric Limit the information returned the specific metrics.
+        # @option arguments [String, Array] :index A comma-separated list of index names; use +_all+ or empty string to perform the operation on all indices
+        # @option arguments [String, Array<String>] :completion_fields Comma-separated list or wildcard expressions of fields to include in fielddata and suggest statistics.
+        # @option arguments [String, Array<String>] :expand_wildcards Type of index that wildcard patterns can match. If the request can target data streams, this argument
+        #  determines whether wildcard expressions match hidden data streams. Supports comma-separated values,
+        #  such as +open,hidden+.
+        # @option arguments [String, Array<String>] :fielddata_fields Comma-separated list or wildcard expressions of fields to include in fielddata statistics.
+        # @option arguments [String, Array<String>] :fields Comma-separated list or wildcard expressions of fields to include in the statistics.
+        # @option arguments [Boolean] :forbid_closed_indices If true, statistics are not collected from closed indices. Server default: true.
+        # @option arguments [String] :groups Comma-separated list of search groups to include in the search statistics.
+        # @option arguments [Boolean] :include_segment_file_sizes If true, the call reports the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).
+        # @option arguments [Boolean] :include_unloaded_segments If true, the response includes information from segments that are not loaded into memory.
+        # @option arguments [String] :level Indicates whether statistics are aggregated at the cluster, index, or shard level.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-stats.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-stats
         #
         def stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.stats' }
 
-          defined_params = %i[metric index].each_with_object({}) do |variable, set_variables|
+          defined_params = [:metric, :index].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?
@@ -58,11 +67,11 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _index && _metric
-                     "#{Utils.__listify(_index)}/_stats/#{Utils.__listify(_metric)}"
+                     "#{Utils.listify(_index)}/_stats/#{Utils.listify(_metric)}"
                    elsif _metric
-                     "_stats/#{Utils.__listify(_metric)}"
+                     "_stats/#{Utils.listify(_metric)}"
                    elsif _index
-                     "#{Utils.__listify(_index)}/_stats"
+                     "#{Utils.listify(_index)}/_stats"
                    else
                      '_stats'
                    end

data/lib/elasticsearch/api/actions/indices/update_aliases.rb

@@ -15,21 +15,24 @@
 # 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 Indices
       module Actions
-        # Updates index aliases.
+        # Create or update an alias.
+        # Adds a data stream or index to an alias.
         #
-        # @option arguments [Time] :timeout Request timeout
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @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 [Time] :timeout 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 [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The definition of `actions` to perform (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-aliases.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-update-aliases
         #
         def update_aliases(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.update_aliases' }
@@ -39,7 +42,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_aliases'

data/lib/elasticsearch/api/actions/indices/validate_query.rb

@@ -15,32 +15,41 @@
 # 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 Indices
       module Actions
-        # Allows a user to validate a potentially expensive query without executing it.
+        # Validate a query.
+        # Validates a query without running it.
         #
-        # @option arguments [List] :index A comma-separated list of index names to restrict the operation; use `_all` or empty string to perform the operation on all indices
-        # @option arguments [Boolean] :explain Return detailed information about the error
-        # @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] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. (options: open, closed, hidden, none, all)
-        # @option arguments [String] :q Query in the Lucene query string syntax
-        # @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 [Boolean] :lenient Specify whether format-based query failures (such as providing text to a numeric field) should be ignored
-        # @option arguments [Boolean] :rewrite Provide a more detailed explanation showing the actual Lucene query that will be executed.
-        # @option arguments [Boolean] :all_shards Execute validation on all shards instead of one random shard per index
+        # @option arguments [String, Array] :index Comma-separated list of data streams, indices, and aliases to search.
+        #  Supports wildcards (+*+).
+        #  To search all data streams or indices, omit this parameter or use +*+ or +_all+.
+        # @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. Server default: true.
+        # @option arguments [Boolean] :all_shards If +true+, the validation is executed on all shards instead of one random shard per index.
+        # @option arguments [String] :analyzer Analyzer to use for the query string.
+        #  This parameter can only be used when the +q+ query string parameter is specified.
+        # @option arguments [Boolean] :analyze_wildcard If +true+, wildcard and prefix queries are analyzed.
+        # @option arguments [String] :default_operator The default operator for query string query: +AND+ or +OR+. Server default: OR.
+        # @option arguments [String] :df Field to use as default where no field prefix is given in the query string.
+        #  This parameter can only be used when the +q+ query string parameter is specified.
+        # @option arguments [String, Array<String>] :expand_wildcards Type of index that wildcard patterns can match.
+        #  If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.
+        #  Supports comma-separated values, such as +open,hidden+.
+        #  Valid values are: +all+, +open+, +closed+, +hidden+, +none+. Server default: open.
+        # @option arguments [Boolean] :explain If +true+, the response returns detailed information if an error has occurred.
+        # @option arguments [Boolean] :ignore_unavailable If +false+, the request returns an error if it targets a missing or closed index.
+        # @option arguments [Boolean] :lenient If +true+, format-based query failures (such as providing text to a numeric field) in the query string will be ignored.
+        # @option arguments [Boolean] :rewrite If +true+, returns a more detailed explanation showing the actual Lucene query that will be executed.
+        # @option arguments [String] :q Query in the Lucene query string syntax.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The query definition specified with the Query DSL
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/search-validate.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-validate-query
         #
         def validate_query(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.validate_query' }
@@ -63,11 +72,11 @@ module Elasticsearch
                      Elasticsearch::API::HTTP_GET
                    end
 
-          path = if _index
-                   "#{Utils.__listify(_index)}/_validate/query"
-                 else
-                   '_validate/query'
-                 end
+          path   = if _index
+                     "#{Utils.listify(_index)}/_validate/query"
+                   else
+                     '_validate/query'
+                   end
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(