elasticsearch-api 8.17.2 → 9.0.0

data/lib/elasticsearch/api/actions/{rollup/stop_job.rb → esql/async_query_stop.rb}

@@ -15,28 +15,28 @@
 # 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 Rollup
+    module Esql
       module Actions
-        # Stops an existing, started rollup job.
-        # 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.
+        # Stop async ES|QL query.
+        # This API interrupts the query execution and returns the results so far.
+        # If the Elasticsearch security features are enabled, only the user who first submitted the ES|QL query can stop it.
         #
-        # @option arguments [String] :id The ID of the job to stop
-        # @option arguments [Boolean] :wait_for_completion True if the API should block until the job has fully stopped, false if should be executed async. Defaults to false.
-        # @option arguments [Time] :timeout Block for (at maximum) the specified duration while waiting for the job to stop.  Defaults to 30s.
+        # @option arguments [String] :id The unique identifier of the query.
+        #  A query ID is provided in the ES|QL async query API response for a query that does not complete in the designated time.
+        #  A query ID is also provided when the request was submitted with the +keep_on_completion+ parameter set to +true+. (*Required*)
+        # @option arguments [Boolean] :drop_null_columns Indicates whether columns that are entirely +null+ will be removed from the +columns+ and +values+ portion of the results.
+        #  If +true+, the response will include an extra section under the name +all_columns+ which has the name of all the columns.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/rollup-stop-job.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-esql-async-query-stop
         #
