elasticsearch-api 8.17.2 → 9.0.0

data/lib/elasticsearch/api/actions/migration/post_feature_upgrade.rb

@@ -15,18 +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 Migration
       module Actions
-        # Begin upgrades for system features
+        # Start the feature migration.
+        # Version upgrades sometimes require changes to how features store configuration information and data in system indices.
+        # This API starts the automatic migration process.
+        # Some functionality might be temporarily unavailable during the migration process.
+        # TIP: The API is designed for indirect use by the Upgrade Assistant. We strongly recommend you use the Upgrade Assistant.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/migration-api-feature-upgrade.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-migration-get-feature-upgrade-status
         #
         def post_feature_upgrade(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'migration.post_feature_upgrade' }
@@ -34,7 +38,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_migration/system_features'

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

@@ -15,26 +15,50 @@
 # 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
-      # Allows to execute several search operations in one request.
+      # Run multiple searches.
+      # The format of the request is similar to the bulk API format and makes use of the newline delimited JSON (NDJSON) format.
+      # The structure is as follows:
+      # +
+      # header\n
+      # body\n
+      # header\n
+      # body\n
+      # +
+      # This structure is specifically optimized to reduce parsing if a specific search ends up redirected to another node.
+      # IMPORTANT: The final line of data must end with a newline character +\n+.
+      # Each newline character may be preceded by a carriage return +\r+.
+      # When sending requests to this endpoint the +Content-Type+ header should be set to +application/x-ndjson+.
       #
-      # @option arguments [List] :index A comma-separated list of index names to use as default
-      # @option arguments [String] :search_type Search operation type (options: query_then_fetch, dfs_query_then_fetch)
-      # @option arguments [Number] :max_concurrent_searches Controls the maximum number of concurrent searches the multi search api will execute
-      # @option arguments [Boolean] :typed_keys Specify whether aggregation and suggester names should be prefixed by their respective types in the response
-      # @option arguments [Number] :pre_filter_shard_size A threshold that enforces a pre-filter roundtrip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter roundtrip can limit the number of shards significantly if for instance a shard can not match any documents based on its rewrite method ie. if date filters are mandatory to match but the shard bounds and the query are disjoint.
-      # @option arguments [Number] :max_concurrent_shard_requests The number of concurrent shard requests each sub search executes concurrently per node. This value should be used to limit the impact of the search on the cluster in order to limit the number of concurrent shard requests
-      # @option arguments [Boolean] :rest_total_hits_as_int Indicates whether hits.total should be rendered as an integer or an object in the rest search response
-      # @option arguments [Boolean] :ccs_minimize_roundtrips Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution
+      # @option arguments [String, Array] :index Comma-separated list of data streams, indices, and index aliases to search.
+      # @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.
+      # @option arguments [Boolean] :ccs_minimize_roundtrips If true, network roundtrips between the coordinating node and remote clusters are minimized for cross-cluster search requests. Server default: true.
+      # @option arguments [String, Array<String>] :expand_wildcards Type of index that wildcard expressions can match. If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.
+      # @option arguments [Boolean] :ignore_throttled If true, concrete, expanded or aliased indices are ignored when frozen.
+      # @option arguments [Boolean] :ignore_unavailable If true, missing or closed indices are not included in the response.
+      # @option arguments [Boolean] :include_named_queries_score Indicates whether hit.matched_queries should be rendered as a map that includes
+      #  the name of the matched query associated with its score (true)
+      #  or as an array containing the name of the matched queries (false)
+      #  This functionality reruns each named query on every hit in a search response.
+      #  Typically, this adds a small overhead to a request.
+      #  However, using computationally expensive named queries on a large number of hits may add significant overhead.
+      # @option arguments [Integer] :max_concurrent_searches Maximum number of concurrent searches the multi search API can execute.
+      #  Defaults to +max(1, (# of data nodes * min(search thread pool size, 10)))+.
+      # @option arguments [Integer] :max_concurrent_shard_requests Maximum number of concurrent shard requests that each sub-search request executes per node. Server default: 5.
+      # @option arguments [Integer] :pre_filter_shard_size Defines a threshold that enforces a pre-filter roundtrip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter roundtrip can limit the number of shards significantly if for instance a shard can not match any documents based on its rewrite method i.e., if date filters are mandatory to match but the shard bounds and the query are disjoint.
+      # @option arguments [Boolean] :rest_total_hits_as_int If true, hits.total are returned as an integer in the response. Defaults to false, which returns an object.
+      # @option arguments [String] :routing Custom routing value used to route search operations to a specific shard.
+      # @option arguments [String] :search_type Indicates whether global term and document frequencies should be used when scoring returned documents.
+      # @option arguments [Boolean] :typed_keys Specifies whether aggregation and suggester names should be prefixed by their respective types in the response.
       # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body The request definitions (metadata-search request definition pairs), separated by newlines (*Required*)
