opensearch-ruby 3.3.0 → 4.0.0.pre.beta.1

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

@@ -3,85 +3,58 @@
 # The OpenSearch Contributors require contributions made to
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
-#
-# Modifications Copyright OpenSearch Contributors. See
-# GitHub history for details.
-#
-# 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 OpenSearch
-  module API
-    module Actions
-      # Returns the source of a document.
-      #
-      # @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, force)
-      # @option arguments [Hash] :headers Custom HTTP headers
-      #
-      # *Deprecation notice*:
-      # Specifying types in urls has been deprecated
-      # Deprecated since version 7.0.0
-      #
-      #
-      #
-      def get_source(arguments = {})
-        raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
-        raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
 
-        headers = arguments.delete(:headers) || {}
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
 
-        arguments = arguments.clone
+# frozen_string_literal: true
 
-        _id = arguments.delete(:id)
-
-        _index = arguments.delete(:index)
-
-        method = OpenSearch::API::HTTP_GET
-        path   = "#{Utils.__listify(_index)}/_source/#{Utils.__listify(_id)}"
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-
-        body = nil
-        perform_request(method, path, params, body, headers).body
+module OpenSearch
+  module API
+    module Root
+      module Actions
+        # Returns the source of a document.
+        #
+        # @option args [String] :id *Required* Unique identifier of the document.
+        # @option args [String] :index *Required* Name of the index that contains the document.
+        # @option args [Boolean, Enumerable<String>, String] :_source Set to `true` or `false` to return the `_source` field or not, or a list of fields to return.
+        # @option args [Enumerable<String>, String] :_source_excludes A comma-separated list of source fields to exclude in the response.
+        # @option args [Enumerable<String>, String] :_source_includes A comma-separated list of source fields to include in the response.
+        # @option args [String] :preference (default: random) Specifies the node or shard the operation should be performed on. Random by default.
+        # @option args [Boolean] :realtime Boolean) If `true`, the request is real-time as opposed to near-real-time.
+        # @option args [Boolean, String] :refresh If `true`, OpenSearch refreshes the affected shards to make this operation visible to search. If `false`, do nothing with refreshes.
+        # @option args [Enumerable<String>, String] :routing Target the specified primary shard.
+        # @option args [Integer] :version Explicit version number for concurrency control. The specified version must match the current version of the document for the request to succeed.
+        # @option args [String] :version_type Specific version type. One of `internal`, `external`, `external_gte`.
+        def get_source(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'id' missing" if args['id'].nil?
+          raise ArgumentError, "Required argument 'index' missing" if args['index'].nil?
+
+          _id = args.delete('id')
+          _index = args.delete('index')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'GET'
+          url     = Utils.build_url(_index, '_source', _id)
+
+          Utils.validate_query_params! args, GET_SOURCE_QUERY_PARAMS
+          transport.perform_request(method, url, args, body, headers).body
+        end
+
+        GET_SOURCE_QUERY_PARAMS = Set.new(%w[
+          _source
+          _source_excludes
+          _source_includes
+          preference
+          realtime
+          refresh
+          routing
+          version
+          version_type
+        ]).freeze
       end
-
-      # Register this action with its valid params when the module is loaded.
-      #
-      # @since 6.2.0
-      ParamsRegistry.register(:get_source, %i[
-        preference
-        realtime
-        refresh
-        routing
-        _source
-        _source_excludes
-        _source_includes
-        version
-        version_type
-      ].freeze)
     end
   end
 end

data/lib/opensearch/api/actions/index.rb

@@ -3,94 +3,63 @@
 # The OpenSearch Contributors require contributions made to
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
-#
-# Modifications Copyright OpenSearch Contributors. See
-# GitHub history for details.
-#
-# 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 OpenSearch
-  module API
-    module Actions
-      # Creates or updates a document in an index.
-      #
-      # @option arguments [String] :id Document ID
-      # @option arguments [String] :index The name of the index
-      # @option arguments [String] :wait_for_active_shards Sets the number of shard copies that must be active before proceeding with the index operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)
-      # @option arguments [String] :op_type Explicit operation type. Defaults to `index` for requests with an explicit document ID, and to `create`for requests without an explicit document ID (options: index, create)
-      # @option arguments [String] :refresh If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes. (options: true, false, wait_for)
-      # @option arguments [String] :routing Specific routing value
-      # @option arguments [Time] :timeout Explicit operation timeout
-      # @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 [Number] :if_seq_no only perform the index operation if the last operation that has changed the document has the specified sequence number
-      # @option arguments [Number] :if_primary_term only perform the index operation if the last operation that has changed the document has the specified primary term
-      # @option arguments [String] :pipeline The pipeline id to preprocess incoming documents with
-      # @option arguments [Boolean] :require_alias When true, requires destination to be an alias. Default is false
-      # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body The document (*Required*)
-      #
-      # *Deprecation notice*:
-      # Specifying types in urls has been deprecated
-      # Deprecated since version 7.0.0
-      #
-      #
-      #
-      def index(arguments = {})
-        raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
-        raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
 
-        headers = arguments.delete(:headers) || {}
+# frozen_string_literal: true
 
-        arguments = arguments.clone
+module OpenSearch
+  module API
+    module Root
+      module Actions
+        # Creates or updates a document in an index.
+        #
+        # @option args [String] :index *Required* Name of the data stream or index to target.
+        # @option args [Integer] :if_primary_term Only perform the operation if the document has this primary term.
+        # @option args [Integer] :if_seq_no Only perform the operation if the document has this sequence number.
+        # @option args [String] :op_type Set to create to only index the document if it does not already exist (put if absent). If a document with the specified `_id` already exists, the indexing operation will fail. Same as using the `<index>/_create` endpoint. Valid values: `index`, `create`. If document id is specified, it defaults to `index`. Otherwise, it defaults to `create`.
+        # @option args [String] :pipeline ID of the pipeline to use to preprocess incoming documents. If the index has a default ingest pipeline specified, then setting the value to `_none` disables the default ingest pipeline for this request. If a final pipeline is configured it will always run, regardless of the value of this parameter.
+        # @option args [Boolean, String] :refresh If `true`, OpenSearch refreshes the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` do nothing with refreshes. Valid values: `true`, `false`, `wait_for`.
+        # @option args [Boolean] :require_alias If `true`, the destination must be an index alias.
+        # @option args [Enumerable<String>, String] :routing Custom value used to route operations to a specific shard.
+        # @option args [String] :timeout Period the request waits for the following operations: automatic index creation, dynamic mapping updates, waiting for active shards.
+        # @option args [Integer] :version Explicit version number for concurrency control. The specified version must match the current version of the document for the request to succeed.
+        # @option args [String] :version_type Specific version type: `external`, `external_gte`.
+        # @option args [Integer, String] :wait_for_active_shards The number of shard copies that must be active before proceeding with the operation. Set to all or any positive integer up to the total number of shards in the index (`number_of_replicas+1`).
+        # @option args [String] :id Unique identifier for the document.
+        # @option args [Hash] :body *Required* The document
+        def index(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'index' missing" if args['index'].nil?
+          raise ArgumentError, "Required argument 'body' missing" if args['body'].nil?
 
-        _id = arguments.delete(:id)
+          _index = args.delete('index')
+          _id = args.delete('id')
 
-        _index = arguments.delete(:index)
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = _id.nil? ? 'POST' : 'PUT'
+          url     = Utils.build_url(_index, '_doc', _id)
 
-        method = _id ? OpenSearch::API::HTTP_PUT : OpenSearch::API::HTTP_POST
-        path   = if _index && _id
-                   "#{Utils.__listify(_index)}/_doc/#{Utils.__listify(_id)}"
-                 else
-                   "#{Utils.__listify(_index)}/_doc"
-                 end
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
+          Utils.validate_query_params! args, INDEX_QUERY_PARAMS
+          transport.perform_request(method, url, args, body, headers).body
+        end
 
-        body = arguments[:body]
-        perform_request(method, path, params, body, headers).body
+        INDEX_QUERY_PARAMS = Set.new(%w[
+          if_primary_term
+          if_seq_no
+          op_type
+          pipeline
+          refresh
+          require_alias
+          routing
+          timeout
+          version
+          version_type
+          wait_for_active_shards
+        ]).freeze
       end
-
-      # Register this action with its valid params when the module is loaded.
-      #
-      # @since 6.2.0
-      ParamsRegistry.register(:index, %i[
-        wait_for_active_shards
-        op_type
-        refresh
-        routing
-        timeout
-        version
-        version_type
-        if_seq_no
-        if_primary_term
-        pipeline
-        require_alias
-      ].freeze)
     end
   end
 end

data/lib/opensearch/api/actions/indices/add_block.rb

@@ -3,26 +3,11 @@
 # The OpenSearch Contributors require contributions made to
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
-#
-# Modifications Copyright OpenSearch Contributors. See
-# GitHub history for details.
-#
-# 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.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
 
 module OpenSearch
   module API
@@ -30,48 +15,39 @@ module OpenSearch
       module Actions
         # Adds a block to an index.
         #
-        # @option arguments [List] :index A comma separated list of indices to add a block to
-        # @option arguments [String] :block The block to add (one of read, write, read_only or metadata)
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [Time] :master_timeout (DEPRECATED: use cluster_manager_timeout instead) Specify timeout for connection to master
-        # @option arguments [Time] :cluster_manager_timeout Specify timeout for connection to cluster_manager
-        # @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 [Hash] :headers Custom HTTP headers
-        #
-        #
-        def add_block(arguments = {})
-          raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
-          raise ArgumentError, "Required argument 'block' missing" unless arguments[:block]
-
-          headers = arguments.delete(:headers) || {}
-
-          arguments = arguments.clone
-
-          _index = arguments.delete(:index)
-
-          _block = arguments.delete(:block)
-
-          method = OpenSearch::API::HTTP_PUT
-          path   = "#{Utils.__listify(_index)}/_block/#{Utils.__listify(_block)}"
-          params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-
-          body = nil
-          perform_request(method, path, params, body, headers).body
+        # @option args [String] :block *Required* The block to add (one of `read`, `write`, `read_only` or `metadata`).
+        # @option args [Enumerable<String>, String] :index *Required* A comma separated list of indexes to add a block to.
+        # @option args [Boolean] :allow_no_indices Whether to ignore if a wildcard indexes expression resolves into no concrete indexes. (This includes `_all` string or when no indexes have been specified).
+        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
+        # @option args [Enumerable<String>, String] :expand_wildcards Whether to expand wildcard expression to concrete indexes that are open, closed or both.
+        # @option args [Boolean] :ignore_unavailable Whether specified concrete indexes should be ignored when unavailable (missing or closed).
+        # @option args [String] :master_timeout DEPRECATED Specify timeout for connection to cluster manager.
+        # @option args [String] :timeout Explicit operation timeout
+        def add_block(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'block' missing" if args['block'].nil?
+          raise ArgumentError, "Required argument 'index' missing" if args['index'].nil?
+
+          _block = args.delete('block')
+          _index = args.delete('index')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'PUT'
+          url     = Utils.build_url(_index, '_block', _block)
+
+          Utils.validate_query_params! args, ADD_BLOCK_QUERY_PARAMS
+          transport.perform_request(method, url, args, body, headers).body
         end
 
-        # Register this action with its valid params when the module is loaded.
-        #
-        # @since 6.2.0
-        ParamsRegistry.register(:add_block, %i[
-          timeout
-          master_timeout
-          cluster_manager_timeout
-          ignore_unavailable
+        ADD_BLOCK_QUERY_PARAMS = Set.new(%w[
           allow_no_indices
+          cluster_manager_timeout
           expand_wildcards
-        ].freeze)
+          ignore_unavailable
+          master_timeout
+          timeout
+        ]).freeze
       end
     end
   end

data/lib/opensearch/api/actions/indices/analyze.rb

@@ -3,26 +3,11 @@
 # The OpenSearch Contributors require contributions made to
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
-#
-# Modifications Copyright OpenSearch Contributors. See
-# GitHub history for details.
-#
-# 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.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
 
 module OpenSearch
   module API
@@ -30,41 +15,20 @@ module OpenSearch
       module Actions
         # Performs the analysis process on a text and return the tokens breakdown of the text.
         #
-        # @option arguments [String] :index The name of the index to scope the operation
-        # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body Define analyzer/tokenizer parameters and the text on which the analysis should be performed
-        #
-        #
-        def analyze(arguments = {})
-          headers = arguments.delete(:headers) || {}
-
-          arguments = arguments.clone
-
-          _index = arguments.delete(:index)
+        # @option args [String] :index The name of the index to scope the operation.
+        # @option args [Hash] :body Define analyzer/tokenizer parameters and the text on which the analysis should be performed
+        def analyze(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          _index = args.delete('index')
 
-          method = if arguments[:body]
-                     OpenSearch::API::HTTP_POST
-                   else
-                     OpenSearch::API::HTTP_GET
-                   end
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = body ? 'POST' : 'GET'
+          url     = Utils.build_url(_index, '_analyze')
 
-          path = if _index
-                   "#{Utils.__listify(_index)}/_analyze"
-                 else
-                   '_analyze'
-                 end
-          params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-
-          body = arguments[:body]
-          perform_request(method, path, params, body, headers).body
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
         end
-
-        # Register this action with its valid params when the module is loaded.
-        #
-        # @since 6.2.0
-        ParamsRegistry.register(:analyze, [
-          :index
-        ].freeze)
       end
     end
   end

data/lib/opensearch/api/actions/indices/clear_cache.rb

@@ -3,76 +3,50 @@
 # The OpenSearch Contributors require contributions made to
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
-#
-# Modifications Copyright OpenSearch Contributors. See
-# GitHub history for details.
-#
-# 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.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
 
 module OpenSearch
   module API
     module Indices
       module Actions
-        # Clears all or specific caches for one or more indices.
-        #
-        # @option arguments [List] :index A comma-separated list of index name to limit the operation
-        # @option arguments [Boolean] :fielddata Clear field data
-        # @option arguments [List] :fields A comma-separated list of fields to clear when using the `fielddata` parameter (default: all)
-        # @option arguments [Boolean] :query Clear query caches
-        # @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 [Boolean] :request Clear request cache
-        # @option arguments [Hash] :headers Custom HTTP headers
+        # Clears all or specific caches for one or more indexes.
         #
-        #
-        def clear_cache(arguments = {})
-          headers = arguments.delete(:headers) || {}
-
-          arguments = arguments.clone
+        # @option args [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 indexes. This behavior applies even if the request targets other open indexes.
+        # @option args [Enumerable<String>, String] :expand_wildcards 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. Supports comma-separated values, such as `open,hidden`. Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
+        # @option args [Boolean] :fielddata If `true`, clears the fields cache. Use the `fields` parameter to clear the cache of specific fields only.
+        # @option args [Enumerable<String>, String] :fields Comma-separated list of field names used to limit the `fielddata` parameter.
+        # @option args [Boolean] :file If `true`, clears the unused entries from the file cache on nodes with the Search role.
+        # @option args [Boolean] :ignore_unavailable If `false`, the request returns an error if it targets a missing or closed index.
+        # @option args [Enumerable<String>] :index Comma-separated list of indexes; use `_all` or empty string to perform the operation on all indexes.
+        # @option args [Boolean] :query If `true`, clears the query cache.
+        # @option args [Boolean] :request If `true`, clears the request cache.
+        def clear_cache(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          _index = args.delete('index')
 
-          _index = arguments.delete(:index)
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'POST'
+          url     = Utils.build_url(_index, '_cache/clear')
 
-          method = OpenSearch::API::HTTP_POST
-          path   = if _index
-                     "#{Utils.__listify(_index)}/_cache/clear"
-                   else
-                     '_cache/clear'
-                   end
-          params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-
-          body = nil
-          perform_request(method, path, params, body, headers).body
+          Utils.validate_query_params! args, CLEAR_CACHE_QUERY_PARAMS
+          transport.perform_request(method, url, args, body, headers).body
         end
 
-        # Register this action with its valid params when the module is loaded.
-        #
-        # @since 6.2.0
-        ParamsRegistry.register(:clear_cache, %i[
+        CLEAR_CACHE_QUERY_PARAMS = Set.new(%w[
+          allow_no_indices
+          expand_wildcards
           fielddata
           fields
-          query
+          file
           ignore_unavailable
-          allow_no_indices
-          expand_wildcards
-          index
+          query
           request
-        ].freeze)
+        ]).freeze
       end
     end
   end