elasticsearch-api 8.17.2 → 9.0.0

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

@@ -15,24 +15,44 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Fleet
       module Actions
-        # Multi Search API where the search will only be executed after specified checkpoints are available due to a refresh. This API is designed for internal use by the fleet server project.
+        # Run multiple Fleet searches.
+        # Run several Fleet searches with a single API request.
+        # The API follows the same structure as the multi search API.
+        # However, similar to the Fleet search API, it supports the +wait_for_checkpoints+ parameter.
         # This functionality is Experimental and may be changed or removed
         # completely in a future release. Elastic will take a best effort approach
         # to fix any issues, but experimental features are not subject to the
         # support SLA of official GA features.
         #
-        # @option arguments [String] :index The index name to use as the default
+        # @option arguments [Indexname, Indexalias] :index A single target to search. If the target is an index alias, it must resolve to a single index.
+        # @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 [Integer] :max_concurrent_searches Maximum number of concurrent searches the multi search API can execute.
+        # @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 [String] :search_type Indicates whether global term and document frequencies should be used when scoring returned documents.
+        # @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 [Boolean] :typed_keys Specifies whether aggregation and suggester names should be prefixed by their respective types in the response.
+        # @option arguments [Array<Integer>] :wait_for_checkpoints A comma separated list of checkpoints. When configured, the search API will only be executed on a shard
+        #  after the relevant checkpoint has become visible for search. Defaults to an empty list which will cause
+        #  Elasticsearch to immediately execute the search. Server default: [].
+        # @option arguments [Boolean] :allow_partial_search_results If true, returns partial results if there are shard request timeouts or shard failures.
+        #  If false, returns an error with no partial results.
+        #  Defaults to the configured cluster setting +search.default_allow_partial_results+, which is true by default.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The request definitions (metadata-fleet search request definition pairs), separated by newlines (*Required*)
+        # @option arguments [Hash] :body searches
         #
-        # @see [TODO]
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-fleet-msearch
         #
         def msearch(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'fleet.msearch' }
@@ -47,19 +67,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)}/_fleet/_fleet_msearch"
+                     "#{Utils.listify(_index)}/_fleet/_fleet_msearch"
                    else
                      '_fleet/_fleet_msearch'
                    end
-          params = {}
+          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/fleet/search.rb

@@ -15,27 +15,73 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Fleet
       module Actions
-        # Search API where the search will only be executed after specified checkpoints are available due to a refresh. This API is designed for internal use by the fleet server project.
+        # Run a Fleet search.
+        # The purpose of the Fleet search API is to provide an API where the search will be run only
+        # after the provided checkpoint has been processed and is visible for searches inside of Elasticsearch.
         # This functionality is Experimental and may be changed or removed
         # completely in a future release. Elastic will take a best effort approach
         # to fix any issues, but experimental features are not subject to the
         # support SLA of official GA features.
         #
