elasticsearch-api 8.18.0 → 9.0.1

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

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

@@ -15,35 +15,37 @@
 # 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 statistical information about nodes in the cluster.
+        # Get node statistics.
+        # Get statistics for nodes in a cluster.
+        # By default, all stats are returned. You can limit the returned information by using metrics.
         #
-        # @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 Limit the information returned to the specified metrics (options: _all, breaker, fs, http, indices, jvm, os, process, thread_pool, transport, discovery, indexing_pressure)
-        # @option arguments [List] :index_metric Limit the information returned for `indices` metric to the specific index metrics. Isn't used if `indices` (or `all`) metric isn't specified. (options: _all, completion, docs, fielddata, query_cache, flush, get, indexing, merge, request_cache, refresh, search, segments, store, warmer, bulk, shard_stats)
-        # @option arguments [List] :completion_fields A comma-separated list of fields for the `completion` index metric (supports wildcards)
-        # @option arguments [List] :fielddata_fields A comma-separated list of fields for the `fielddata` index metric (supports wildcards)
-        # @option arguments [List] :fields A comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards)
-        # @option arguments [Boolean] :groups A comma-separated list of search groups for `search` index metric
-        # @option arguments [String] :level Return indices stats aggregated at index, node or shard level (options: indices, node, shards)
-        # @option arguments [List] :types A comma-separated list of document types for the `indexing` index metric
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [Boolean] :include_segment_file_sizes Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)
-        # @option arguments [Boolean] :include_unloaded_segments If set to true segment stats will include stats for segments that are not currently loaded into memory
+        # @option arguments [String, Array] :node_id Comma-separated list of node IDs or names used to limit returned information.
+        # @option arguments [String, Array<String>] :metric Limit the information returned to the specified metrics
+        # @option arguments [String, Array<String>] :index_metric Limit the information returned for indices metric to the specific index metrics. It can be used only if indices (or all) metric is specified.
+        # @option arguments [String, Array<String>] :completion_fields Comma-separated list or wildcard expressions of fields to include in fielddata and suggest statistics.
+        # @option arguments [String, Array<String>] :fielddata_fields Comma-separated list or wildcard expressions of fields to include in fielddata statistics.
+        # @option arguments [String, Array<String>] :fields Comma-separated list or wildcard expressions of fields to include in the statistics.
+        # @option arguments [Boolean] :groups Comma-separated list of search groups to include in the search statistics.
+        # @option arguments [Boolean] :include_segment_file_sizes If true, the call reports the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).
+        # @option arguments [String] :level Indicates whether statistics are aggregated at the cluster, index, or shard level.
+        # @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 [Array<String>] :types A comma-separated list of document types for the indexing index metric.
+        # @option arguments [Boolean] :include_unloaded_segments If +true+, the response includes information from segments that are not loaded into memory.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/cluster-nodes-stats.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-nodes-stats
         #
         def stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'nodes.stats' }
 
