elasticsearch-api 8.19.3 → 9.0.0

data/lib/elasticsearch/api/actions/cat/transforms.rb

@@ -15,29 +15,37 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 589cd632d091bc0a512c46d5d81ac1f961b60127
-# @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 Cat
       module Actions
-        # Get transform information
+        # Get transform information.
+        # Get configuration and usage information about transforms.
+        # CAT APIs are only intended for human consumption using the Kibana
+        # console or command line. They are not intended for use by applications. For
+        # application consumption, use the get transform statistics API.
         #
-        # @option arguments [String] :transform_id The id of the transform for which to get stats. '_all' or '*' implies all transforms
-        # @option arguments [Integer] :from skips a number of transform configs, defaults to 0
-        # @option arguments [Integer] :size specifies a max number of transforms to get, defaults to 100
-        # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no transforms. (This includes `_all` string or when no transforms have been specified)
-        # @option arguments [String] :format a short version of the Accept header, e.g. json, yaml
-        # @option arguments [List] :h Comma-separated list of column names to display (options: changes_last_detection_time, checkpoint, checkpoint_duration_time_exp_avg, checkpoint_progress, create_time, delete_time, description, dest_index, documents_deleted, documents_indexed, docs_per_second, documents_processed, frequency, id, index_failure, index_time, index_total, indexed_documents_exp_avg, last_search_time, max_page_search_size, pages_processed, pipeline, processed_documents_exp_avg, processing_time, reason, search_failure, search_time, search_total, source_index, state, transform_type, trigger_count, version)
-        # @option arguments [Boolean] :help Return help information
-        # @option arguments [List] :s Comma-separated list of column names or column aliases to sort by (options: changes_last_detection_time, checkpoint, checkpoint_duration_time_exp_avg, checkpoint_progress, create_time, delete_time, description, dest_index, documents_deleted, documents_indexed, docs_per_second, documents_processed, frequency, id, index_failure, index_time, index_total, indexed_documents_exp_avg, last_search_time, max_page_search_size, pages_processed, pipeline, processed_documents_exp_avg, processing_time, reason, search_failure, search_time, search_total, source_index, state, transform_type, trigger_count, version)
-        # @option arguments [String] :time The unit in which to display time values (options: d, h, m, s, ms, micros, nanos)
-        # @option arguments [Boolean] :v Verbose mode. Display column headers
-        # @option arguments [String] :bytes The unit in which to display byte values (options: b, kb, mb, gb, tb, pb)
+        # @option arguments [String] :transform_id A transform identifier or a wildcard expression.
+        #  If you do not specify one of these options, the API returns information for all transforms.
+        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request: contains wildcard expressions and there are no transforms that match; contains the +_all+ string or no identifiers and there are no matches; contains wildcard expressions and there are only partial matches.
+        #  If +true+, it returns an empty transforms array when there are no matches and the subset of results when there are partial matches.
+        #  If +false+, the request returns a 404 status code when there are no matches or only partial matches. Server default: true.
+        # @option arguments [Integer] :from Skips the specified number of transforms. Server default: 0.
+        # @option arguments [String, Array<String>] :h Comma-separated list of column names to display. Server default: changes_last_detection_time,checkpoint,checkpoint_progress,documents_processed,id,last_search_time,state.
+        # @option arguments [String, Array<String>] :s Comma-separated list of column names or column aliases used to sort the response.
+        # @option arguments [String] :time The unit used to display time values.
+        # @option arguments [Integer] :size The maximum number of transforms to obtain. Server default: 100.
+        # @option arguments [String] :format Specifies the format to return the columnar data in, can be set to
+        #  +text+, +json+, +cbor+, +yaml+, or +smile+. Server default: text.
+        # @option arguments [Boolean] :help When set to +true+ will output available columns. This option
+        #  can't be combined with any other query string option.
+        # @option arguments [Boolean] :v When set to +true+ will enable verbose output.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/cat-transforms.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cat-transforms
         #
         def transforms(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cat.transforms' }
@@ -56,7 +64,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _transform_id
-                     "_cat/transforms/#{Utils.__listify(_transform_id)}"
+                     "_cat/transforms/#{Utils.listify(_transform_id)}"
                    else
                      '_cat/transforms'
                    end

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

@@ -15,33 +15,31 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 589cd632d091bc0a512c46d5d81ac1f961b60127
-# @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
-      # Clear a scrolling search
+      # Clear a scrolling search.
+      # Clear the search context and results for a scrolling search.
       #
-      # @option arguments [List] :scroll_id A comma-separated list of scroll IDs to clear *Deprecated*
+      # @option arguments [String, Array] :scroll_id A comma-separated list of scroll IDs to clear.
+      #  To clear all scroll IDs, use +_all+.
+      #  IMPORTANT: Scroll IDs can be long. It is recommended to specify scroll IDs in the request body parameter.
       # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body A comma-separated list of scroll IDs to clear if none was specified via the scroll_id parameter
+      # @option arguments [Hash] :body request body
       #
       # *Deprecation notice*:
       # A scroll id can be quite large and should be specified as part of the body
       # Deprecated since version 7.0.0
       #
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/clear-scroll-api.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-clear-scroll
       #
       def clear_scroll(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'clear_scroll' }
 
-        defined_params = [:scroll_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?
-
         arguments = arguments.clone
         headers = arguments.delete(:headers) || {}
 
@@ -50,15 +48,11 @@ module Elasticsearch
         _scroll_id = arguments.delete(:scroll_id)
 
         method = Elasticsearch::API::HTTP_DELETE
-        path   = if _scroll_id
-                   "_search/scroll/#{Utils.__listify(_scroll_id)}"
-                 else
-                   '_search/scroll'
-                 end
+        path   = '_search/scroll'
         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/close_point_in_time.rb

@@ -15,28 +15,30 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 589cd632d091bc0a512c46d5d81ac1f961b60127
-# @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
-      # Close a point in time
+      # Close a point in time.
+      # A point in time must be opened explicitly before being used in search requests.
+      # The +keep_alive+ parameter tells Elasticsearch how long it should persist.
+      # A point in time is automatically closed when the +keep_alive+ period has elapsed.
+      # However, keeping points in time has a cost; close them as soon as they are no longer required for search requests.
       #
       # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body a point-in-time id to close (*Required*)
+      # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/point-in-time-api.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-open-point-in-time
       #
       def close_point_in_time(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'close_point_in_time' }
 
-        raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
-
         arguments = arguments.clone
         headers = arguments.delete(:headers) || {}
 
-        body   = arguments.delete(:body)
+        body = arguments.delete(:body)
 
         method = Elasticsearch::API::HTTP_DELETE
         path   = '_pit'

data/lib/elasticsearch/api/actions/cluster/allocation_explain.rb

@@ -15,22 +15,26 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 589cd632d091bc0a512c46d5d81ac1f961b60127
-# @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 Cluster
       module Actions
-        # Explain the shard allocations
+        # Explain the shard allocations.
+        # Get explanations for shard allocations in the cluster.
+        # For unassigned shards, it provides an explanation for why the shard is unassigned.
+        # For assigned shards, it provides an explanation for why the shard is remaining on its current node and has not moved or rebalanced to another node.
+        # This API can be very useful when attempting to diagnose why a shard is unassigned or why a shard continues to remain on its current node when you might expect otherwise.
         #
-        # @option arguments [Time] :master_timeout Timeout for connection to master node
-        # @option arguments [Boolean] :include_yes_decisions Return 'YES' decisions in explanation (default: false)
-        # @option arguments [Boolean] :include_disk_info Return information about disk usage and shard sizes (default: false)
+        # @option arguments [Boolean] :include_disk_info If true, returns information about disk usage and shard sizes.
+        # @option arguments [Boolean] :include_yes_decisions If true, returns YES decisions in explanation.
+        # @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
-        # @option arguments [Hash] :body The index, shard, and primary flag to explain. Empty means 'explain a randomly-chosen unassigned shard'
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/cluster-allocation-explain.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-allocation-explain
         #
         def allocation_explain(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.allocation_explain' }
@@ -38,7 +42,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           method = if body
                      Elasticsearch::API::HTTP_POST
@@ -46,7 +50,7 @@ module Elasticsearch
                      Elasticsearch::API::HTTP_GET
                    end
 
-          path = '_cluster/allocation/explain'
+          path   = '_cluster/allocation/explain'
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/cluster/delete_component_template.rb

@@ -15,21 +15,24 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 589cd632d091bc0a512c46d5d81ac1f961b60127
-# @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 Cluster
       module Actions
-        # Delete component templates
+        # Delete component templates.
+        # Component templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.
         #
-        # @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 or wildcard expression of component template names used to limit the request. (*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-component-template.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-put-component-template
         #
         def delete_component_template(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.delete_component_template' }
@@ -49,7 +52,7 @@ module Elasticsearch
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_component_template/#{Utils.__listify(_name)}"
+          path   = "_component_template/#{Utils.listify(_name)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/cluster/delete_voting_config_exclusions.rb

@@ -15,20 +15,26 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 589cd632d091bc0a512c46d5d81ac1f961b60127
-# @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 Cluster
       module Actions
-        # Clear cluster voting config exclusions
+        # Clear cluster voting config exclusions.
+        # Remove master-eligible nodes from the voting configuration exclusion list.
         #
-        # @option arguments [Boolean] :wait_for_removal Specifies whether to wait for all excluded nodes to be removed from the cluster before clearing the voting configuration exclusions list.
-        # @option arguments [Time] :master_timeout Timeout for submitting request to master
+        # @option arguments [Time] :master_timeout Period to wait for a connection to the master node. Server default: 30s.
+        # @option arguments [Boolean] :wait_for_removal Specifies whether to wait for all excluded nodes to be removed from the
+        #  cluster before clearing the voting configuration exclusions list.
+        #  Defaults to true, meaning that all excluded nodes must be removed from
+        #  the cluster before this API takes any action. If set to false then the
+        #  voting configuration exclusions list is cleared even if some excluded
+        #  nodes are still in the cluster. Server default: true.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-cluster-post-voting-config-exclusions
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-post-voting-config-exclusions
         #
         def delete_voting_config_exclusions(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.delete_voting_config_exclusions' }
@@ -36,7 +42,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_DELETE
           path   = '_cluster/voting_config_exclusions'

data/lib/elasticsearch/api/actions/cluster/exists_component_template.rb

@@ -15,21 +15,26 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 589cd632d091bc0a512c46d5d81ac1f961b60127
-# @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 Cluster
       module Actions
-        # Check component templates
+        # Check component templates.
+        # Returns information about whether a particular component template exists.
         #
-        # @option arguments [String] :name The name of the template
-        # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
-        # @option arguments [Boolean] :local Return local information, do not retrieve the state from master node (default: false)
+        # @option arguments [String, Array<String>] :name Comma-separated list of component 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 [Boolean] :local If true, the request retrieves information from the local node only.
+        #  Defaults to false, which means information is retrieved from the master node.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-component-template.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-put-component-template
         #
         def exists_component_template(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.exists_component_template' }
@@ -49,7 +54,7 @@ module Elasticsearch
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_HEAD
-          path   = "_component_template/#{Utils.__listify(_name)}"
+          path   = "_component_template/#{Utils.listify(_name)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/cluster/get_component_template.rb

@@ -15,24 +15,27 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 589cd632d091bc0a512c46d5d81ac1f961b60127
-# @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 Cluster
       module Actions
-        # Get component templates
+        # Get component templates.
+        # Get information about component templates.
         #
-        # @option arguments [String] :name The name of the component template. Wildcard (`*`) expressions are supported.
-        # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
-        # @option arguments [Boolean] :local Return local information, do not retrieve the state from master node (default: false)
+        # @option arguments [String] :name Comma-separated list of component template names used to limit the request.
+        #  Wildcard (+*+) expressions are supported.
+        # @option arguments [Boolean] :flat_settings If +true+, returns settings in flat format.
         # @option arguments [Boolean] :include_defaults Return all default configurations for the component template (default: false)
-        # @option arguments [Boolean] :flat_settings Return settings in flat format (default: false)
-        # @option arguments [List] :settings_filter Filter out results, for example to filter out sensitive information. Supports wildcards or full settings keys
+        # @option arguments [Boolean] :local If +true+, the request retrieves information from the local node only.
+        #  If +false+, information is retrieved from the master node.
+        # @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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-component-template.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-put-component-template
         #
         def get_component_template(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.get_component_template' }
@@ -51,7 +54,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _name
-                     "_component_template/#{Utils.__listify(_name)}"
+                     "_component_template/#{Utils.listify(_name)}"
                    else
                      '_component_template'
                    end

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

@@ -15,22 +15,25 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 589cd632d091bc0a512c46d5d81ac1f961b60127
-# @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 Cluster
       module Actions
-        # Get cluster-wide settings
+        # Get cluster-wide settings.
+        # By default, it returns only settings that have been explicitly defined.
         #
-        # @option arguments [Boolean] :flat_settings Return settings in flat format (default: false)
-        # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [Boolean] :include_defaults Whether to return all default clusters setting.
+        # @option arguments [Boolean] :flat_settings If +true+, returns settings in flat format.
+        # @option arguments [Boolean] :include_defaults If +true+, returns default cluster settings from the local node.
+        # @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/cluster-get-settings.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-get-settings
         #
         def get_settings(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.get_settings' }
@@ -38,7 +41,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_cluster/settings'

data/lib/elasticsearch/api/actions/cluster/health.rb

@@ -15,30 +15,37 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 589cd632d091bc0a512c46d5d81ac1f961b60127
-# @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 Cluster
       module Actions
-        # Get the cluster health status
+        # Get the cluster health status.
+        # You can also use the API to get the health status of only specified data streams and indices.
+        # For data streams, the API retrieves the health status of the stream’s backing indices.
+        # The cluster health status is: green, yellow or red.
+        # On the shard level, a red status indicates that the specific shard is not allocated in the cluster. Yellow means that the primary shard is allocated but replicas are not. Green means that all shards are allocated.
+        # The index level status is controlled by the worst shard status.
+        # One of the main benefits of the API is the ability to wait until the cluster reaches a certain high watermark health level.
+        # The cluster status is controlled by the worst index status.
         #
-        # @option arguments [List] :index Limit the information returned to a specific index
-        # @option arguments [List] :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] :level Specify the level of detail for returned information (options: cluster, indices, shards)
-        # @option arguments [Boolean] :local Return local information, do not retrieve the state from master node (default: false)
-        # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [String] :wait_for_active_shards Wait until the specified number of shards is active
-        # @option arguments [String] :wait_for_nodes Wait until the specified number of nodes is available
-        # @option arguments [String] :wait_for_events Wait until all currently queued events with the given priority are processed (options: immediate, urgent, high, normal, low, languid)
-        # @option arguments [Boolean] :wait_for_no_relocating_shards Whether to wait until there are no relocating shards in the cluster
-        # @option arguments [Boolean] :wait_for_no_initializing_shards Whether to wait until there are no initializing shards in the cluster
-        # @option arguments [String] :wait_for_status Wait until cluster is in a specific state (options: green, yellow, red, unknown, unavailable)
+        # @option arguments [String, Array] :index Comma-separated list of data streams, indices, and index aliases used to limit the request. Wildcard expressions (+*+) are supported. To target all data streams and indices in a cluster, omit this parameter or use _all or +*+.
+        # @option arguments [String, Array<String>] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both.
+        # @option arguments [String] :level Can be one of cluster, indices or shards. Controls the details level of the health information returned. Server default: cluster.
+        # @option arguments [Boolean] :local If true, the request retrieves information from the local node only. Defaults to false, which means information is retrieved from the master node.
+        # @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 A number controlling to how many active shards to wait for, all to wait for all shards in the cluster to be active, or 0 to not wait. Server default: 0.
+        # @option arguments [String] :wait_for_events Can be one of immediate, urgent, high, normal, low, languid. Wait until all currently queued events with the given priority are processed.
+        # @option arguments [String, Integer] :wait_for_nodes The request waits until the specified number N of nodes is available. It also accepts >=N, <=N, >N and <N. Alternatively, it is possible to use ge(N), le(N), gt(N) and lt(N) notation.
+        # @option arguments [Boolean] :wait_for_no_initializing_shards A boolean value which controls whether to wait (until the timeout provided) for the cluster to have no shard initializations. Defaults to false, which means it will not wait for initializing shards.
+        # @option arguments [Boolean] :wait_for_no_relocating_shards A boolean value which controls whether to wait (until the timeout provided) for the cluster to have no shard relocations. Defaults to false, which means it will not wait for relocating shards.
+        # @option arguments [String] :wait_for_status One of green, yellow or red. Will wait (until the timeout provided) until the status of the cluster changes to the one provided or better, i.e. green > yellow > red. By default, will not wait for any status.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/cluster-health.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-health
         #
         def health(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.health' }
@@ -51,13 +58,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
-                     "_cluster/health/#{Utils.__listify(_index)}"
+                     "_cluster/health/#{Utils.listify(_index)}"
                    else
                      '_cluster/health'
                    end

data/lib/elasticsearch/api/actions/cluster/info.rb

@@ -15,19 +15,20 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 589cd632d091bc0a512c46d5d81ac1f961b60127
-# @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 Cluster
       module Actions
-        # Get cluster info
+        # Get cluster info.
+        # Returns basic information about the cluster.
         #
-        # @option arguments [List] :target Limit the information returned to the specified target. (options: _all, http, ingest, thread_pool, script)
+        # @option arguments [String, Array<String>] :target Limits the information returned to the specific target. Supports a comma-separated list, such as http,ingest. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/cluster-info.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-info
         #
         def info(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.info' }
@@ -47,7 +48,7 @@ module Elasticsearch
           _target = arguments.delete(:target)
 
           method = Elasticsearch::API::HTTP_GET
-          path   = "_info/#{Utils.__listify(_target)}"
+          path   = "_info/#{Utils.listify(_target)}"
           params = {}
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/cluster/pending_tasks.rb

@@ -15,20 +15,26 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 589cd632d091bc0a512c46d5d81ac1f961b60127
-# @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 Cluster
       module Actions
-        # Get the pending cluster tasks
+        # Get the pending cluster tasks.
+        # Get information about cluster-level changes (such as create index, update mapping, allocate or fail shard) that have not yet taken effect.
+        # NOTE: This API returns a list of any pending updates to the cluster state.
+        # These are distinct from the tasks reported by the task management API which include periodic tasks and tasks initiated by the user, such as node stats, search queries, or create index requests.
+        # However, if a user-initiated task such as a create index command causes a cluster state update, the activity of this task might be reported by both task api and pending cluster tasks API.
         #
-        # @option arguments [Boolean] :local Return local information, do not retrieve the state from master node (default: false)
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [Boolean] :local If +true+, the request retrieves information from the local node only.
+        #  If +false+, information is retrieved from the master node.
+        # @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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/cluster-pending.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-pending-tasks
         #
         def pending_tasks(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.pending_tasks' }
@@ -36,7 +42,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_cluster/pending_tasks'