-        # @option arguments [String] :index The index name to search.
-        # @option arguments [List] :wait_for_checkpoints Comma separated list of checkpoints, one per shard
-        # @option arguments [Time] :wait_for_checkpoints_timeout Explicit wait_for_checkpoints timeout
-        # @option arguments [Boolean] :allow_partial_search_results Indicate if an error should be returned if there is a partial search failure or timeout
+        # @option arguments [Indexname, Indexalias] :index A single target to search. If the target is an index alias, it must resolve to a single index. (*Required*)
+        # @option arguments [Boolean] :allow_no_indices [TODO]
+        # @option arguments [String] :analyzer [TODO]
+        # @option arguments [Boolean] :analyze_wildcard [TODO]
+        # @option arguments [Integer] :batched_reduce_size [TODO]
+        # @option arguments [Boolean] :ccs_minimize_roundtrips [TODO]
+        # @option arguments [String] :default_operator [TODO]
+        # @option arguments [String] :df [TODO]
+        # @option arguments [String, Array<String>] :docvalue_fields [TODO]
+        # @option arguments [String, Array<String>] :expand_wildcards [TODO]
+        # @option arguments [Boolean] :explain [TODO]
+        # @option arguments [Boolean] :ignore_throttled [TODO]
+        # @option arguments [Boolean] :ignore_unavailable [TODO]
+        # @option arguments [Boolean] :lenient [TODO]
+        # @option arguments [Integer] :max_concurrent_shard_requests [TODO]
+        # @option arguments [String] :preference [TODO]
+        # @option arguments [Integer] :pre_filter_shard_size [TODO]
+        # @option arguments [Boolean] :request_cache [TODO]
+        # @option arguments [String] :routing [TODO]
+        # @option arguments [Time] :scroll [TODO]
+        # @option arguments [String] :search_type [TODO]
+        # @option arguments [Array<String>] :stats [TODO]
+        # @option arguments [String, Array<String>] :stored_fields [TODO]
+        # @option arguments [String] :suggest_field Specifies which field to use for suggestions.
+        # @option arguments [String] :suggest_mode [TODO]
+        # @option arguments [Integer] :suggest_size [TODO]
+        # @option arguments [String] :suggest_text The source text for which the suggestions should be returned.
+        # @option arguments [Integer] :terminate_after [TODO]
+        # @option arguments [Time] :timeout [TODO]
+        # @option arguments [Boolean, Integer] :track_total_hits [TODO]
+        # @option arguments [Boolean] :track_scores [TODO]
+        # @option arguments [Boolean] :typed_keys [TODO]
+        # @option arguments [Boolean] :rest_total_hits_as_int [TODO]
+        # @option arguments [Boolean] :version [TODO]
+        # @option arguments [Boolean, String, Array<String>] :_source [TODO]
+        # @option arguments [String, Array<String>] :_source_excludes [TODO]
+        # @option arguments [String, Array<String>] :_source_includes [TODO]
+        # @option arguments [Boolean] :seq_no_primary_term [TODO]
+        # @option arguments [String] :q [TODO]
+        # @option arguments [Integer] :size [TODO]
+        # @option arguments [Integer] :from [TODO]
+        # @option arguments [String] :sort [TODO]
+        # @option arguments [Array<Integer>] :wait_for_checkpoints A comma separated list of checkpoints. When configured, the search API will only be executed on a shard
+        #  after the relevant checkpoint has become visible for search. Defaults to an empty list which will cause
+        #  Elasticsearch to immediately execute the search. Server default: [].
+        # @option arguments [Boolean] :allow_partial_search_results If true, returns partial results if there are shard request timeouts or shard failures.
+        #  If false, returns an error with no partial results.
+        #  Defaults to the configured cluster setting +search.default_allow_partial_results+, which is true by default.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The search definition using the Query DSL
+        # @option arguments [Hash] :body request body
         #
-        # @see [TODO]
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-fleet-search
         #
         def search(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'fleet.search' }
@@ -60,7 +106,7 @@ module Elasticsearch
                      Elasticsearch::API::HTTP_GET
                    end
 
-          path = "#{Utils.__listify(_index)}/_fleet/_fleet_search"
+          path   = "#{Utils.listify(_index)}/_fleet/_fleet_search"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,35 +15,91 @@
 # 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 a document.
+      # Get a document by its ID.
+      # Get a document and its source or stored fields from an index.
+      # By default, this API is realtime and is not affected by the refresh rate of the index (when data will become visible for search).
+      # In the case where stored fields are requested with the +stored_fields+ parameter and the document has been updated but is not yet refreshed, the API will have to parse and analyze the source to extract the stored fields.
+      # To turn off realtime behavior, set the +realtime+ parameter to false.
+      # **Source filtering**
+      # By default, the API returns the contents of the +_source+ field unless you have used the +stored_fields+ parameter or the +_source+ field is turned off.
+      # You can turn off +_source+ retrieval by using the +_source+ parameter:
+      # +
+      # GET my-index-000001/_doc/0?_source=false
+      # +
+      # If you only need one or two fields from the +_source+, use the +_source_includes+ or +_source_excludes+ parameters to include or filter out particular fields.
+      # This can be helpful with large documents where partial retrieval can save on network overhead
+      # Both parameters take a comma separated list of fields or wildcard expressions.
+      # For example:
+      # +
+      # GET my-index-000001/_doc/0?_source_includes=*.id&_source_excludes=entities
+      # +
+      # If you only want to specify includes, you can use a shorter notation:
+      # +
+      # GET my-index-000001/_doc/0?_source=*.id
+      # +
+      # **Routing**
+      # If routing is used during indexing, the routing value also needs to be specified to retrieve a document.
+      # For example:
+      # +
+      # GET my-index-000001/_doc/2?routing=user1
+      # +
+      # This request gets the document with ID 2, but it is routed based on the user.
+      # The document is not fetched if the correct routing is not specified.
+      # **Distributed**
+      # The GET operation is hashed into a specific shard ID.
+      # It is then redirected to one of the replicas within that shard ID and returns the result.
+      # The replicas are the primary shard and its replicas within that shard ID group.
+      # This means that the more replicas you have, the better your GET scaling will be.
+      # **Versioning support**
+      # You can use the +version+ parameter to retrieve the document only if its current version is equal to the specified one.
+      # Internally, Elasticsearch has marked the old document as deleted and added an entirely new document.
+      # The old version of the document doesn't disappear immediately, although you won't be able to access it.
+      # Elasticsearch cleans up deleted documents in the background as you continue to index more data.
       #