+      # @option arguments [Hash] :body searches
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/search-multi-search.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-msearch
       #
       def msearch(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'msearch' }
@@ -49,19 +73,19 @@ module Elasticsearch
         arguments = arguments.clone
         headers = arguments.delete(:headers) || {}
 
-        body   = arguments.delete(:body)
+        body = arguments.delete(:body)
 
         _index = arguments.delete(:index)
 
         method = Elasticsearch::API::HTTP_POST
         path   = if _index
-                   "#{Utils.__listify(_index)}/_msearch"
+                   "#{Utils.listify(_index)}/_msearch"
                  else
                    '_msearch'
                  end
         params = Utils.process_params(arguments)
 
-        if body.is_a?(Array) && body.any? { |d| d.has_key? :search }
+        if body.is_a?(Array) && body.any? { |d| d.key? :search }
           payload = body.each_with_object([]) do |item, sum|
             meta = item
             data = meta.delete(:search)

data/lib/elasticsearch/api/actions/msearch_template.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 Actions
-      # Allows to execute several search template operations in one request.
+      # Run multiple templated searches.
+      # Run multiple templated searches with a single request.
+      # If you are providing a text file or text input to +curl+, use the +--data-binary+ flag instead of +-d+ to preserve newlines.
+      # For example:
+      # +
+      # $ cat requests
+      # { "index": "my-index" }
+      # { "id": "my-search-template", "params": { "query_string": "hello world", "from": 0, "size": 10 }}
+      # { "index": "my-other-index" }
+      # { "id": "my-other-search-template", "params": { "query_type": "match_all" }}
+      # $ curl -H "Content-Type: application/x-ndjson" -XGET localhost:9200/_msearch/template --data-binary "@requests"; echo
+      # +
       #
-      # @option arguments [List] :index A comma-separated list of index names to use as default
-      # @option arguments [String] :search_type Search operation type (options: query_then_fetch, dfs_query_then_fetch)
-      # @option arguments [Boolean] :typed_keys Specify whether aggregation and suggester names should be prefixed by their respective types in the response
-      # @option arguments [Number] :max_concurrent_searches Controls the maximum number of concurrent searches the multi search api will execute
-      # @option arguments [Boolean] :rest_total_hits_as_int Indicates whether hits.total should be rendered as an integer or an object in the rest search response
-      # @option arguments [Boolean] :ccs_minimize_roundtrips Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution
+      # @option arguments [String, Array] :index A comma-separated list of data streams, indices, and aliases to search.
+      #  It supports wildcards (+*+).
+      #  To search all data streams and indices, omit this parameter or use +*+.
+      # @option arguments [Boolean] :ccs_minimize_roundtrips If +true+, network round-trips are minimized for cross-cluster search requests. Server default: true.
+      # @option arguments [Integer] :max_concurrent_searches The maximum number of concurrent searches the API can run.
+      # @option arguments [String] :search_type The type of the search operation.
+      # @option arguments [Boolean] :rest_total_hits_as_int If +true+, the response returns +hits.total+ as an integer.
+      #  If +false+, it returns +hits.total+ as an object.
+      # @option arguments [Boolean] :typed_keys If +true+, the response prefixes aggregation and suggester names with their respective types.
       # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body The request definitions (metadata-search request definition pairs), separated by newlines (*Required*)
+      # @option arguments [Hash] :body search_templates
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/search-multi-search.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-msearch-template
       #
       def msearch_template(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'msearch_template' }
@@ -47,13 +61,13 @@ module Elasticsearch
         arguments = arguments.clone
         headers = arguments.delete(:headers) || {}
 
-        body   = arguments.delete(:body)
+        body = arguments.delete(:body)
 
         _index = arguments.delete(:index)
 
         method = Elasticsearch::API::HTTP_POST
         path   = if _index
-                   "#{Utils.__listify(_index)}/_msearch/template"
+                   "#{Utils.listify(_index)}/_msearch/template"
                  else
                    '_msearch/template'
                  end

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

