elasticsearch-api 7.2.0 → 8.0.0

data/lib/elasticsearch/api/actions/indices/simulate_index_template.rb

@@ -0,0 +1,55 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Elasticsearch
+  module API
+    module Indices
+      module Actions
+        # Simulate matching the given index name against the index templates in the system
+        #
+        # @option arguments [String] :name The name of the index (it must be a concrete index name)
+        # @option arguments [Boolean] :create Whether the index template we optionally defined in the body should only be dry-run added if new or can also replace an existing one
+        # @option arguments [String] :cause User defined reason for dry-run creating the new template for simulation purposes
+        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body New index template definition, which will be included in the simulation, as if it already exists in the system
+        #
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-templates.html
+        #
+        def simulate_index_template(arguments = {})
+          raise ArgumentError, "Required argument 'name' missing" unless arguments[:name]
+
+          headers = arguments.delete(:headers) || {}
+
+          body = arguments.delete(:body)
+
+          arguments = arguments.clone
+
+          _name = arguments.delete(:name)
+
+          method = Elasticsearch::API::HTTP_POST
+          path   = "_index_template/_simulate_index/#{Utils.__listify(_name)}"
+          params = Utils.process_params(arguments)
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/api/actions/indices/simulate_template.rb

@@ -0,0 +1,57 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Elasticsearch
+  module API
+    module Indices
+      module Actions
+        # Simulate resolving the given template name or body
+        #
+        # @option arguments [String] :name The name of the index template
+        # @option arguments [Boolean] :create Whether the index template we optionally defined in the body should only be dry-run added if new or can also replace an existing one
+        # @option arguments [String] :cause User defined reason for dry-run creating the new template for simulation purposes
+        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body New index template definition to be simulated, if no index template name is specified
+        #
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-templates.html
+        #
+        def simulate_template(arguments = {})
+          headers = arguments.delete(:headers) || {}
+
+          body = arguments.delete(:body)
+
+          arguments = arguments.clone
+
+          _name = arguments.delete(:name)
+
+          method = Elasticsearch::API::HTTP_POST
+          path   = if _name
+                     "_index_template/_simulate/#{Utils.__listify(_name)}"
+                   else
+                     "_index_template/_simulate"
+                   end
+          params = Utils.process_params(arguments)
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/api/actions/indices/split.rb

@@ -6,7 +6,7 @@
 # not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-#	http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
@@ -19,40 +19,40 @@ module Elasticsearch
   module API
     module Indices
       module Actions
-
-        # The split index API allows you to split an existing index into a new index with multiple of its primary shards.
+        # Allows you to split an existing index into a new index with more primary shards.
         #
-        # @option arguments [String] :index The name of the source index to split (*Required*)
-        # @option arguments [String] :target The name of the target index to split into (*Required*)
-        # @option arguments [Hash] :body The configuration for the target index (`settings` and `aliases`)
+        # @option arguments [String] :index The name of the source index to split
+        # @option arguments [String] :target The name of the target index to split into
         # @option arguments [Time] :timeout Explicit operation timeout
         # @option arguments [Time] :master_timeout Specify timeout for connection to master
         # @option arguments [String] :wait_for_active_shards Set the number of active shards to wait for on the shrunken index before the operation returns.
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body The configuration for the target index (`settings` and `aliases`)
         #
-        # @see http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-split-index.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-split-index.html
         #
-        def split(arguments={})
+        def split(arguments = {})
           raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
           raise ArgumentError, "Required argument 'target' missing" unless arguments[:target]
+
+          headers = arguments.delete(:headers) || {}
+
+          body = arguments.delete(:body)
+
           arguments = arguments.clone
-          source = arguments.delete(:index)
-          target = arguments.delete(:target)
+
+          _index = arguments.delete(:index)
+
+          _target = arguments.delete(:target)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = Utils.__pathify Utils.__escape(source), '_split', Utils.__escape(target)
-          params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-          body   = arguments[:body]
+          path   = "#{Utils.__listify(_index)}/_split/#{Utils.__listify(_target)}"
+          params = Utils.process_params(arguments)
 