-      # @option arguments [String] :id The document ID
-      # @option arguments [String] :index The name of the index
-      # @option arguments [Boolean] :force_synthetic_source Should this request force synthetic _source? Use this to test if the mapping supports synthetic _source and to get a sense of the worst case performance. Fetches with this enabled will be slower the enabling synthetic source natively in the index.
-      # @option arguments [List] :stored_fields A comma-separated list of stored fields to return in the response
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on (default: random)
-      # @option arguments [Boolean] :realtime Specify whether to perform the operation in realtime or search mode
-      # @option arguments [Boolean] :refresh Refresh the shard containing the document before performing the operation
-      # @option arguments [String] :routing Specific routing value
-      # @option arguments [List] :_source True or false to return the _source field or not, or a list of fields to return
-      # @option arguments [List] :_source_excludes A list of fields to exclude from the returned _source field
-      # @option arguments [List] :_source_includes A list of fields to extract and return from the _source field
-      # @option arguments [Number] :version Explicit version number for concurrency control
-      # @option arguments [String] :version_type Specific version type (options: internal, external, external_gte)
+      # @option arguments [String] :id A unique document identifier. (*Required*)
+      # @option arguments [String] :index The name of the index that contains the document. (*Required*)
+      # @option arguments [Boolean] :force_synthetic_source Indicates whether the request forces synthetic +_source+.
+      #  Use this paramater to test if the mapping supports synthetic +_source+ and to get a sense of the worst case performance.
+      #  Fetches with this parameter enabled will be slower than enabling synthetic source natively in the index.
+      # @option arguments [String] :preference The node or shard the operation should be performed on.
+      #  By default, the operation is randomized between the shard replicas.If it is set to +_local+, the operation will prefer to be run on a local allocated shard when possible.
+      #  If it is set to a custom value, the value is used to guarantee that the same shards will be used for the same custom value.
+      #  This can help with "jumping values" when hitting different shards in different refresh states.
+      #  A sample value can be something like the web session ID or the user name.
+      # @option arguments [Boolean] :realtime If +true+, the request is real-time as opposed to near-real-time. Server default: true.
+      # @option arguments [Boolean] :refresh If +true+, the request refreshes the relevant shards before retrieving the document.
+      #  Setting it to +true+ should be done after careful thought and verification that this does not cause a heavy load on the system (and slow down indexing).
+      # @option arguments [String] :routing A custom value used to route operations to a specific shard.
+      # @option arguments [Boolean, String, Array<String>] :_source Indicates whether to return the +_source+ field (+true+ or +false+) or lists the fields to return.
+      # @option arguments [String, Array<String>] :_source_excludes A comma-separated list of source fields to exclude from the response.
+      #  You can also use this parameter to exclude fields from the subset specified in +_source_includes+ query parameter.
+      #  If the +_source+ parameter is +false+, this parameter is ignored.
+      # @option arguments [String, Array<String>] :_source_includes A comma-separated list of source fields to include in the response.
+      #  If this parameter is specified, only these source fields are returned.
+      #  You can exclude fields from this subset using the +_source_excludes+ query parameter.
+      #  If the +_source+ parameter is +false+, this parameter is ignored.
+      # @option arguments [String, Array<String>] :stored_fields A comma-separated list of stored fields to return as part of a hit.
+      #  If no fields are specified, no stored fields are included in the response.
+      #  If this field is specified, the +_source+ parameter defaults to +false+.
+      #  Only leaf fields can be retrieved with the +stored_field+ option.
+      #  Object fields can't be returned;​if specified, the request fails.
+      # @option arguments [Integer] :version The version number for concurrency control.
+      #  It must match the current version of the document for the request to succeed.
+      # @option arguments [String] :version_type The version type.
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/docs-get.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-get
       #
       def get(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'get' }
 
-        defined_params = %i[index id].each_with_object({}) do |variable, set_variables|
+        defined_params = [:index, :id].each_with_object({}) do |variable, set_variables|
           set_variables[variable] = arguments[variable] if arguments.key?(variable)
         end
         request_opts[:defined_params] = defined_params unless defined_params.empty?
@@ -61,11 +117,11 @@ module Elasticsearch
         _index = arguments.delete(:index)
 
         method = Elasticsearch::API::HTTP_GET
-        path   = "#{Utils.__listify(_index)}/_doc/#{Utils.__listify(_id)}"
+        path   = "#{Utils.listify(_index)}/_doc/#{Utils.listify(_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)
             )

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