-          defined_params = %i[node_id metric index_metric].each_with_object({}) do |variable, set_variables|
+          defined_params = [:node_id, :metric, :index_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?
@@ -61,15 +63,15 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _node_id && _metric && _index_metric
-                     "_nodes/#{Utils.__listify(_node_id)}/stats/#{Utils.__listify(_metric)}/#{Utils.__listify(_index_metric)}"
+                     "_nodes/#{Utils.listify(_node_id)}/stats/#{Utils.listify(_metric)}/#{Utils.listify(_index_metric)}"
                    elsif _metric && _index_metric
-                     "_nodes/stats/#{Utils.__listify(_metric)}/#{Utils.__listify(_index_metric)}"
+                     "_nodes/stats/#{Utils.listify(_metric)}/#{Utils.listify(_index_metric)}"
                    elsif _node_id && _metric
-                     "_nodes/#{Utils.__listify(_node_id)}/stats/#{Utils.__listify(_metric)}"
+                     "_nodes/#{Utils.listify(_node_id)}/stats/#{Utils.listify(_metric)}"
                    elsif _node_id
-                     "_nodes/#{Utils.__listify(_node_id)}/stats"
+                     "_nodes/#{Utils.listify(_node_id)}/stats"
                    elsif _metric
-                     "_nodes/stats/#{Utils.__listify(_metric)}"
+                     "_nodes/stats/#{Utils.listify(_metric)}"
                    else
                      '_nodes/stats'
                    end

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

@@ -15,26 +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 low-level information about REST actions usage on nodes.
+        # Get feature usage information.
         #
-        # @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 Limit the information returned to the specified metrics (options: _all, rest_actions)
-        # @option arguments [Time] :timeout Explicit operation timeout
+        # @option arguments [String, Array] :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 [String, Array<String>] :metric Limits the information returned to the specific metrics.
+        #  A comma-separated list of the following options: +_all+, +rest_actions+.
+        # @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-usage.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-nodes-usage
         #
         def usage(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'nodes.usage' }
 
-          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?
@@ -50,11 +52,11 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _node_id && _metric
-                     "_nodes/#{Utils.__listify(_node_id)}/usage/#{Utils.__listify(_metric)}"
+                     "_nodes/#{Utils.listify(_node_id)}/usage/#{Utils.listify(_metric)}"
                    elsif _node_id
-                     "_nodes/#{Utils.__listify(_node_id)}/usage"
+                     "_nodes/#{Utils.listify(_node_id)}/usage"
                    elsif _metric
-                     "_nodes/usage/#{Utils.__listify(_metric)}"
+                     "_nodes/usage/#{Utils.listify(_metric)}"
                    else
                      '_nodes/usage'
                    end

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

@@ -15,25 +15,56 @@
 # 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
-      # Open a point in time that can be used in subsequent searches
+      # Open a point in time.
+      # A search request by default runs against the most recent visible data of the target indices,
+      # which is called point in time. Elasticsearch pit (point in time) is a lightweight view into the
+      # state of the data as it existed when initiated. In some cases, it’s preferred to perform multiple
+      # search requests using the same point in time. For example, if refreshes happen between
+      # +search_after+ requests, then the results of those requests might not be consistent as changes happening
+      # between searches are only visible to the more recent point in time.
+      # A point in time must be opened explicitly before being used in search requests.
+      # A subsequent search request with the +pit+ parameter must not specify +index+, +routing+, or +preference+ values as these parameters are copied from the point in time.
+      # Just like regular searches, you can use +from+ and +size+ to page through point in time search results, up to the first 10,000 hits.
+      # If you want to retrieve more hits, use PIT with +search_after+.
+      # IMPORTANT: The open point in time request and each subsequent search request can return different identifiers; always use the most recently received ID for the next search request.
+      # When a PIT that contains shard failures is used in a search request, the missing are always reported in the search response as a +NoShardAvailableActionException+ exception.
+      # To get rid of these exceptions, a new PIT needs to be created so that shards missing from the previous PIT can be handled, assuming they become available in the meantime.
+      # **Keeping point in time alive**
+      # The +keep_alive+ parameter, which is passed to a open point in time request and search request, extends the time to live of the corresponding point in time.
+      # The value does not need to be long enough to process all data — it just needs to be long enough for the next request.
+      # Normally, the background merge process optimizes the index by merging together smaller segments to create new, bigger segments.
+      # Once the smaller segments are no longer needed they are deleted.
+      # However, open point-in-times prevent the old segments from being deleted since they are still in use.
+      # TIP: Keeping older segments alive means that more disk space and file handles are needed.
+      # Ensure that you have configured your nodes to have ample free file handles.
+      # Additionally, if a segment contains deleted or updated documents then the point in time must keep track of whether each document in the segment was live at the time of the initial search request.
+      # Ensure that your nodes have sufficient heap space if you have many open point-in-times on an index that is subject to ongoing deletes or updates.
+      # Note that a point-in-time doesn't prevent its associated indices from being deleted.
+      # You can check how many point-in-times (that is, search contexts) are open with the nodes stats API.
       #
-      # @option arguments [List] :index A comma-separated list of index names to open point in time; use `_all` or empty string to perform the operation on all indices
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on (default: random)
-      # @option arguments [String] :routing Specific routing value
-      # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when unavailable (missing or closed)
-      # @option arguments [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. (options: open, closed, hidden, none, all)
-      # @option arguments [String] :keep_alive Specific the time to live for the point in time (*Required*)
-      # @option arguments [Boolean] :allow_partial_search_results Specify whether to tolerate shards missing when creating the point-in-time, or otherwise throw an exception. (default: false)
+      # @option arguments [String, Array] :index A comma-separated list of index names to open point in time; use +_all+ or empty string to perform the operation on all indices (*Required*)
+      # @option arguments [Time] :keep_alive Extend the length of time that the point in time persists. (*Required*)
+      # @option arguments [Boolean] :ignore_unavailable If +false+, the request returns an error if it targets a missing or closed index.
+      # @option arguments [String] :preference The node or shard the operation should be performed on.
+      #  By default, it is random.
+      # @option arguments [String] :routing A custom value that is used to route operations to a specific shard.
+      # @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.
+      #  It supports comma-separated values, such as +open,hidden+. Valid values are: +all+, +open+, +closed+, +hidden+, +none+. Server default: open.
+      # @option arguments [Boolean] :allow_partial_search_results Indicates whether the point in time tolerates unavailable shards or shard failures when initially creating the PIT.
+      #  If +false+, creating a point in time request when a shard is missing or unavailable will throw an exception.
+      #  If +true+, the point in time will contain all the shards that are available at the time of the request.
+      # @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 [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/point-in-time-api.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-open-point-in-time
       #
       def open_point_in_time(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'open_point_in_time' }
@@ -48,12 +79,12 @@ 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   = "#{Utils.__listify(_index)}/_pit"
+        path   = "#{Utils.listify(_index)}/_pit"
         params = Utils.process_params(arguments)
 
         Elasticsearch::API::Response.new(

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

@@ -15,17 +15,18 @@
 # 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 whether the cluster is running.
+      # Ping the cluster.
+      # Get information about whether the cluster is running.
       #
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/index.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/group/endpoint-cluster
       #
       def ping(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'ping' }
@@ -33,7 +34,7 @@ module Elasticsearch
         arguments = arguments.clone
         headers = arguments.delete(:headers) || {}
 
-        body   = nil
+        body = nil
 
         method = Elasticsearch::API::HTTP_HEAD
         path   = ''

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

@@ -15,27 +15,34 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Actions
-      # Creates or updates a script.
+      # Create or update a script or search template.
+      # Creates or updates a stored script or search template.
       #
-      # @option arguments [String] :id Script ID
-      # @option arguments [String] :context Script context
-      # @option arguments [Time] :timeout Explicit operation timeout
-      # @option arguments [Time] :master_timeout Specify timeout for connection to master
+      # @option arguments [String] :id The identifier for the stored script or search template.
+      #  It must be unique within the cluster. (*Required*)
+      # @option arguments [String] :context The context in which the script or search template should run.
+      #  To prevent errors, the API immediately compiles the script or template in this context.
+      # @option arguments [Time] :master_timeout The 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.
+      #  It can also be set to +-1+ to indicate that the request should never timeout. Server default: 30s.
+      # @option arguments [Time] :timeout The period to wait for a response.
+      #  If no response is received before the timeout expires, the request fails and returns an error.
+      #  It can also be set to +-1+ to indicate that the request should never timeout. Server default: 30s.
       # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body The document (*Required*)
+      # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/modules-scripting.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-put-script
       #
       def put_script(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'put_script' }
 
-        defined_params = %i[id context].each_with_object({}) do |variable, set_variables|
+        defined_params = [:id, :context].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?
@@ -54,9 +61,9 @@ module Elasticsearch
 
         method = Elasticsearch::API::HTTP_PUT
         path   = if _id && _context
-                   "_scripts/#{Utils.__listify(_id)}/#{Utils.__listify(_context)}"
+                   "_scripts/#{Utils.listify(_id)}/#{Utils.listify(_context)}"
                  else
-                   "_scripts/#{Utils.__listify(_id)}"
+                   "_scripts/#{Utils.listify(_id)}"
                  end
         params = Utils.process_params(arguments)
 

data/lib/elasticsearch/api/actions/query_rules/delete_rule.rb

@@ -15,25 +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 QueryRules
       module Actions
-        # Deletes an individual query rule within a ruleset.
+        # Delete a query rule.
+        # Delete a query rule within a query ruleset.
+        # This is a destructive action that is only recoverable by re-adding the same rule with the create or update query rule API.
         #
-        # @option arguments [String] :ruleset_id The unique identifier of the query ruleset this rule exists in
-        # @option arguments [String] :rule_id The unique identifier of the rule to delete.
+        # @option arguments [String] :ruleset_id The unique identifier of the query ruleset containing the rule to delete (*Required*)
+        # @option arguments [String] :rule_id The unique identifier of the query rule within the specified ruleset to delete (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/delete-query-rule.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-query-rules-delete-rule
         #
         def delete_rule(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'query_rules.delete_rule' }
 
-          defined_params = %i[ruleset_id rule_id].each_with_object({}) do |variable, set_variables|
+          defined_params = [:ruleset_id, :rule_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?
@@ -51,7 +53,7 @@ module Elasticsearch
           _rule_id = arguments.delete(:rule_id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_query_rules/#{Utils.__listify(_ruleset_id)}/_rule/#{Utils.__listify(_rule_id)}"
+          path   = "_query_rules/#{Utils.listify(_ruleset_id)}/_rule/#{Utils.listify(_rule_id)}"
           params = {}
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/query_rules/delete_ruleset.rb

@@ -15,19 +15,21 @@
 # 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 QueryRules
       module Actions
-        # Deletes a query ruleset.
+        # Delete a query ruleset.
+        # Remove a query ruleset and its associated data.
+        # This is a destructive action that is not recoverable.
         #
-        # @option arguments [String] :ruleset_id The unique identifier of the query ruleset to delete
+        # @option arguments [String] :ruleset_id The unique identifier of the query ruleset to delete (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/delete-query-ruleset.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-query-rules-delete-ruleset
         #
         def delete_ruleset(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'query_rules.delete_ruleset' }
@@ -47,11 +49,11 @@ module Elasticsearch
           _ruleset_id = arguments.delete(:ruleset_id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_query_rules/#{Utils.__listify(_ruleset_id)}"
+          path   = "_query_rules/#{Utils.listify(_ruleset_id)}"
           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)
               )