-          perform_request(method, path, params, body).body
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers)
+          )
         end
-
-        # Register this action with its valid params when the module is loaded.
-        #
-        # @since 6.1.1
-        ParamsRegistry.register(:split, [
-            :timeout,
-            :master_timeout,
-            :wait_for_active_shards ].freeze)
       end
     end
   end

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

@@ -6,7 +6,7 @@
 # not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-#	http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
@@ -19,128 +19,50 @@ module Elasticsearch
   module API
     module Indices
       module Actions
+        # Provides statistics on operations happening in an index.
+        #
+        # @option arguments [List] :metric Limit the information returned the specific metrics. (options: _all, completion, docs, fielddata, query_cache, flush, get, indexing, merge, request_cache, refresh, search, segments, store, warmer, bulk)
+        # @option arguments [List] :index A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices
+        # @option arguments [List] :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 [List] :groups A comma-separated list of search groups for `search` index metric
+        # @option arguments [String] :level Return stats aggregated at cluster, index or shard level (options: cluster, indices, shards)
+        # @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] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. (options: open, closed, hidden, none, all)
+        # @option arguments [Boolean] :forbid_closed_indices If set to false stats will also collected from closed indices if explicitly specified or if expand_wildcards expands to closed indices
+        # @option arguments [Hash] :headers Custom HTTP headers
+        #
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-stats.html
+        #
+        def stats(arguments = {})
+          headers = arguments.delete(:headers) || {}
 
-        # Return statistical information about one or more indices.
-        #
-        # The response contains comprehensive statistical information about metrics related to index:
-        # how much time did indexing, search and other operations take, how much disk space it takes,
-        # how much memory filter caches or field data require, etc.
-        #
-        # @example Get all available statistics for all indices
-        #
-        #     client.indices.stats
-        #
-        # @example Get statistics for a single index
-        #
-        #     client.indices.stats index: 'foo'
-        #
-        # @example Get statistics about documents and disk size for multiple indices
-        #
-        #     client.indices.stats index: ['foo', 'bar'], docs: true, store: true
-        #
-        # @example Get statistics about filter cache and field data for all fields
-        #
-        #     client.indices.stats fielddata: true, filter_cache: true
-        #
-        # @example Get statistics about filter cache and field data for specific fields
-        #
-        #     client.indices.stats fielddata: true, filter_cache: true, fields: 'created_at,tags'
-        #
-        # @example Get statistics about filter cache and field data per field for all fields
-        #
-        #     client.indices.stats fielddata: true, filter_cache: true, fields: '*'
-        #
-        # @example Get statistics about searches, with segmentation for different search groups
-        #
-        #     client.indices.stats search: true, groups: ['groupA', 'groupB']
-        #
-        # @option arguments [Boolean] :docs Return information about indexed and deleted documents
-        # @option arguments [Boolean] :fielddata Return information about field data
-        # @option arguments [Boolean] :fields A comma-separated list of fields for `fielddata` metric (supports wildcards)
-        # @option arguments [Boolean] :filter_cache Return information about filter cache
-        # @option arguments [Boolean] :flush Return information about flush operations
-        # @option arguments [Boolean] :get Return information about get operations
-        # @option arguments [Boolean] :groups A comma-separated list of search groups for `search` statistics
-        # @option arguments [Boolean] :id_cache Return information about ID cache
-        # @option arguments [List] :index A comma-separated list of index names; use `_all` or empty string
-        #                                 to perform the operation on all indices
-        # @option arguments [Boolean] :indexing Return information about indexing operations
-        # @option arguments [String] :level Return stats aggregated at cluster, index or shard level
-        #                                   (Options: cluster, indices, shards)
-        # @option arguments [List] :types A comma-separated list of document types to include in the `indexing` info
-        # @option arguments [Boolean] :merge Return information about merge operations
-        # @option arguments [List] :metric Limit the information returned the specific metrics
-        #                                  (_all, completion, docs, fielddata, filter_cache, flush, get,
-        #                                  id_cache, indexing, merge, percolate, refresh, search, segments,
-        #                                  store, warmer, suggest)
-        # @option arguments [Boolean] :refresh Return information about refresh operations
-        # @option arguments [Boolean] :search Return information about search operations; use the `groups` parameter to
-        #                                     include information for specific search groups
-        # @option arguments [List] :groups A comma-separated list of search groups to include in the `search` statistics
-        # @option arguments [Boolean] :suggest Return information about suggest statistics
-        # @option arguments [Boolean] :store Return information about the size of the index
-        # @option arguments [Boolean] :warmer Return information about warmers
-        # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when
-        #                                                 unavailable (missing, closed, etc)
-        # @option arguments [Boolean] :allow_no_indices Whether to ignore if a wildcard indices expression resolves into
-        #                                               no concrete indices. (This includes `_all` string or when no
-        #                                               indices have been specified)
-        # @option arguments [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that
-        #                                              are open, closed or both. (options: open, closed)
-        #
-        # @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. (default: false)
-        #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-stats.html
-        #
-        def stats(arguments={})
-          method = HTTP_GET
-          parts  = Utils.__extract_parts arguments, ParamsRegistry.get(:stats_parts)
-          path   = Utils.__pathify Utils.__listify(arguments[:index]), '_stats', Utils.__listify(parts)
+          body = nil
 