@@ -15,31 +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 Actions
-      # Returns multiple termvectors in one request.
+      # Get multiple term vectors.
+      # Get multiple term vectors with a single request.
+      # You can specify existing documents by index and ID or provide artificial documents in the body of the request.
+      # You can specify the index in the request body or request URI.
+      # The response contains a +docs+ array with all the fetched termvectors.
+      # Each element has the structure provided by the termvectors API.
+      # **Artificial documents**
+      # You can also use +mtermvectors+ to generate term vectors for artificial documents provided in the body of the request.
+      # The mapping used is determined by the specified +_index+.
       #
-      # @option arguments [String] :index The index in which the document resides.
-      # @option arguments [List] :ids A comma-separated list of documents ids. You must define ids as parameter or set "ids" or "docs" in the request body
-      # @option arguments [Boolean] :term_statistics Specifies if total term frequency and document frequency should be returned. Applies to all returned documents unless otherwise specified in body "params" or "docs".
-      # @option arguments [Boolean] :field_statistics Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned. Applies to all returned documents unless otherwise specified in body "params" or "docs".
-      # @option arguments [List] :fields A comma-separated list of fields to return. Applies to all returned documents unless otherwise specified in body "params" or "docs".
-      # @option arguments [Boolean] :offsets Specifies if term offsets should be returned. Applies to all returned documents unless otherwise specified in body "params" or "docs".
-      # @option arguments [Boolean] :positions Specifies if term positions should be returned. Applies to all returned documents unless otherwise specified in body "params" or "docs".
-      # @option arguments [Boolean] :payloads Specifies if term payloads should be returned. Applies to all returned documents unless otherwise specified in body "params" or "docs".
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on (default: random) .Applies to all returned documents unless otherwise specified in body "params" or "docs".
-      # @option arguments [String] :routing Specific routing value. Applies to all returned documents unless otherwise specified in body "params" or "docs".
-      # @option arguments [Boolean] :realtime Specifies if requests are real-time as opposed to near-real-time (default: true).
-      # @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] :index The name of the index that contains the documents.
+      # @option arguments [Array<String>] :ids A comma-separated list of documents ids. You must define ids as parameter or set "ids" or "docs" in the request body
+      # @option arguments [String, Array<String>] :fields A comma-separated list or wildcard expressions of fields to include in the statistics.
+      #  It is used as the default list unless a specific field list is provided in the +completion_fields+ or +fielddata_fields+ parameters.
+      # @option arguments [Boolean] :field_statistics If +true+, the response includes the document count, sum of document frequencies, and sum of total term frequencies. Server default: true.
+      # @option arguments [Boolean] :offsets If +true+, the response includes term offsets. Server default: true.
+      # @option arguments [Boolean] :payloads If +true+, the response includes term payloads. Server default: true.
+      # @option arguments [Boolean] :positions If +true+, the response includes term positions. Server default: true.
+      # @option arguments [String] :preference The node or shard the operation should be performed on.
+      #  It is random by default.
+      # @option arguments [Boolean] :realtime If true, the request is real-time as opposed to near-real-time. Server default: true.
+      # @option arguments [String] :routing A custom value used to route operations to a specific shard.
+      # @option arguments [Boolean] :term_statistics If true, the response includes term frequency and document frequency.
+      # @option arguments [Integer] :version If +true+, returns the document version as part of a hit.
+      # @option arguments [String] :version_type The version type.
       # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body Define ids, documents, parameters or a list of parameters per document here. You must at least provide a list of document ids. See documentation.
+      # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/docs-multi-termvectors.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-mtermvectors
       #
       def mtermvectors(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'mtermvectors' }
@@ -52,11 +62,7 @@ module Elasticsearch
         arguments = arguments.clone
         headers = arguments.delete(:headers) || {}
 
-        body = if (ids = arguments.delete(:ids))
-                 { ids: ids }
-               else
-                 arguments.delete(:body)
-               end
+        body = arguments.delete(:body)
 
         _index = arguments.delete(:index)
 
@@ -66,11 +72,11 @@ module Elasticsearch
                    Elasticsearch::API::HTTP_GET
                  end
 
-        path = if _index
-                 "#{Utils.__listify(_index)}/_mtermvectors"
-               else
-                 '_mtermvectors'
-               end
+        path   = if _index
+                   "#{Utils.listify(_index)}/_mtermvectors"
+                 else
+                   '_mtermvectors'
+                 end
         params = Utils.process_params(arguments)
 
         Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/nodes/clear_repositories_metering_archive.rb

@@ -15,35 +15,40 @@
 # 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 Nodes
       module Actions
