elasticsearch-api 8.19.2 → 9.0.0

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

@@ -15,21 +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 Indices
       module Actions
-        # Create a data stream
+        # Create a data stream.
+        # You must have a matching index template with data stream enabled.
         #
-        # @option arguments [String] :name The name of the data stream
-        # @option arguments [Time] :timeout Specify timeout for acknowledging the cluster state update
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [String] :name Name of the data stream, which must meet the following criteria:
+        #  Lowercase only;
+        #  Cannot include +\+, +/+, +*+, +?+, +"+, +<+, +>+, +|+, +,+, +#+, +:+, or a space character;
+        #  Cannot start with +-+, +_+, +++, or +.ds-+;
+        #  Cannot be +.+ or +..+;
+        #  Cannot be longer than 255 bytes. Multi-byte characters count towards this limit faster. (*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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-create-data-stream.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-create-data-stream
         #
         def create_data_stream(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.create_data_stream' }
@@ -49,7 +55,7 @@ module Elasticsearch
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "_data_stream/#{Utils.__listify(_name)}"
+          path   = "_data_stream/#{Utils.listify(_name)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,30 +15,36 @@
 # 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
-        # Create an index from a source index
+        # Create an index from a source index.
+        # Copy the mappings and settings from the source index to a destination index while allowing request settings and mappings to override the source values.
+        # 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 [String] :source The source index name
-        # @option arguments [String] :dest The destination index name
+        # @option arguments [String] :source The source index or data stream name (*Required*)
+        # @option arguments [String] :dest The destination index or data stream name (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The body contains the fields `mappings_override`, `settings_override`, and `remove_index_blocks`.
+        # @option arguments [Hash] :body create_from
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/migrate-data-stream.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-create-from
         #
         def create_from(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.create_from' }
 
-          defined_params = %i[source dest].each_with_object({}) do |variable, set_variables|
+          defined_params = [:source, :dest].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?
 
+          raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
           raise ArgumentError, "Required argument 'source' missing" unless arguments[:source]
           raise ArgumentError, "Required argument 'dest' missing" unless arguments[:dest]
 
@@ -52,7 +58,7 @@ module Elasticsearch
           _dest = arguments.delete(:dest)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "_create_from/#{Utils.__listify(_source)}/#{Utils.__listify(_dest)}"
+          path   = "_create_from/#{Utils.listify(_source)}/#{Utils.listify(_dest)}"
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,19 +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
-        # Get data stream stats
+        # Get data stream stats.
+        # Get statistics for one or more data streams.
         #
-        # @option arguments [List] :name A comma-separated list of data stream names; use `_all` or empty string to perform the operation on all data streams
+        # @option arguments [String] :name Comma-separated list of data streams used to limit the request.
+        #  Wildcard expressions (+*+) are supported.
+        #  To target all data streams in a cluster, omit this parameter or use +*+.
+        # @option arguments [String, Array<String>] :expand_wildcards Type of data stream that wildcard patterns can match.
+        #  Supports comma-separated values, such as +open,hidden+. Server default: open.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/data-stream-stats-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-data-streams-stats-1
         #
         def data_streams_stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.data_streams_stats' }
@@ -46,11 +51,11 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _name
-                     "_data_stream/#{Utils.__listify(_name)}/_stats"
+                     "_data_stream/#{Utils.listify(_name)}/_stats"
                    else
                      '_data_stream/_stats'
                    end
-          params = {}
+          params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(
             perform_request(method, path, params, body, headers, request_opts)

data/lib/elasticsearch/api/actions/indices/delete.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 Indices
       module Actions
-        # Delete indices
+        # Delete indices.
+        # Deleting an index deletes its documents, shards, and metadata.
+        # It does not delete related Kibana components, such as data views, visualizations, or dashboards.
+        # You cannot delete the current write index of a data stream.
+        # To delete the index, you must roll over the data stream so a new write index is created.
+        # You can then use the delete index API to delete the previous write index.
         #
-        # @option arguments [List] :index A comma-separated list of indices to delete; use `_all` or `*` string to delete all indices
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
-        # @option arguments [Boolean] :ignore_unavailable Ignore unavailable indexes (default: false)
-        # @option arguments [Boolean] :allow_no_indices Ignore if a wildcard expression resolves to no concrete indices (default: false)
-        # @option arguments [String] :expand_wildcards Whether wildcard expressions should get expanded to open, closed, or hidden indices (options: open, closed, hidden, none, all)
+        # @option arguments [String, Array] :index Comma-separated list of indices to delete.
+        #  You cannot specify index aliases.
+        #  By default, this parameter does not support wildcards (+*+) or +_all+.
+        #  To use wildcards or +_all+, set the +action.destructive_requires_name+ cluster setting to +false+. (*Required*)
+        # @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 [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
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-delete-index.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-delete
         #
         def delete(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.delete' }
@@ -47,16 +61,16 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           _index = arguments.delete(:index)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "#{Utils.__listify(_index)}"
+          path   = Utils.listify(_index).to_s
           params = Utils.process_params(arguments)
 
           if Array(arguments[:ignore]).include?(404)
-            Utils.__rescue_from_not_found do
+            Utils.rescue_from_not_found do
               Elasticsearch::API::Response.new(
                 perform_request(method, path, params, body, headers, request_opts)
               )

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

@@ -15,27 +15,32 @@
 # 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
-        # Delete an alias
+        # Delete an alias.
+        # Removes a data stream or index from an alias.
         #
-        # @option arguments [List] :index A comma-separated list of index names (supports wildcards); use `_all` for all indices
-        # @option arguments [List] :name A comma-separated list of aliases to delete (supports wildcards); use `_all` to delete all aliases for the specified indices.
-        # @option arguments [Time] :timeout Explicit timestamp for the document
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [String, Array] :index Comma-separated list of data streams or indices used to limit the request.
+        #  Supports wildcards (+*+). (*Required*)
+        # @option arguments [String, Array<String>] :name Comma-separated list of aliases to remove.
+        #  Supports wildcards (+*+). To remove all aliases, use +*+ or +_all+. (*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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-delete-alias.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-delete-alias
         #
         def delete_alias(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.delete_alias' }
 
-          defined_params = %i[index name].each_with_object({}) do |variable, set_variables|
+          defined_params = [:index, :name].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?
@@ -46,14 +51,14 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           _index = arguments.delete(:index)
 
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = ("#{Utils.__listify(_index)}/_aliases/#{Utils.__listify(_name)}" if _index && _name)
+          path   = ("#{Utils.listify(_index)}/_aliases/#{Utils.listify(_name)}" if _index && _name)
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,22 +15,23 @@
 # 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
-        # Delete data stream lifecycles
+        # Delete data stream lifecycles.
+        # Removes the data stream lifecycle from a data stream, rendering it not managed by the data stream lifecycle.
         #
-        # @option arguments [List] :name A comma-separated list of data streams of which the data stream lifecycle will be deleted; use `*` to get all data streams
-        # @option arguments [String] :expand_wildcards Whether wildcard expressions should get expanded to open or closed indices (default: open) (options: open, closed, hidden, none, all)
-        # @option arguments [Time] :timeout Explicit timestamp for the document
+        # @option arguments [String, Array<String>] :name A comma-separated list of data streams of which the data stream lifecycle will be deleted; use +*+ to get all data streams (*Required*)
+        # @option arguments [String, Array<String>] :expand_wildcards Whether wildcard expressions should get expanded to open or closed indices (default: open)
         # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [Time] :timeout Explicit timestamp for the document
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/data-streams-delete-lifecycle.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-delete-data-lifecycle
         #
         def delete_data_lifecycle(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.delete_data_lifecycle' }
@@ -50,7 +51,7 @@ module Elasticsearch
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_data_stream/#{Utils.__listify(_name)}/_lifecycle"
+          path   = "_data_stream/#{Utils.listify(_name)}/_lifecycle"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,21 +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 Indices
       module Actions
-        # Delete data streams
+        # Delete data streams.
+        # Deletes one or more data streams and their backing indices.
         #
-        # @option arguments [List] :name A comma-separated list of data streams to delete; use `*` to delete all data streams
-        # @option arguments [String] :expand_wildcards Whether wildcard expressions should get expanded to open or closed indices (default: open) (options: open, closed, hidden, none, all)
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [String, Array<String>] :name Comma-separated list of data streams to delete. Wildcard (+*+) expressions are supported. (*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 [String, Array<String>] :expand_wildcards Type of data stream that wildcard patterns can match. Supports comma-separated values,such as +open,hidden+. Server default: open.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-delete-data-stream.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-delete-data-stream
         #
         def delete_data_stream(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.delete_data_stream' }
@@ -49,7 +50,7 @@ module Elasticsearch
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_data_stream/#{Utils.__listify(_name)}"
+          path   = "_data_stream/#{Utils.listify(_name)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/indices/delete_index_template.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
-        # Delete an index template
+        # Delete an index template.
+        # The provided <index-template> may contain multiple template names separated by a comma. If multiple template
+        # names are specified then there is no wildcard support and the provided names should match completely with
+        # existing templates.
         #
-        # @option arguments [String] :name The name of the template
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [String, Array<String>] :name Comma-separated list of index template names used to limit the request. Wildcard (*) expressions are supported. (*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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-delete-template.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-delete-index-template
         #
         def delete_index_template(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.delete_index_template' }
@@ -49,7 +52,7 @@ module Elasticsearch
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_index_template/#{Utils.__listify(_name)}"
+          path   = "_index_template/#{Utils.listify(_name)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/indices/delete_template.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
-        # Delete a legacy index template
+        # Delete a legacy index template.
         #
-        # @option arguments [String] :name The name of the template
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [String] :name The name of the legacy index template to delete.
+        #  Wildcard (+*+) expressions are supported. (*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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-delete-template-v1.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-delete-template
         #
         def delete_template(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.delete_template' }
@@ -49,11 +52,11 @@ module Elasticsearch
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_template/#{Utils.__listify(_name)}"
+          path   = "_template/#{Utils.listify(_name)}"
           params = Utils.process_params(arguments)
 
           if Array(arguments[:ignore]).include?(404)
-            Utils.__rescue_from_not_found do
+            Utils.rescue_from_not_found do
               Elasticsearch::API::Response.new(
                 perform_request(method, path, params, body, headers, request_opts)
               )

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

@@ -15,28 +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
-        # Analyze the index disk usage
+        # Analyze the index disk usage.
+        # Analyze the disk usage of each field of an index or data stream.
+        # This API might not support indices created in previous Elasticsearch versions.
+        # The result of a small index can be inaccurate as some parts of an index might not be analyzed by the API.
+        # NOTE: The total size of fields of the analyzed shards of the index in the response is usually smaller than the index +store_size+ value because some small metadata files are ignored and some parts of data files might not be scanned by the API.
+        # Since stored fields are stored together in a compressed format, the sizes of stored fields are also estimates and can be inaccurate.
+        # The stored size of the +_id+ field is likely underestimated while the +_source+ field is overestimated.
         # 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 [String] :index Comma-separated list of indices or data streams to analyze the disk usage
-        # @option arguments [Boolean] :run_expensive_tasks Must be set to [true] in order for the task to be performed. Defaults to false.
-        # @option arguments [Boolean] :flush Whether flush or not before analyzing the index disk usage. Defaults to true
-        # @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 Comma-separated list of data streams, indices, and aliases used to limit the request.
+        #  It’s recommended to execute this API with a single index (or the latest backing index of a data stream) as the API consumes resources significantly. (*Required*)
+        # @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+. 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+. Server default: open.
+        # @option arguments [Boolean] :flush If +true+, the API performs a flush before analysis.
+        #  If +false+, the response may not include uncommitted data. Server default: true.
+        # @option arguments [Boolean] :ignore_unavailable If +true+, missing or closed indices are not included in the response.
+        # @option arguments [Boolean] :run_expensive_tasks Analyzing field disk usage is resource-intensive.
+        #  To use the API, this parameter must be set to +true+.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-disk-usage.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-disk-usage
         #
         def disk_usage(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.disk_usage' }
@@ -51,12 +64,12 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           _index = arguments.delete(:index)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "#{Utils.__listify(_index)}/_disk_usage"
+          path   = "#{Utils.listify(_index)}/_disk_usage"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,30 +15,36 @@
 # 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
-        # Downsample an index
+        # Downsample an index.
+        # Aggregate a time series (TSDS) index and store pre-computed statistical summaries (+min+, +max+, +sum+, +value_count+ and +avg+) for each metric field grouped by a configured time interval.
+        # For example, a TSDS index that contains metrics sampled every 10 seconds can be downsampled to an hourly index.
+        # All documents within an hour interval are summarized and stored as a single document in the downsample index.
+        # NOTE: Only indices in a time series data stream are supported.
+        # Neither field nor document level security can be defined on the source index.
+        # The source index must be read only (+index.blocks.write: true+).
         # 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 [String] :index The index to downsample (*Required*)
-        # @option arguments [String] :target_index The name of the target index to store downsampled data (*Required*)
+        # @option arguments [String] :index Name of the time series index to downsample. (*Required*)
+        # @option arguments [String] :target_index Name of the index to create. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The downsampling configuration (*Required*)
+        # @option arguments [Hash] :body config
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-downsample-data-stream.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-downsample
         #
         def downsample(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.downsample' }
 
-          defined_params = %i[index target_index].each_with_object({}) do |variable, set_variables|
+          defined_params = [:index, :target_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?
@@ -50,14 +56,14 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           _index = arguments.delete(:index)
 
           _target_index = arguments.delete(:target_index)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "#{Utils.__listify(_index)}/_downsample/#{Utils.__listify(_target_index)}"
+          path   = "#{Utils.listify(_index)}/_downsample/#{Utils.listify(_target_index)}"
           params = {}
 
           Elasticsearch::API::Response.new(