-          params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(:stats_params)
-          params[:fields] = Utils.__listify(params[:fields], :escape => false) if params[:fields]
-          params[:groups] = Utils.__listify(params[:groups], :escape => false) if params[:groups]
+          arguments = arguments.clone
 
-          body   = nil
+          _metric = arguments.delete(:metric)
 
-          perform_request(method, path, params, body).body
-        end
+          _index = arguments.delete(:index)
 
-        # Register this action with its valid params when the module is loaded.
-        #
-        # @since 6.1.1
-        ParamsRegistry.register(:stats_params, [
-            :fields,
-            :completion_fields,
-            :fielddata_fields,
-            :groups,
-            :level,
-            :types,
-            :ignore_indices,
-            :ignore_unavailable,
-            :allow_no_indices,
-            :expand_wildcards,
-            :include_segment_file_sizes,
-            :include_unloaded_segments,
-            :forbid_closed_indices ].freeze)
+          method = Elasticsearch::API::HTTP_GET
+          path   = if _index && _metric
+                     "#{Utils.__listify(_index)}/_stats/#{Utils.__listify(_metric)}"
+                   elsif _metric
+                     "_stats/#{Utils.__listify(_metric)}"
+                   elsif _index
+                     "#{Utils.__listify(_index)}/_stats"
+                   else
+                     "_stats"
+                   end
+          params = Utils.process_params(arguments)
 
-        # Register this action with its valid parts when the module is loaded.
-        #
-        # @since 6.1.1
-        ParamsRegistry.register(:stats_parts, [
-            :docs,
-            :fielddata,
-            :filter_cache,
-            :flush,
-            :get,
-            :indexing,
-            :merge,
-            :metric,
-            :refresh,
-            :search,
-            :suggest,
-            :store,
-            :warmer ].freeze)
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers)
+          )
+        end
       end
     end
   end

data/lib/elasticsearch/api/actions/indices/unfreeze.rb

@@ -1,37 +1,60 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
 module Elasticsearch
   module API
     module Indices
       module Actions