@@ -15,19 +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 Actions
-      # Returns a script.
+      # Get a script or search template.
+      # Retrieves a stored script or search template.
       #
-      # @option arguments [String] :id Script ID
-      # @option arguments [Time] :master_timeout Specify timeout for connection to master
+      # @option arguments [String] :id The identifier for the stored script or search template. (*Required*)
+      # @option arguments [Time] :master_timeout The period to wait for the master node.
+      #  If the master node is not available 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: .
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @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-get-script
       #
       def get_script(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'get_script' }
@@ -47,7 +50,7 @@ module Elasticsearch
         _id = arguments.delete(:id)
 
         method = Elasticsearch::API::HTTP_GET
-        path   = "_scripts/#{Utils.__listify(_id)}"
+        path   = "_scripts/#{Utils.listify(_id)}"
         params = Utils.process_params(arguments)
 
         Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/get_script_context.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 all script contexts.
+      # Get script contexts.
+      # Get a list of supported script contexts and their methods.
       #
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/painless/8.17/painless-contexts.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-get-script-context
       #
       def get_script_context(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'get_script_context' }
@@ -33,7 +34,7 @@ module Elasticsearch
         arguments = arguments.clone
         headers = arguments.delete(:headers) || {}
 
-        body   = nil
+        body = nil
 
         method = Elasticsearch::API::HTTP_GET
         path   = '_script_context'

data/lib/elasticsearch/api/actions/get_script_languages.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 available script types, languages and contexts
+      # Get script languages.
+      # Get a list of available script types, languages, and contexts.
       #
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @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-get-script-languages
       #
       def get_script_languages(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'get_script_languages' }
@@ -33,7 +34,7 @@ module Elasticsearch
         arguments = arguments.clone
         headers = arguments.delete(:headers) || {}
 
-        body   = nil
+        body = nil
 
         method = Elasticsearch::API::HTTP_GET
         path   = '_script_language'

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

@@ -15,33 +15,46 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Actions
-      # Returns the source of a document.
+      # Get a document's source.
+      # Get the source of a document.
+      # For example:
+      # +
+      # GET my-index-000001/_source/1
+      # +
+      # You can use the source filtering parameters to control which parts of the +_source+ are returned:
+      # +
+      # GET my-index-000001/_source/1/?_source_includes=*.id&_source_excludes=entities
+      # +
       #
-      # @option arguments [String] :id The document ID
-      # @option arguments [String] :index The name of the index
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on (default: random)
-      # @option arguments [Boolean] :realtime Specify whether to perform the operation in realtime or search mode
-      # @option arguments [Boolean] :refresh Refresh the shard containing the document before performing the operation
-      # @option arguments [String] :routing Specific routing value
-      # @option arguments [List] :_source True or false to return the _source field or not, or a list of fields to return
-      # @option arguments [List] :_source_excludes A list of fields to exclude from the returned _source field
-      # @option arguments [List] :_source_includes A list of fields to extract and return from the _source field
-      # @option arguments [Number] :version Explicit version number for concurrency control
-      # @option arguments [String] :version_type Specific version type (options: internal, external, external_gte)
+      # @option arguments [String] :id A unique document identifier. (*Required*)
+      # @option arguments [String] :index The name of the index that contains the document. (*Required*)
+      # @option arguments [String] :preference The node or shard the operation should be performed on.
+      #  By default, the operation is randomized between the shard replicas.
+      # @option arguments [Boolean] :realtime If +true+, the request is real-time as opposed to near-real-time. Server default: true.
+      # @option arguments [Boolean] :refresh If +true+, the request refreshes the relevant shards before retrieving the document.
+      #  Setting it to +true+ should be done after careful thought and verification that this does not cause a heavy load on the system (and slow down indexing).
+      # @option arguments [String] :routing A custom value used to route operations to a specific shard.
+      # @option arguments [Boolean, String, Array<String>] :_source Indicates whether to return the +_source+ field (+true+ or +false+) or lists the fields to return.
+      # @option arguments [String, Array<String>] :_source_excludes A comma-separated list of source fields to exclude in the response.
+      # @option arguments [String, Array<String>] :_source_includes A comma-separated list of source fields to include in the response.
+      # @option arguments [String, Array<String>] :stored_fields A comma-separated list of stored fields to return as part of a hit.
+      # @option arguments [Integer] :version The version number for concurrency control.
+      #  It must match the current version of the document for the request to succeed.
+      # @option arguments [String] :version_type The version type.
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/docs-get.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-get
       #
       def get_source(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'get_source' }
 