-        def stop_job(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || 'rollup.stop_job' }
+        def async_query_stop(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'esql.async_query_stop' }
 
           defined_params = [:id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
@@ -53,7 +53,7 @@ module Elasticsearch
           _id = arguments.delete(:id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_rollup/job/#{Utils.__listify(_id)}/_stop"
+          path   = "_query/async/#{Utils.listify(_id)}/stop"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,22 +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 Esql
       module Actions
-        # Executes an ESQL request
+        # Run an ES|QL query.
+        # Get search results for an ES|QL (Elasticsearch query language) query.
+        # This functionality is subject to potential breaking changes within a
+        # minor version, meaning that your referencing code may break when this
+        # library is upgraded.
         #
-        # @option arguments [String] :format a short version of the Accept header, e.g. json, yaml
-        # @option arguments [String] :delimiter The character to use between values within a CSV row. Only valid for the csv format.
-        # @option arguments [Boolean] :drop_null_columns Should entirely null columns be removed from the results? Their name and type will be returning in a new `all_columns` section.
+        # @option arguments [String] :format A short version of the Accept header, e.g. json, yaml.
+        # @option arguments [String] :delimiter The character to use between values within a CSV row. Only valid for the CSV format.
+        # @option arguments [Boolean] :drop_null_columns Should columns that are entirely +null+ be removed from the +columns+ and +values+ portion of the results?
+        #  Defaults to +false+. If +true+ then the response will include an extra section under the name +all_columns+ which has the name of all columns.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body Use the `query` element to start a query. Use `columnar` to format the answer. (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/esql-query-api.html
+        # @see https://www.elastic.co/docs/explore-analyze/query-filter/languages/esql-rest
         #
         def query(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'esql.query' }
@@ -40,7 +45,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_query'

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

@@ -15,34 +15,60 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Actions
-      # Returns information about whether a document exists in an index.
+      # Check a document.
+      # Verify that a document exists.
+      # For example, check to see if a document with the +_id+ 0 exists:
+      # +
+      # HEAD my-index-000001/_doc/0
+      # +
+      # If the document exists, the API returns a status code of +200 - OK+.
+      # If the document doesn’t exist, the API returns +404 - Not Found+.
+      # **Versioning support**
+      # You can use the +version+ parameter to check the document only if its current version is equal to the specified one.
+      # Internally, Elasticsearch has marked the old document as deleted and added an entirely new document.
+      # The old version of the document doesn't disappear immediately, although you won't be able to access it.
+      # Elasticsearch cleans up deleted documents in the background as you continue to index more data.
       #
-      # @option arguments [String] :id The document ID
-      # @option arguments [String] :index The name of the index
-      # @option arguments [List] :stored_fields A comma-separated list of stored fields to return in the response
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on (default: random)
-      # @option arguments [Boolean] :realtime Specify whether to perform the operation in realtime or search mode
-      # @option arguments [Boolean] :refresh Refresh the shard containing the document before performing the operation
-      # @option arguments [String] :routing Specific routing value
-      # @option arguments [List] :_source True or false to return the _source field or not, or a list of fields to return
-      # @option arguments [List] :_source_excludes A list of fields to exclude from the returned _source field
-      # @option arguments [List] :_source_includes A list of fields to extract and return from the _source field
-      # @option arguments [Number] :version Explicit version number for concurrency control
-      # @option arguments [String] :version_type Specific version type (options: internal, external, external_gte)
+      # @option arguments [String] :id A unique document identifier. (*Required*)
+      # @option arguments [String] :index A comma-separated list of data streams, indices, and aliases.
+      #  It supports wildcards (+*+). (*Required*)
+      # @option arguments [String] :preference The node or shard the operation should be performed on.
+      #  By default, the operation is randomized between the shard replicas.If it is set to +_local+, the operation will prefer to be run on a local allocated shard when possible.
+      #  If it is set to a custom value, the value is used to guarantee that the same shards will be used for the same custom value.
+      #  This can help with "jumping values" when hitting different shards in different refresh states.
+      #  A sample value can be something like the web session ID or the user name.
+      # @option arguments [Boolean] :realtime If +true+, the request is real-time as opposed to near-real-time. Server default: true.
+      # @option arguments [Boolean] :refresh If +true+, the request refreshes the relevant shards before retrieving the document.
+      #  Setting it to +true+ should be done after careful thought and verification that this does not cause a heavy load on the system (and slow down indexing).
+      # @option arguments [String] :routing A custom value used to route operations to a specific shard.
+      # @option arguments [Boolean, String, Array<String>] :_source Indicates whether to return the +_source+ field (+true+ or +false+) or lists the fields to return.
+      # @option arguments [String, Array<String>] :_source_excludes A comma-separated list of source fields to exclude from the response.
+      #  You can also use this parameter to exclude fields from the subset specified in +_source_includes+ query parameter.
+      #  If the +_source+ parameter is +false+, this parameter is ignored.
+      # @option arguments [String, Array<String>] :_source_includes A comma-separated list of source fields to include in the response.
+      #  If this parameter is specified, only these source fields are returned.
+      #  You can exclude fields from this subset using the +_source_excludes+ query parameter.
+      #  If the +_source+ parameter is +false+, this parameter is ignored.
+      # @option arguments [String, Array<String>] :stored_fields A comma-separated list of stored fields to return as part of a hit.
+      #  If no fields are specified, no stored fields are included in the response.
+      #  If this field is specified, the +_source+ parameter defaults to +false+.
+      # @option arguments [Integer] :version Explicit version number for concurrency control.
+      #  The specified version must match the current version of the document for the request to succeed.
+      # @option arguments [String] :version_type The version type.
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/docs-get.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-get
       #
       def exists(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'exists' }
 
-        defined_params = %i[index id].each_with_object({}) do |variable, set_variables|
+        defined_params = [:index, :id].each_with_object({}) do |variable, set_variables|
           set_variables[variable] = arguments[variable] if arguments.key?(variable)
         end
         request_opts[:defined_params] = defined_params unless defined_params.empty?
@@ -60,10 +86,10 @@ module Elasticsearch
         _index = arguments.delete(:index)
 
         method = Elasticsearch::API::HTTP_HEAD
-        path   = "#{Utils.__listify(_index)}/_doc/#{Utils.__listify(_id)}"
+        path   = "#{Utils.listify(_index)}/_doc/#{Utils.listify(_id)}"
         params = Utils.process_params(arguments)
 
-        Utils.__rescue_from_not_found do
+        Utils.rescue_from_not_found do
           perform_request(method, path, params, body, headers, request_opts).status == 200
         end
       end

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

@@ -15,33 +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 Actions
-      # Returns information about whether a document source exists in an index.
+      # Check for a document source.
+      # Check whether a document source exists in an index.
+      # For example:
+      # +
+      # HEAD my-index-000001/_source/1
+      # +
+      # A document's source is not available if it is disabled in the mapping.
       #
-      # @option arguments [String] :id The document ID
-      # @option arguments [String] :index The name of the index
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on (default: random)
-      # @option arguments [Boolean] :realtime Specify whether to perform the operation in realtime or search mode
-      # @option arguments [Boolean] :refresh Refresh the shard containing the document before performing the operation
-      # @option arguments [String] :routing Specific routing value
-      # @option arguments [List] :_source True or false to return the _source field or not, or a list of fields to return
-      # @option arguments [List] :_source_excludes A list of fields to exclude from the returned _source field
-      # @option arguments [List] :_source_includes A list of fields to extract and return from the _source field
-      # @option arguments [Number] :version Explicit version number for concurrency control
-      # @option arguments [String] :version_type Specific version type (options: internal, external, external_gte)
+      # @option arguments [String] :id A unique identifier for the document. (*Required*)
+      # @option arguments [String] :index A comma-separated list of data streams, indices, and aliases.
+      #  It supports wildcards (+*+). (*Required*)
+      # @option arguments [String] :preference The node or shard the operation should be performed on.
+      #  By default, the operation is randomized between the shard replicas.
+      # @option arguments [Boolean] :realtime If +true+, the request is real-time as opposed to near-real-time. Server default: true.
+      # @option arguments [Boolean] :refresh If +true+, the request refreshes the relevant shards before retrieving the document.
+      #  Setting it to +true+ should be done after careful thought and verification that this does not cause a heavy load on the system (and slow down indexing).
+      # @option arguments [String] :routing A custom value used to route operations to a specific shard.
+      # @option arguments [Boolean, String, Array<String>] :_source Indicates whether to return the +_source+ field (+true+ or +false+) or lists the fields to return.
+      # @option arguments [String, Array<String>] :_source_excludes A comma-separated list of source fields to exclude in the response.
+      # @option arguments [String, Array<String>] :_source_includes A comma-separated list of source fields to include in the response.
+      # @option arguments [Integer] :version The version number for concurrency control.
+      #  It must match the current version of the document for the request to succeed.
+      # @option arguments [String] :version_type The version type.
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/docs-get.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-get
       #
       def exists_source(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'exists_source' }
 
-        defined_params = %i[index id].each_with_object({}) do |variable, set_variables|
+        defined_params = [:index, :id].each_with_object({}) do |variable, set_variables|
           set_variables[variable] = arguments[variable] if arguments.key?(variable)
         end
         request_opts[:defined_params] = defined_params unless defined_params.empty?
@@ -59,7 +69,7 @@ module Elasticsearch
         _index = arguments.delete(:index)
 
         method = Elasticsearch::API::HTTP_HEAD
-        path   = "#{Utils.__listify(_index)}/_source/#{Utils.__listify(_id)}"
+        path   = "#{Utils.listify(_index)}/_source/#{Utils.listify(_id)}"
         params = Utils.process_params(arguments)
 
         Elasticsearch::API::Response.new(

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

@@ -15,37 +15,51 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Actions
-      # Returns information about why a specific matches (or doesn't match) a query.
+      # Explain a document match result.
+      # Get information about why a specific document matches, or doesn't match, a query.
+      # It computes a score explanation for a query and a specific document.
       #
-      # @option arguments [String] :id The document ID
-      # @option arguments [String] :index The name of the index
-      # @option arguments [Boolean] :analyze_wildcard Specify whether wildcards and prefix queries in the query string query should be analyzed (default: false)
-      # @option arguments [String] :analyzer The analyzer for the query string query
-      # @option arguments [String] :default_operator The default operator for query string query (AND or OR) (options: AND, OR)
-      # @option arguments [String] :df The default field for query string query (default: _all)
-      # @option arguments [List] :stored_fields A comma-separated list of stored fields to return in the response
-      # @option arguments [Boolean] :lenient Specify whether format-based query failures (such as providing text to a numeric field) should be ignored
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on (default: random)
-      # @option arguments [String] :q Query in the Lucene query string syntax
-      # @option arguments [String] :routing Specific routing value
-      # @option arguments [List] :_source True or false to return the _source field or not, or a list of fields to return
-      # @option arguments [List] :_source_excludes A list of fields to exclude from the returned _source field
-      # @option arguments [List] :_source_includes A list of fields to extract and return from the _source field
+      # @option arguments [String] :id The document identifier. (*Required*)
+      # @option arguments [String] :index Index names that are used to limit the request.
+      #  Only a single index name can be provided to this parameter. (*Required*)
+      # @option arguments [String] :analyzer The analyzer to use for the query string.
+      #  This parameter can be used only when the +q+ query string parameter is specified.
+      # @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] :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 [Boolean] :lenient If +true+, format-based query failures (such as providing text to a numeric field) in the query string will be ignored.
+      #  This parameter can be used only when the +q+ query string parameter is specified.
+      # @option arguments [String] :preference The node or shard the operation should be performed on.
+      #  It is random by default.
+      # @option arguments [String] :routing A custom value used to route operations to a specific shard.
+      # @option arguments [Boolean, String, Array<String>] :_source +True+ or +false+ to return the +_source+ field or not or a list of fields to return.
+      # @option arguments [String, Array<String>] :_source_excludes A comma-separated list of source fields to exclude from the response.
+      #  You can also use this parameter to exclude fields from the subset specified in +_source_includes+ query parameter.
+      #  If the +_source+ parameter is +false+, this parameter is ignored.
+      # @option arguments [String, Array<String>] :_source_includes A comma-separated list of source fields to include in the response.
+      #  If this parameter is specified, only these source fields are returned.
+      #  You can exclude fields from this subset using the +_source_excludes+ query parameter.
+      #  If the +_source+ parameter is +false+, this parameter is ignored.
+      # @option arguments [String, Array<String>] :stored_fields A comma-separated list of stored fields to return in the response.
+      # @option arguments [String] :q The query in the Lucene query string syntax.
       # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body The query definition using the Query DSL
+      # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/search-explain.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-explain
       #
       def explain(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'explain' }
 
-        defined_params = %i[index id].each_with_object({}) do |variable, set_variables|
+        defined_params = [:index, :id].each_with_object({}) do |variable, set_variables|
           set_variables[variable] = arguments[variable] if arguments.key?(variable)
         end
         request_opts[:defined_params] = defined_params unless defined_params.empty?
@@ -68,7 +82,7 @@ module Elasticsearch
                    Elasticsearch::API::HTTP_GET
                  end
 
-        path = "#{Utils.__listify(_index)}/_explain/#{Utils.__listify(_id)}"
+        path   = "#{Utils.listify(_index)}/_explain/#{Utils.listify(_id)}"
         params = Utils.process_params(arguments)
 
         Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/features/get_features.rb

@@ -15,19 +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 Features
       module Actions
-        # Gets a list of features which can be included in snapshots using the feature_states field when creating a snapshot
+        # Get the features.
+        # Get a list of features that can be included in snapshots using the +feature_states+ field when creating a snapshot.
+        # You can use this API to determine which feature states to include when taking a snapshot.
+        # By default, all feature states are included in a snapshot if that snapshot includes the global state, or none if it does not.
+        # A feature state includes one or more system indices necessary for a given feature to function.
+        # In order to ensure data integrity, all system indices that comprise a feature state are snapshotted and restored together.
+        # The features listed by this API are a combination of built-in features and features defined by plugins.
+        # In order for a feature state to be listed in this API and recognized as a valid feature state by the create snapshot API, the plugin that defines that feature must be installed on the master node.
         #
-        # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
+        # @option arguments [Time] :master_timeout Period to wait for a connection to the master node. Server default: 30s.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-features-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-features-get-features
         #
         def get_features(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'features.get_features' }
@@ -35,7 +42,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_features'

data/lib/elasticsearch/api/actions/features/reset_features.rb

@@ -15,23 +15,33 @@
 # 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 Features
       module Actions
-        # Resets the internal state of features, usually by deleting system indices
+        # Reset the features.
+        # Clear all of the state information stored in system indices by Elasticsearch features, including the security and machine learning indices.
+        # WARNING: Intended for development and testing use only. Do not reset features on a production cluster.
+        # Return a cluster to the same state as a new installation by resetting the feature state for all Elasticsearch features.
+        # This deletes all state information stored in system indices.
+        # The response code is HTTP 200 if the state is successfully reset for all features.
+        # It is HTTP 500 if the reset operation failed for any feature.
+        # Note that select features might provide a way to reset particular system indices.
+        # Using this API resets all features, both those that are built-in and implemented as plugins.
+        # To list the features that will be affected, use the get features API.
+        # IMPORTANT: The features installed on the node you submit this request to are the features that will be reset. Run on the master node if you have any doubts about which plugins are installed on individual nodes.
         # 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 Explicit operation timeout for connection to master node
+        # @option arguments [Time] :master_timeout Period to wait for a connection to the master node. Server default: 30s.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/modules-snapshots.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-features-reset-features
         #
         def reset_features(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'features.reset_features' }
@@ -39,7 +49,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_features/_reset'

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

@@ -15,27 +15,35 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Actions
-      # Returns the information about the capabilities of fields among multiple indices.
+      # Get the field capabilities.
+      # Get information about the capabilities of fields among multiple indices.
+      # For data streams, the API returns field capabilities among the stream’s backing indices.
+      # It returns runtime fields like any other field.
+      # For example, a runtime field with a type of keyword is returned the same as any other field that belongs to the +keyword+ family.
       #
-      # @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] :fields A comma-separated list of field names
-      # @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] :include_unmapped Indicates whether unmapped fields should be included in the response.
-      # @option arguments [List] :filters An optional set of filters: can include +metadata,-metadata,-nested,-multifield,-parent
-      # @option arguments [List] :types Only return results for fields that have one of the types in the list
-      # @option arguments [Boolean] :include_empty_fields Include empty fields in result
+      # @option arguments [String, Array] :index A 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. 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 The 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 [String, Array<String>] :fields A comma-separated list of fields to retrieve capabilities for. Wildcard (+*+) expressions are supported.
+      # @option arguments [Boolean] :ignore_unavailable If +true+, missing or closed indices are not included in the response.
+      # @option arguments [Boolean] :include_unmapped If true, unmapped fields are included in the response.
+      # @option arguments [String] :filters A comma-separated list of filters to apply to the response.
+      # @option arguments [Array<String>] :types A comma-separated list of field types to include.
+      #  Any fields that do not match one of these types will be excluded from the results.
+      #  It defaults to empty, meaning that all field types are returned.
+      # @option arguments [Boolean] :include_empty_fields If false, empty fields are not included in the response. Server default: true.
       # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body An index filter specified with the Query DSL
+      # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/search-field-caps.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-field-caps
       #
       def field_caps(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'field_caps' }
@@ -58,11 +66,11 @@ module Elasticsearch
                    Elasticsearch::API::HTTP_GET
                  end
 
-        path = if _index
-                 "#{Utils.__listify(_index)}/_field_caps"
-               else
-                 '_field_caps'
-               end
+        path   = if _index
+                   "#{Utils.listify(_index)}/_field_caps"
+                 else
+                   '_field_caps'
+                 end
         params = Utils.process_params(arguments)
 
         Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/fleet/global_checkpoints.rb

@@ -15,23 +15,29 @@
 # 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 Fleet
       module Actions
-        # Returns the current global checkpoints for an index. This API is design for internal use by the fleet server project.
+        # Get global checkpoints.
+        # Get the current global checkpoints for an index.
+        # This API is designed for internal use by the Fleet server project.
         #
-        # @option arguments [String] :index The name of the index.
-        # @option arguments [Boolean] :wait_for_advance Whether to wait for the global checkpoint to advance past the specified current checkpoints
-        # @option arguments [Boolean] :wait_for_index Whether to wait for the target index to exist and all primary shards be active
-        # @option arguments [List] :checkpoints Comma separated list of checkpoints
-        # @option arguments [Time] :timeout Timeout to wait for global checkpoint to advance
+        # @option arguments [Indexname, Indexalias] :index A single index or index alias that resolves to a single index. (*Required*)
+        # @option arguments [Boolean] :wait_for_advance A boolean value which controls whether to wait (until the timeout) for the global checkpoints
+        #  to advance past the provided +checkpoints+.
+        # @option arguments [Boolean] :wait_for_index A boolean value which controls whether to wait (until the timeout) for the target index to exist
+        #  and all primary shards be active. Can only be true when +wait_for_advance+ is true.
+        # @option arguments [Array<Integer>] :checkpoints A comma separated list of previous global checkpoints. When used in combination with +wait_for_advance+,
+        #  the API will only return once the global checkpoints advances past the checkpoints. Providing an empty list
+        #  will cause Elasticsearch to immediately return the current global checkpoints. Server default: [].
+        # @option arguments [Time] :timeout Period to wait for a global checkpoints to advance past +checkpoints+. Server default: 30s.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-global-checkpoints.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/group/endpoint-fleet
         #
         def global_checkpoints(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'fleet.global_checkpoints' }
@@ -46,12 +52,12 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           _index = arguments.delete(:index)
 
           method = Elasticsearch::API::HTTP_GET
-          path   = "#{Utils.__listify(_index)}/_fleet/global_checkpoints"
+          path   = "#{Utils.listify(_index)}/_fleet/global_checkpoints"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(