-
-        # In order to keep indices available and queryable for a longer period but at the same time reduce their
-        #   hardware requirements they can be transitioned into a frozen state. Once an index is frozen, all of its
-        #   transient shard memory (aside from mappings and analyzers) is moved to persistent storage.
+        # Unfreezes an index. When a frozen index is unfrozen, the index goes through the normal recovery process and becomes writeable again.
+        #
+        # @option arguments [String] :index The name of the index to unfreeze
+        # @option arguments [Time] :timeout Explicit operation timeout
+        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when unavailable (missing or closed)
+        # @option arguments [Boolean] :allow_no_indices Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)
+        # @option arguments [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. (options: open, closed, hidden, none, all)
+        # @option arguments [String] :wait_for_active_shards Sets the number of active shards to wait for before the operation returns.
+        # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @option arguments [List] :index A comma separated list of indices to unfreeze. (*Required*)
+        # *Deprecation notice*:
+        # Frozen indices are deprecated because they provide no benefit given improvements in heap memory utilization. They will be removed in a future release.
+        # Deprecated since version 7.14.0
         #
-        # @note This feature is available in the Platinum distribution of Elasticsearch.
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/frozen-indices.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/unfreeze-index-api.html
         #
         def unfreeze(arguments = {})
           raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
 
-          valid_params = [
-              :timeout,
-              :master_timeout,
-              :ignore_unavailable,
-              :allow_no_indices,
-              :expand_wildcards,
-              :wait_for_active_shards]
+          headers = arguments.delete(:headers) || {}
+
+          body = nil
 
           arguments = arguments.clone
-          index = arguments.delete(:index)
+
+          _index = arguments.delete(:index)
 
           method = Elasticsearch::API::HTTP_POST
-          path = Elasticsearch::API::Utils.__pathify Elasticsearch::API::Utils.__listify(index), '_unfreeze'
-          params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, valid_params
+          path   = "#{Utils.__listify(_index)}/_unfreeze"
+          params = Utils.process_params(arguments)
 
-          perform_request(method, path, params).body
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers)
+          )
         end
       end
     end

data/lib/elasticsearch/api/actions/indices/update_aliases.rb

@@ -6,7 +6,7 @@
 # not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-#	http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
@@ -19,52 +19,32 @@ module Elasticsearch
   module API
     module Indices
       module Actions
-
-        # Perform multiple operation on index aliases in a single request.
-        #
-        # Pass the `actions` (add, remove) in the `body` argument.
-        #
-        # @example Add multiple indices to a single alias
-        #
-        #     client.indices.update_aliases body: {
-        #       actions: [
-        #         { add: { index: 'logs-2013-06', alias: 'year-2013' } },
-        #         { add: { index: 'logs-2013-05', alias: 'year-2013' } }
-        #       ]
-        #     }
+        # Updates index aliases.
         #
-        # @example Swap an alias (atomic operation)
-        #
-        #     client.indices.update_aliases body: {
-        #       actions: [
-        #         { remove: { index: 'logs-2013-06', alias: 'current-month' } },
-        #         { add:    { index: 'logs-2013-07', alias: 'current-month' } }
-        #       ]
-        #     }
-        #
-        # @option arguments [Hash] :body The definition of `actions` to perform (*Required*)
         # @option arguments [Time] :timeout Request timeout
         # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body The definition of `actions` to perform (*Required*)
         #
-        # @see https://www.elastic.co/guide/reference/api/admin-indices-aliases/
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-aliases.html
         #
-        def update_aliases(arguments={})
+        def update_aliases(arguments = {})
           raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
-          method = HTTP_POST
-          path   = "_aliases"
 
-          params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-          body   = arguments[:body]
+          headers = arguments.delete(:headers) || {}
 
-          perform_request(method, path, params, body).body
-        end
+          body = arguments.delete(:body)
 
-        # Register this action with its valid params when the module is loaded.
-        #
-        # @since 6.1.1
-        ParamsRegistry.register(:update_aliases, [
-            :timeout,
-            :master_timeout ].freeze)
+          arguments = arguments.clone
+
+          method = Elasticsearch::API::HTTP_POST
+          path   = "_aliases"
+          params = Utils.process_params(arguments)
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers)
+          )
+        end
       end
     end
   end

data/lib/elasticsearch/api/actions/indices/validate_query.rb

@@ -6,7 +6,7 @@
 # not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-#	http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