-        defined_params = %i[index id].each_with_object({}) do |variable, set_variables|
+        defined_params = [:index, :id].each_with_object({}) do |variable, set_variables|
           set_variables[variable] = arguments[variable] if arguments.key?(variable)
         end
         request_opts[:defined_params] = defined_params unless defined_params.empty?
@@ -59,7 +72,7 @@ module Elasticsearch
         _index = arguments.delete(:index)
 
         method = Elasticsearch::API::HTTP_GET
-        path   = "#{Utils.__listify(_index)}/_source/#{Utils.__listify(_id)}"
+        path   = "#{Utils.listify(_index)}/_source/#{Utils.listify(_id)}"
         params = Utils.process_params(arguments)
 
         Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/graph/explore.rb

@@ -15,22 +15,29 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Graph
       module Actions
-        # Explore extracted and summarized information about the documents and terms in an index.
+        # Explore graph analytics.
+        # Extract and summarize information about the documents and terms in an Elasticsearch data stream or index.
+        # The easiest way to understand the behavior of this API is to use the Graph UI to explore connections.
+        # An initial request to the +_explore+ API contains a seed query that identifies the documents of interest and specifies the fields that define the vertices and connections you want to include in the graph.
+        # Subsequent requests enable you to spider out from one more vertices of interest.
+        # You can exclude vertices that have already been returned.
         #
-        # @option arguments [List] :index A comma-separated list of index names to search; use `_all` or empty string to perform the operation on all indices
-        # @option arguments [String] :routing Specific routing value
-        # @option arguments [Time] :timeout Explicit operation timeout
+        # @option arguments [String, Array] :index Name of the index. (*Required*)
+        # @option arguments [String] :routing Custom value used to route operations to a specific shard.
+        # @option arguments [Time] :timeout Specifies the period of time to wait for a response from each shard.
+        #  If no response is received before the timeout expires, the request fails and returns an error.
+        #  Defaults to no timeout.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body Graph Query DSL
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/graph-explore-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/group/endpoint-graph
         #
         def explore(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'graph.explore' }
@@ -55,7 +62,7 @@ module Elasticsearch
                      Elasticsearch::API::HTTP_GET
                    end
 
-          path = "#{Utils.__listify(_index)}/_graph/explore"
+          path   = "#{Utils.listify(_index)}/_graph/explore"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,21 +15,33 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Actions
-      # Returns the health of the cluster.
+      # Get the cluster health.
+      # Get a report with the health status of an Elasticsearch cluster.
+      # The report contains a list of indicators that compose Elasticsearch functionality.
+      # Each indicator has a health status of: green, unknown, yellow or red.
+      # The indicator will provide an explanation and metadata describing the reason for its current health status.
+      # The cluster’s status is controlled by the worst indicator status.
+      # In the event that an indicator’s status is non-green, a list of impacts may be present in the indicator result which detail the functionalities that are negatively affected by the health issue.
+      # Each impact carries with it a severity level, an area of the system that is affected, and a simple description of the impact on the system.
+      # Some health indicators can determine the root cause of a health problem and prescribe a set of steps that can be performed in order to improve the health of the system.
+      # The root cause and remediation steps are encapsulated in a diagnosis.
+      # A diagnosis contains a cause detailing a root cause analysis, an action containing a brief description of the steps to take to fix the problem, the list of affected resources (if applicable), and a detailed step-by-step troubleshooting guide to fix the diagnosed problem.
+      # NOTE: The health indicators perform root cause analysis of non-green health statuses. This can be computationally expensive when called frequently.
+      # When setting up automated polling of the API for health status, set verbose to false to disable the more expensive analysis logic.
       #
-      # @option arguments [String] :feature A feature of the cluster, as returned by the top-level health API
-      # @option arguments [Time] :timeout Explicit operation timeout
-      # @option arguments [Boolean] :verbose Opt in for more information about the health of the system
-      # @option arguments [Integer] :size Limit the number of affected resources the health API returns
+      # @option arguments [String] :feature A feature of the cluster, as returned by the top-level health report API.
+      # @option arguments [Time] :timeout Explicit operation timeout.
+      # @option arguments [Boolean] :verbose Opt-in for more information about the health of the system. Server default: true.
+      # @option arguments [Integer] :size Limit the number of affected resources the health report API returns. Server default: 1000.
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/health-api.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-health-report
       #
       def health_report(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'health_report' }
@@ -48,7 +60,7 @@ module Elasticsearch
 
         method = Elasticsearch::API::HTTP_GET
         path   = if _feature
-                   "_health_report/#{Utils.__listify(_feature)}"
+                   "_health_report/#{Utils.listify(_feature)}"
                  else
                    '_health_report'
                  end