-        # Removes the archived repositories metering information present in the cluster.
+        # Clear the archived repositories metering.
+        # Clear the archived repositories metering information in the cluster.
         # This functionality is Experimental and may be changed or removed
         # completely in a future release. Elastic will take a best effort approach
         # to fix any issues, but experimental features are not subject to the
         # support SLA of official GA features.
         #
-        # @option arguments [List] :node_id Comma-separated list of node IDs or names used to limit returned information.
-        # @option arguments [Long] :max_archive_version Specifies the maximum archive_version to be cleared from the archive.
+        # @option arguments [String, Array] :node_id Comma-separated list of node IDs or names used to limit returned information. (*Required*)
+        # @option arguments [Integer] :max_archive_version Specifies the maximum +archive_version+ to be cleared from the archive. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/clear-repositories-metering-archive-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-nodes-clear-repositories-metering-archive
         #
         def clear_repositories_metering_archive(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'nodes.clear_repositories_metering_archive' }
 
-          defined_params = %i[node_id max_archive_version].each_with_object({}) do |variable, set_variables|
+          defined_params = [:node_id, :max_archive_version].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 'node_id' missing" unless arguments[:node_id]
-          raise ArgumentError, "Required argument 'max_archive_version' missing" unless arguments[:max_archive_version]
+
+          unless arguments[:max_archive_version]
+            raise ArgumentError,
+                  "Required argument 'max_archive_version' missing"
+          end
 
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
@@ -55,7 +60,7 @@ module Elasticsearch
           _max_archive_version = arguments.delete(:max_archive_version)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_nodes/#{Utils.__listify(_node_id)}/_repositories_metering/#{Utils.__listify(_max_archive_version)}"
+          path   = "_nodes/#{Utils.listify(_node_id)}/_repositories_metering/#{Utils.listify(_max_archive_version)}"
           params = {}
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/nodes/get_repositories_metering_info.rb

@@ -15,23 +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 Nodes
       module Actions
-        # Returns cluster repositories metering information.
+        # Get cluster repositories metering.
+        # Get repositories metering information for a cluster.
+        # This API exposes monotonically non-decreasing counters and it is expected that clients would durably store the information needed to compute aggregations over a period of time.
+        # Additionally, the information exposed by this API is volatile, meaning that it will not be present after node restarts.
         # 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 [List] :node_id A comma-separated list of node IDs or names to limit the returned information.
+        # @option arguments [String, Array] :node_id Comma-separated list of node IDs or names used to limit returned information. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-repositories-metering-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-nodes-get-repositories-metering-info
         #
         def get_repositories_metering_info(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'nodes.get_repositories_metering_info' }
@@ -51,7 +54,7 @@ module Elasticsearch
           _node_id = arguments.delete(:node_id)
 
           method = Elasticsearch::API::HTTP_GET
-          path   = "_nodes/#{Utils.__listify(_node_id)}/_repositories_metering"
+          path   = "_nodes/#{Utils.listify(_node_id)}/_repositories_metering"
           params = {}
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/nodes/hot_threads.rb

@@ -15,26 +15,30 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Nodes
       module Actions
-        # Returns information about hot threads on each node in the cluster.
+        # Get the hot threads for nodes.
+        # Get a breakdown of the hot threads on each selected node in the cluster.
+        # The output is plain text with a breakdown of the top hot threads for each node.
         #
-        # @option arguments [List] :node_id A comma-separated list of node IDs or names to limit the returned information; use `_local` to return information from the node you're connecting to, leave empty to get information from all nodes
-        # @option arguments [Time] :interval The interval for the second sampling of threads
-        # @option arguments [Number] :snapshots Number of samples of thread stacktrace (default: 10)
-        # @option arguments [Number] :threads Specify the number of threads to provide information for (default: 3)
-        # @option arguments [Boolean] :ignore_idle_threads Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue (default: true)
-        # @option arguments [String] :type The type to sample (default: cpu) (options: cpu, wait, block, mem)
-        # @option arguments [String] :sort The sort order for 'cpu' type (default: total) (options: cpu, total)
-        # @option arguments [Time] :timeout Explicit operation timeout
+        # @option arguments [String, Array] :node_id List of node IDs or names used to limit returned information.
+        # @option arguments [Boolean] :ignore_idle_threads If true, known idle threads (e.g. waiting in a socket select, or to get
+        #  a task from an empty queue) are filtered out. Server default: true.
+        # @option arguments [Time] :interval The interval to do the second sampling of threads. Server default: 500ms.
+        # @option arguments [Integer] :snapshots Number of samples of thread stacktrace. Server default: 10.
+        # @option arguments [Integer] :threads Specifies the number of hot threads to provide information for. Server default: 3.
+        # @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 [String] :type The type to sample. Server default: cpu.
+        # @option arguments [String] :sort The sort order for 'cpu' type (default: total)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/cluster-nodes-hot-threads.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-nodes-hot-threads
         #
         def hot_threads(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'nodes.hot_threads' }