@@ -19,48 +19,13 @@ module Elasticsearch
   module API
     module Indices
       module Actions
-
-        # Validate a query
-        #
-        # @example Validate a simple query string query
-        #
-        #     client.indices.validate_query index: 'myindex', q: 'title:foo AND body:bar'
-        #
-        # @example Validate an invalid query (with explanation)
-        #
-        #     client.indices.validate_query index: 'myindex', q: '[[[ BOOM! ]]]', explain: true
-        #
-        # @example Validate a DSL query (with explanation and rewrite). With rewrite set to true, the 
-        #                                explanation is more detailed showing the actual Lucene query that will 
-        #                                be executed.
-        #
-        #     client.indices.validate_query index: 'myindex',
-        #                                   rewrite: true,
-        #                                   explain: true,
-        #                                   body: {
-        #                                     filtered: {
-        #                                       query: {
-        #                                         match: {
-        #                                           title: 'foo'
-        #                                         }
-        #                                       },
-        #                                       filter: {
-        #                                         range: {
-        #                                           published_at: {
-        #                                             from: '2013-06-01'
-        #                                           }
-        #                                         }
-        #                                       }
-        #                                     }
-        #                                   }
+        # Allows a user to validate a potentially expensive query without executing it.
         #
         # @option arguments [List] :index A comma-separated list of index names to restrict the operation; use `_all` or empty string to perform the operation on all indices
-        # @option arguments [List] :type A comma-separated list of document types to restrict the operation; leave empty to perform the operation on all types
-        # @option arguments [Hash] :body The query definition specified with the Query DSL
         # @option arguments [Boolean] :explain Return detailed information about the error
         # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when unavailable (missing or closed)
         # @option arguments [Boolean] :allow_no_indices Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)
-        # @option arguments [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. (options: open, closed, none, all)
+        # @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] :q Query in the Lucene query string syntax
         # @option arguments [String] :analyzer The analyzer to use for the query string
         # @option arguments [Boolean] :analyze_wildcard Specify whether wildcard and prefix queries should be analyzed (default: false)
@@ -69,37 +34,37 @@ module Elasticsearch
         # @option arguments [Boolean] :lenient Specify whether format-based query failures (such as providing text to a numeric field) should be ignored
         # @option arguments [Boolean] :rewrite Provide a more detailed explanation showing the actual Lucene query that will be executed.
         # @option arguments [Boolean] :all_shards Execute validation on all shards instead of one random shard per index
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body The query definition specified with the Query DSL
         #
-        # @see https://www.elastic.co/guide/reference/api/validate/
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/search-validate.html
         #
-        def validate_query(arguments={})
-          method = HTTP_GET
-          path   = Utils.__pathify Utils.__listify(arguments[:index]),
-                                   Utils.__listify(arguments[:type]),
-                                   '_validate/query'
+        def validate_query(arguments = {})
+          headers = arguments.delete(:headers) || {}
 
-          params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-          body   = arguments[:body]
+          body = arguments.delete(:body)
 
-          perform_request(method, path, params, body).body
-        end
+          arguments = arguments.clone
 
-        # Register this action with its valid params when the module is loaded.
-        #
-        # @since 6.1.1
-        ParamsRegistry.register(:validate_query, [
-            :explain,
-            :ignore_unavailable,
-            :allow_no_indices,
-            :expand_wildcards,
-            :q,
-            :analyzer,
-            :analyze_wildcard,
-            :default_operator,
-            :df,
-            :lenient,
-            :rewrite,
-            :all_shards ].freeze)
+          _index = arguments.delete(:index)
+
+          method = if body
+                     Elasticsearch::API::HTTP_POST
+                   else
+                     Elasticsearch::API::HTTP_GET
+                   end
+
+          path   = if _index
+                     "#{Utils.__listify(_index)}/_validate/query"
+                   else
+                     "_validate/query"
+                   end
+          params = Utils.process_params(arguments)
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers)
+          )
+        end
       end
     end
   end