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

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

@@ -3,131 +3,105 @@
 # 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 Actions
-      # Deletes documents matching the provided query.
-      #
-      # @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 (*Required*)
-      # @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)
-      # @option arguments [String] :default_operator The default operator for query string query (AND or OR) (options: AND, OR)
-      # @option arguments [String] :df The field to use as default where no field prefix is given in the query string
-      # @option arguments [Number] :from Starting offset (default: 0)
-      # @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] :conflicts What to do when the delete by query hits version conflicts? (options: abort, proceed)
-      # @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] :lenient Specify whether format-based query failures (such as providing text to a numeric field) should be ignored
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on (default: random)
-      # @option arguments [String] :q Query in the Lucene query string syntax
-      # @option arguments [List] :routing A comma-separated list of specific routing values
-      # @option arguments [Time] :scroll Specify how long a consistent view of the index should be maintained for scrolled search
-      # @option arguments [String] :search_type Search operation type (options: query_then_fetch, dfs_query_then_fetch)
-      # @option arguments [Time] :search_timeout Explicit timeout for each search request. Defaults to no timeout.
-      # @option arguments [Number] :size Deprecated, please use `max_docs` instead
-      # @option arguments [Number] :max_docs Maximum number of documents to process (default: all documents)
-      # @option arguments [List] :sort A comma-separated list of <field>:<direction> pairs
-      # @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] :terminate_after The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.
-      # @option arguments [List] :stats Specific 'tag' of the request for logging and statistical purposes
-      # @option arguments [Boolean] :version Specify whether to return document version as part of a hit
-      # @option arguments [Boolean] :request_cache Specify if request cache should be used for this request or not, defaults to index level setting
-      # @option arguments [Boolean] :refresh Should the effected indexes be refreshed?
-      # @option arguments [Time] :timeout Time each individual bulk request should wait for shards that are unavailable.
-      # @option arguments [String] :wait_for_active_shards Sets the number of shard copies that must be active before proceeding with the delete by query 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 [Number] :scroll_size Size on the scroll request powering the delete by query
-      # @option arguments [Boolean] :wait_for_completion Should the request should block until the delete by query is complete.
-      # @option arguments [Number] :requests_per_second The throttle for this request in sub-requests per second. -1 means no throttle.
-      # @option arguments [Number|string] :slices The number of slices this task should be divided into. Defaults to 1, meaning the task isn't sliced into subtasks. Can be set to `auto`.
-      # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body The search definition using the Query DSL (*Required*)
-      #
-      # *Deprecation notice*:
-      # Specifying types in urls has been deprecated
-      # Deprecated since version 7.0.0
-      #
-      #
-      #
-      def delete_by_query(arguments = {})
-        raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
-        raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
+    module Root
+      module Actions
+        # Deletes documents matching the provided query.
+        #
+        # @option args [Enumerable<String>, String] :index *Required* Comma-separated list of data streams, indexes, and aliases to search. Supports wildcards (`*`). To search all data streams or indexes, omit this parameter or use `*` or `_all`.
+        # @option args [Enumerable<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>] :_source_excludes List of fields to exclude from the returned `_source` field.
+        # @option args [Enumerable<String>] :_source_includes List of fields to extract and return from the `_source` field.
+        # @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. For example, a request targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`.
+        # @option args [Boolean] :analyze_wildcard If `true`, wildcard and prefix queries are analyzed.
+        # @option args [String] :analyzer Analyzer to use for the query string.
+        # @option args [String] :conflicts What to do if delete by query hits version conflicts: `abort` or `proceed`.
+        # @option args [String] :default_operator The default operator for query string query: `AND` or `OR`.
+        # @option args [String] :df Field to use as default where no field prefix is given in the query string.
+        # @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 [Integer] :from (default: 0) Starting offset.
+        # @option args [Boolean] :ignore_unavailable If `false`, the request returns an error if it targets a missing or closed index.
+        # @option args [Boolean] :lenient If `true`, format-based query failures (such as providing text to a numeric field) in the query string will be ignored.
+        # @option args [Integer] :max_docs Maximum number of documents to process. Defaults to all documents.
+        # @option args [String] :preference (default: random) Specifies the node or shard the operation should be performed on. Random by default.
+        # @option args [String] :q Query in the Lucene query string syntax.
+        # @option args [Boolean, String] :refresh If `true`, OpenSearch refreshes all shards involved in the delete by query after the request completes.
+        # @option args [Boolean] :request_cache If `true`, the request cache is used for this request. Defaults to the index-level setting.
+        # @option args [Float] :requests_per_second (default: 0) The throttle for this request in sub-requests per second.
+        # @option args [Enumerable<String>, String] :routing Custom value used to route operations to a specific shard.
+        # @option args [String] :scroll Period to retain the search context for scrolling.
+        # @option args [Integer] :scroll_size (default: 100) Size of the scroll request that powers the operation.
+        # @option args [String] :search_timeout Explicit timeout for each search request. Defaults to no timeout.
+        # @option args [String] :search_type The type of the search operation. Available options: `query_then_fetch`, `dfs_query_then_fetch`.
+        # @option args [Integer] :size Deprecated, use `max_docs` instead.
+        # @option args [Float, String] :slices The number of slices this task should be divided into.
+        # @option args [Enumerable<String>] :sort A comma-separated list of <field>:<direction> pairs.
+        # @option args [Enumerable<String>] :stats Specific `tag` of the request for logging and statistical purposes.
+        # @option args [Integer] :terminate_after Maximum number of documents to collect for each shard. If a query reaches this limit, OpenSearch terminates the query early. OpenSearch collects documents before sorting. Use with caution. OpenSearch applies this parameter to each shard handling the request. When possible, let OpenSearch perform early termination automatically. Avoid specifying this parameter for requests that target data streams with backing indexes across multiple data tiers.
+        # @option args [String] :timeout Period each deletion request waits for active shards.
+        # @option args [Boolean] :version If `true`, returns the document version as part of a hit.
+        # @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 [Boolean] :wait_for_completion (default: true) If `true`, the request blocks until the operation is complete.
+        # @option args [Hash] :body *Required* The search definition using the Query DSL
+        def delete_by_query(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?
 
-        headers = arguments.delete(:headers) || {}
+          _index = args.delete('index')
 
-        arguments = arguments.clone
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'POST'
+          url     = Utils.build_url(_index, '_delete_by_query')
 
-        _index = arguments.delete(:index)
+          Utils.validate_query_params! args, DELETE_BY_QUERY_QUERY_PARAMS
+          transport.perform_request(method, url, args, body, headers).body
+        end
 
-        method = OpenSearch::API::HTTP_POST
-        path   = "#{Utils.__listify(_index)}/_delete_by_query"
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-
-        body = arguments[:body]
-        perform_request(method, path, params, body, headers).body
+        DELETE_BY_QUERY_QUERY_PARAMS = Set.new(%w[
+          _source
+          _source_excludes
+          _source_includes
+          allow_no_indices
+          analyze_wildcard
+          analyzer
+          conflicts
+          default_operator
+          df
+          expand_wildcards
+          from
+          ignore_unavailable
+          lenient
+          max_docs
+          preference
+          q
+          refresh
+          request_cache
+          requests_per_second
+          routing
+          scroll
+          scroll_size
+          search_timeout
+          search_type
+          size
+          slices
+          sort
+          stats
+          terminate_after
+          timeout
+          version
+          wait_for_active_shards
+          wait_for_completion
+        ]).freeze
       end
-
-      # Register this action with its valid params when the module is loaded.
-      #
-      # @since 6.2.0
-      ParamsRegistry.register(:delete_by_query, %i[
-        analyzer
-        analyze_wildcard
-        default_operator
-        df
-        from
-        ignore_unavailable
-        allow_no_indices
-        conflicts
-        expand_wildcards
-        lenient
-        preference
-        q
-        routing
-        scroll
-        search_type
-        search_timeout
-        size
-        max_docs
-        sort
-        _source
-        _source_excludes
-        _source_includes
-        terminate_after
-        stats
-        version
-        request_cache
-        refresh
-        timeout
-        wait_for_active_shards
-        scroll_size
-        wait_for_completion
-        requests_per_second
-        slices
-      ].freeze)
     end
   end
 end

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

@@ -3,60 +3,39 @@
 # 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 Actions
-      # Changes the number of requests per second for a particular Delete By Query operation.
-      #
-      # @option arguments [String] :task_id The task id to rethrottle
-      # @option arguments [Number] :requests_per_second The throttle to set on this request in floating sub-requests per second. -1 means set no throttle. (*Required*)
-      # @option arguments [Hash] :headers Custom HTTP headers
-      #
-      #
-      def delete_by_query_rethrottle(arguments = {})
-        raise ArgumentError, "Required argument 'task_id' missing" unless arguments[:task_id]
+    module Root
+      module Actions
+        # Changes the number of requests per second for a particular Delete By Query operation.
+        #
+        # @option args [Float, String] :task_id *Required* The ID for the task.
+        # @option args [Float] :requests_per_second The throttle for this request in sub-requests per second.
+        def delete_by_query_rethrottle(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'task_id' missing" if args['task_id'].nil?
 
-        headers = arguments.delete(:headers) || {}
+          _task_id = args.delete('task_id')
 
-        arguments = arguments.clone
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'POST'
+          url     = Utils.build_url('_delete_by_query', _task_id, '_rethrottle')
 
-        _task_id = arguments.delete(:task_id)
+          Utils.validate_query_params! args, DELETE_BY_QUERY_RETHROTTLE_QUERY_PARAMS
+          transport.perform_request(method, url, args, body, headers).body
+        end
 
-        method = OpenSearch::API::HTTP_POST
-        path   = "_delete_by_query/#{Utils.__listify(_task_id)}/_rethrottle"
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-
-        body = nil
-        perform_request(method, path, params, body, headers).body
+        DELETE_BY_QUERY_RETHROTTLE_QUERY_PARAMS = Set.new(%w[
+          requests_per_second
+        ]).freeze
       end
-
-      # Register this action with its valid params when the module is loaded.
-      #
-      # @since 6.2.0
-      ParamsRegistry.register(:delete_by_query_rethrottle, [
-        :requests_per_second
-      ].freeze)
     end
   end
 end

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

@@ -3,28 +3,32 @@
 # 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.
+
+# 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 Actions
-      # Deletes one or several PITs.
-      #
-      # @option arguments [Hash] body: Must include `pit_id`, which is an array of PIT IDs to be deleted. (required)
-      def delete_pit(arguments = {})
-        raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
+    module Root
+      module Actions
+        # Deletes one or more point in time searches based on the IDs passed.
+        #
+        # @option args [Hash] :body The point-in-time ids to be deleted
+        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
+        def delete_pit(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          ignore  = args.delete('ignore') || []
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'DELETE'
+          url     = '_search/point_in_time'
 
-        method = OpenSearch::API::HTTP_DELETE
-        path = '_search/point_in_time'
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-        body = arguments[:body]
-
-        perform_request(method, path, params, body).body
+          Utils.validate_query_params! args
+          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+        end
       end
-
-      ParamsRegistry.register(:delete_pit, [].freeze)
     end
   end
 end

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

@@ -3,64 +3,45 @@
 # 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 Actions
-      # Deletes a script.
-      #
-      # @option arguments [String] :id Script ID
-      # @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 [Hash] :headers Custom HTTP headers
-      #
-      #
-      def delete_script(arguments = {})
-        raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
+    module Root
+      module Actions
+        # Deletes a script.
+        #
+        # @option args [String] :id *Required* Identifier for the stored script or search template.
+        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
+        # @option args [String] :master_timeout DEPRECATED Period to wait for a connection to the cluster-manager node. If no response is received before the timeout expires, the request fails and returns an error.
+        # @option args [String] :timeout Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
+        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
+        def delete_script(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'id' missing" if args['id'].nil?
 
-        headers = arguments.delete(:headers) || {}
+          _id = args.delete('id')
 
-        arguments = arguments.clone
+          ignore  = args.delete('ignore') || []
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'DELETE'
+          url     = Utils.build_url('_scripts', _id)
 
-        _id = arguments.delete(:id)
+          Utils.validate_query_params! args, DELETE_SCRIPT_QUERY_PARAMS
+          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+        end
 
-        method = OpenSearch::API::HTTP_DELETE
-        path   = "_scripts/#{Utils.__listify(_id)}"
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-
-        body = nil
-        perform_request(method, path, params, body, headers).body
+        DELETE_SCRIPT_QUERY_PARAMS = Set.new(%w[
+          cluster_manager_timeout
+          master_timeout
+          timeout
+        ]).freeze
       end
-
-      # Register this action with its valid params when the module is loaded.
-      #
-      # @since 6.2.0
-      ParamsRegistry.register(:delete_script, %i[
-        timeout
-        master_timeout
-        cluster_manager_timeout
-      ].freeze)
     end
   end
 end

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

@@ -3,92 +3,60 @@
 # 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 information about whether a document exists in an index.
-      #
-      # @option arguments [String] :id The document ID
-      # @option arguments [String] :index The name of 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, force)
-      # @option arguments [Hash] :headers Custom HTTP headers
-      #
-      # *Deprecation notice*:
-      # Specifying types in urls has been deprecated
-      # Deprecated since version 7.0.0
-      #
-      #
-      #
-      def exists(arguments = {})
-        raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
-        raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
-
-        headers = arguments.delete(:headers) || {}
 
-        arguments = arguments.clone
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
 
-        _id = arguments.delete(:id)
+# frozen_string_literal: true
 
-        _index = arguments.delete(:index)
-
-        method = OpenSearch::API::HTTP_HEAD
-        path   = "#{Utils.__listify(_index)}/_doc/#{Utils.__listify(_id)}"
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-
-        body = nil
-
-        Utils.__rescue_from_not_found do
-          perform_request(method, path, params, body, headers).status == 200
+module OpenSearch
+  module API
+    module Root
+      module Actions
+        # Returns information about whether a document exists in an index.
+        #
+        # @option args [String] :id *Required* Identifier of the document.
+        # @option args [String] :index *Required* Comma-separated list of data streams, indexes, and aliases. Supports wildcards (`*`).
+        # @option args [Boolean, Enumerable<String>, String] :_source `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 If `true`, the request is real-time as opposed to near-real-time.
+        # @option args [Boolean, String] :refresh If `true`, OpenSearch refreshes all shards involved in the delete by query after the request completes.
+        # @option args [Enumerable<String>, String] :routing Target the specified primary shard.
+        # @option args [Enumerable<String>, String] :stored_fields 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.
+        # @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`.
+        def exists(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  = 'HEAD'
+          url     = Utils.build_url(_index, '_doc', _id)
+
+          Utils.validate_query_params! args, EXISTS_QUERY_PARAMS
+          transport.perform_head_request method, url, args, body, headers
         end
-      end
 
-      alias exists? exists
-
-      # Register this action with its valid params when the module is loaded.
-      #
-      # @since 6.2.0
-      ParamsRegistry.register(:exists, %i[
-        stored_fields
-        preference
-        realtime
-        refresh
-        routing
-        _source
-        _source_excludes
-        _source_includes
-        version
-        version_type
-      ].freeze)
+        EXISTS_QUERY_PARAMS = Set.new(%w[
+          _source
+          _source_excludes
+          _source_includes
+          preference
+          realtime
+          refresh
+          routing
+          stored_fields
+          version
+          version_type
+        ]).freeze
+      end
     end
   end
 end