@@ -53,7 +57,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _node_id
-                     "_nodes/#{Utils.__listify(_node_id)}/hot_threads"
+                     "_nodes/#{Utils.listify(_node_id)}/hot_threads"
                    else
                      '_nodes/hot_threads'
                    end

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

@@ -15,27 +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 Nodes
       module Actions
-        # Returns information about nodes in the cluster.
+        # Get node information.
+        # By default, the API returns all attributes and core settings for cluster nodes.
         #
-        # @option arguments [List] :node_id A comma-separated list of node IDs or names to limit the returned information; use `_local` to return information from the node you're connecting to, leave empty to get information from all nodes
-        # @option arguments [List] :metric A comma-separated list of metrics you wish returned. Use `_all` to retrieve all metrics and `_none` to retrieve the node identity without any additional metrics. (options: settings, os, process, jvm, thread_pool, transport, http, plugins, ingest, indices, aggregations, _all, _none)
-        # @option arguments [Boolean] :flat_settings Return settings in flat format (default: false)
-        # @option arguments [Time] :timeout Explicit operation timeout
+        # @option arguments [String, Array] :node_id Comma-separated list of node IDs or names used to limit returned information.
+        # @option arguments [String, Array<String>] :metric Limits the information returned to the specific metrics. Supports a comma-separated list, such as http,ingest.
+        # @option arguments [Boolean] :flat_settings If true, returns settings in flat format.
+        # @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.17/cluster-nodes-info.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-nodes-info
         #
         def info(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'nodes.info' }
 
-          defined_params = %i[node_id metric].each_with_object({}) do |variable, set_variables|
+          defined_params = [:node_id, :metric].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?
@@ -51,11 +52,11 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _node_id && _metric
-                     "_nodes/#{Utils.__listify(_node_id)}/#{Utils.__listify(_metric)}"
+                     "_nodes/#{Utils.listify(_node_id)}/#{Utils.listify(_metric)}"
                    elsif _node_id
-                     "_nodes/#{Utils.__listify(_node_id)}"
+                     "_nodes/#{Utils.listify(_node_id)}"
                    elsif _metric
-                     "_nodes/#{Utils.__listify(_metric)}"
+                     "_nodes/#{Utils.listify(_metric)}"
                    else
                      '_nodes'
                    end

data/lib/elasticsearch/api/actions/nodes/reload_secure_settings.rb

@@ -15,21 +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 Nodes
       module Actions
-        # Reloads secure settings.
+        # Reload the keystore on nodes in the cluster.
+        # Secure settings are stored in an on-disk keystore. Certain of these settings are reloadable.
+        # That is, you can change them on disk and reload them without restarting any nodes in the cluster.
+        # When you have updated reloadable secure settings in your keystore, you can use this API to reload those settings on each node.
+        # When the Elasticsearch keystore is password protected and not simply obfuscated, you must provide the password for the keystore when you reload the secure settings.
+        # Reloading the settings for the whole cluster assumes that the keystores for all nodes are protected with the same password; this method is allowed only when inter-node communications are encrypted.
+        # Alternatively, you can reload the secure settings on each node by locally accessing the API and passing the node-specific Elasticsearch keystore password.
         #
-        # @option arguments [List] :node_id A comma-separated list of node IDs to span the reload/reinit call. Should stay empty because reloading usually involves all cluster nodes.
-        # @option arguments [Time] :timeout Explicit operation timeout
+        # @option arguments [String, Array] :node_id The names of particular nodes in the cluster to target.
+        # @option arguments [Time] :timeout Period to wait for a response.
+        #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body An object containing the password for the elasticsearch keystore
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/secure-settings.html#reloadable-secure-settings
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-nodes-reload-secure-settings
         #
         def reload_secure_settings(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'nodes.reload_secure_settings' }
@@ -48,7 +55,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_POST
           path   = if _node_id
-                     "_nodes/#{Utils.__listify(_node_id)}/reload_secure_settings"
+                     "_nodes/#{Utils.listify(_node_id)}/reload_secure_settings"
                    else
                      '_nodes/reload_secure_settings'
                    end