elasticsearch-serverless 0.5.0 → 0.7.0

data/lib/elasticsearch-serverless/api/security/update_api_key.rb

@@ -0,0 +1,74 @@
+# 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.
+#
+# Auto generated from commit f284cc16f4d4b4289bc679aa1529bb504190fe80
+# @see https://github.com/elastic/elasticsearch-specification
+#
+module ElasticsearchServerless
+  module API
+    module Security
+      module Actions
+        # Update an API key.
+        # Update attributes of an existing API key.
+        # This API supports updates to an API key's access scope, expiration, and metadata.
+        # To use this API, you must have at least the +manage_own_api_key+ cluster privilege.
+        # Users can only update API keys that they created or that were granted to them.
+        # To update another user’s API key, use the +run_as+ feature to submit a request on behalf of another user.
+        # IMPORTANT: It's not possible to use an API key as the authentication credential for this API. The owner user’s credentials are required.
+        # Use this API to update API keys created by the create API key or grant API Key APIs.
+        # If you need to apply the same update to many API keys, you can use the bulk update API keys API to reduce overhead.
+        # It's not possible to update expired API keys or API keys that have been invalidated by the invalidate API key API.
+        # The access scope of an API key is derived from the +role_descriptors+ you specify in the request and a snapshot of the owner user's permissions at the time of the request.
+        # The snapshot of the owner's permissions is updated automatically on every call.
+        # IMPORTANT: If you don't specify +role_descriptors+ in the request, a call to this API might still change the API key's access scope.
+        # This change can occur if the owner user's permissions have changed since the API key was created or last modified.
+        #
+        # @option arguments [String] :id The ID of the API key to update. (*Required*)
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body request body
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-update-api-key
+        #
+        def update_api_key(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'security.update_api_key' }
+
+          defined_params = [:id].each_with_object({}) do |variable, set_variables|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
+          raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = arguments.delete(:body)
+
+          _id = arguments.delete(:id)
+
+          method = ElasticsearchServerless::API::HTTP_PUT
+          path   = "_security/api_key/#{Utils.listify(_id)}"
+          params = {}
+
+          ElasticsearchServerless::API::Response.new(
+            perform_request(method, path, params, body, headers, request_opts)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch-serverless/api/sql/clear_cursor.rb

@@ -22,15 +22,15 @@ module ElasticsearchServerless
   module API
     module SQL
       module Actions
-        # Clears the SQL cursor
+        # Clear an SQL search cursor.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/clear-sql-cursor-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-sql-clear-cursor
         #
         def clear_cursor(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "sql.clear_cursor" }
+          request_opts = { endpoint: arguments[:endpoint] || 'sql.clear_cursor' }
 
           raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
 
@@ -40,7 +40,7 @@ module ElasticsearchServerless
           body = arguments.delete(:body)
 
           method = ElasticsearchServerless::API::HTTP_POST
-          path   = "_sql/close"
+          path   = '_sql/close'
           params = {}
 
           ElasticsearchServerless::API::Response.new(

data/lib/elasticsearch-serverless/api/sql/delete_async.rb

@@ -22,19 +22,23 @@ module ElasticsearchServerless
   module API
     module SQL
       module Actions
-        # Deletes an async SQL search or a stored synchronous SQL search. If the search is still running, the API cancels it.
+        # Delete an async SQL search.
+        # Delete an async SQL search or a stored synchronous SQL search.
+        # If the search is still running, the API cancels it.
+        # If the Elasticsearch security features are enabled, only the following users can use this API to delete a search:
+        # * Users with the +cancel_task+ cluster privilege.
+        # * The user who first submitted the search.
         #
-        # @option arguments [String] :id Identifier for the search. (*Required*)
+        # @option arguments [String] :id The identifier for the search. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-async-sql-search-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-sql-delete-async
         #
         def delete_async(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "sql.delete_async" }
+          request_opts = { endpoint: arguments[:endpoint] || 'sql.delete_async' }
 
-          defined_params = [:id].inject({}) do |set_variables, variable|
+          defined_params = [:id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/sql/get_async.rb

@@ -22,26 +22,29 @@ module ElasticsearchServerless
   module API
     module SQL
       module Actions
-        # Returns the current status and available results for an async SQL search or stored synchronous SQL search
+        # Get async SQL search results.
+        # Get the current status and available results for an async SQL search or stored synchronous SQL search.
+        # If the Elasticsearch security features are enabled, only the user who first submitted the SQL search can retrieve the search using this API.
         #
-        # @option arguments [String] :id Identifier for the search. (*Required*)
-        # @option arguments [String] :delimiter Separator for CSV results. The API only supports this parameter for CSV responses. Server default: ,.
-        # @option arguments [String] :format Format for the response. You must specify a format using this parameter or the
-        #  Accept HTTP header. If you specify both, the API uses this parameter.
-        # @option arguments [Time] :keep_alive Retention period for the search and its results. Defaults
-        #  to the +keep_alive+ period for the original SQL search.
-        # @option arguments [Time] :wait_for_completion_timeout Period to wait for complete results. Defaults to no timeout,
-        #  meaning the request waits for complete search results.
+        # @option arguments [String] :id The identifier for the search. (*Required*)
+        # @option arguments [String] :delimiter The separator for CSV results.
+        #  The API supports this parameter only for CSV responses. Server default: ,.
+        # @option arguments [String] :format The format for the response.
+        #  You must specify a format using this parameter or the +Accept+ HTTP header.
+        #  If you specify both, the API uses this parameter.
+        # @option arguments [Time] :keep_alive The retention period for the search and its results.
+        #  It defaults to the +keep_alive+ period for the original SQL search.
+        # @option arguments [Time] :wait_for_completion_timeout The period to wait for complete results.
+        #  It defaults to no timeout, meaning the request waits for complete search results.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/get-async-sql-search-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-sql-get-async
         #
         def get_async(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "sql.get_async" }
+          request_opts = { endpoint: arguments[:endpoint] || 'sql.get_async' }
 
-          defined_params = [:id].inject({}) do |set_variables, variable|
+          defined_params = [:id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/sql/get_async_status.rb

@@ -22,19 +22,19 @@ module ElasticsearchServerless
   module API
     module SQL
       module Actions
-        # Returns the current status of an async SQL search or a stored synchronous SQL search
+        # Get the async SQL search status.
+        # Get the current status of an async SQL search or a stored synchronous SQL search.
         #
-        # @option arguments [String] :id Identifier for the search. (*Required*)
+        # @option arguments [String] :id The identifier for the search. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/get-async-sql-search-status-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-sql-get-async-status
         #
         def get_async_status(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "sql.get_async_status" }
+          request_opts = { endpoint: arguments[:endpoint] || 'sql.get_async_status' }
 
-          defined_params = [:id].inject({}) do |set_variables, variable|
+          defined_params = [:id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/sql/query.rb

@@ -22,16 +22,19 @@ module ElasticsearchServerless
   module API
     module SQL
       module Actions
-        # Executes a SQL request
+        # Get SQL search results.
+        # Run an SQL request.
         #
-        # @option arguments [String] :format Format for the response.
+        # @option arguments [String] :format The format for the response.
+        #  You can also specify a format using the +Accept+ HTTP header.
+        #  If you specify both this parameter and the +Accept+ HTTP header, this parameter takes precedence.
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/sql-search-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-sql-query
         #
         def query(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "sql.query" }
+          request_opts = { endpoint: arguments[:endpoint] || 'sql.query' }
 
           raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
 
@@ -41,7 +44,7 @@ module ElasticsearchServerless
           body = arguments.delete(:body)
 
           method = ElasticsearchServerless::API::HTTP_POST
-          path   = "_sql"
+          path   = '_sql'
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(

data/lib/elasticsearch-serverless/api/sql/translate.rb

@@ -22,15 +22,17 @@ module ElasticsearchServerless
   module API
     module SQL
       module Actions
-        # Translates SQL into Elasticsearch queries
+        # Translate SQL into Elasticsearch queries.
+        # Translate an SQL search into a search API request containing Query DSL.
+        # It accepts the same request body parameters as the SQL search API, excluding +cursor+.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/sql-translate-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-sql-translate
         #
         def translate(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "sql.translate" }
+          request_opts = { endpoint: arguments[:endpoint] || 'sql.translate' }
 
           raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
 
@@ -40,7 +42,7 @@ module ElasticsearchServerless
           body = arguments.delete(:body)
 
           method = ElasticsearchServerless::API::HTTP_POST
-          path   = "_sql/translate"
+          path   = '_sql/translate'
           params = {}
 
           ElasticsearchServerless::API::Response.new(

data/lib/elasticsearch-serverless/api/synonyms/delete_synonym.rb

@@ -22,19 +22,30 @@ module ElasticsearchServerless
   module API
     module Synonyms
       module Actions
-        # Deletes a synonym set
+        # Delete a synonym set.
+        # You can only delete a synonyms set that is not in use by any index analyzer.
+        # Synonyms sets can be used in synonym graph token filters and synonym token filters.
+        # These synonym filters can be used as part of search analyzers.
+        # Analyzers need to be loaded when an index is restored (such as when a node starts, or the index becomes open).
+        # Even if the analyzer is not used on any field mapping, it still needs to be loaded on the index recovery phase.
+        # If any analyzers cannot be loaded, the index becomes unavailable and the cluster status becomes red or yellow as index shards are not available.
+        # To prevent that, synonyms sets that are used in analyzers can't be deleted.
+        # A delete request in this case will return a 400 response code.
+        # To remove a synonyms set, you must first remove all indices that contain analyzers using it.
+        # You can migrate an index by creating a new index that does not contain the token filter with the synonyms set, and use the reindex API in order to copy over the index data.
+        # Once finished, you can delete the index.
+        # When the synonyms set is not used in analyzers, you will be able to delete it.
         #
-        # @option arguments [String] :id The id of the synonyms set to be deleted (*Required*)
+        # @option arguments [String] :id The synonyms set identifier to delete. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-synonyms-set.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-synonyms-delete-synonym
         #
         def delete_synonym(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "synonyms.delete_synonym" }
+          request_opts = { endpoint: arguments[:endpoint] || 'synonyms.delete_synonym' }
 
-          defined_params = [:id].inject({}) do |set_variables, variable|
+          defined_params = [:id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/synonyms/delete_synonym_rule.rb

@@ -22,20 +22,20 @@ module ElasticsearchServerless
   module API
     module Synonyms
       module Actions
-        # Deletes a synonym rule in a synonym set
+        # Delete a synonym rule.
+        # Delete a synonym rule from a synonym set.
         #
-        # @option arguments [String] :set_id The id of the synonym set to be updated (*Required*)
-        # @option arguments [String] :rule_id The id of the synonym rule to be deleted (*Required*)
+        # @option arguments [String] :set_id The ID of the synonym set to update. (*Required*)
+        # @option arguments [String] :rule_id The ID of the synonym rule to delete. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-synonym-rule.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-synonyms-delete-synonym-rule
         #
         def delete_synonym_rule(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "synonyms.delete_synonym_rule" }
+          request_opts = { endpoint: arguments[:endpoint] || 'synonyms.delete_synonym_rule' }
 
-          defined_params = [:set_id, :rule_id].inject({}) do |set_variables, variable|
+          defined_params = [:set_id, :rule_id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/synonyms/get_synonym.rb

@@ -22,21 +22,20 @@ module ElasticsearchServerless
   module API
     module Synonyms
       module Actions
-        # Retrieves a synonym set
+        # Get a synonym set.
         #
-        # @option arguments [String] :id "The id of the synonyms set to be retrieved (*Required*)
-        # @option arguments [Integer] :from Starting offset for query rules to be retrieved Server default: 0.
-        # @option arguments [Integer] :size specifies a max number of query rules to retrieve Server default: 10.
+        # @option arguments [String] :id The synonyms set identifier to retrieve. (*Required*)
+        # @option arguments [Integer] :from The starting offset for query rules to retrieve. Server default: 0.
+        # @option arguments [Integer] :size The max number of query rules to retrieve. Server default: 10.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/get-synonyms-set.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-synonyms-get-synonym
         #
         def get_synonym(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "synonyms.get_synonym" }
+          request_opts = { endpoint: arguments[:endpoint] || 'synonyms.get_synonym' }
 
-          defined_params = [:id].inject({}) do |set_variables, variable|
+          defined_params = [:id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/synonyms/get_synonym_rule.rb

@@ -22,20 +22,20 @@ module ElasticsearchServerless
   module API
     module Synonyms
       module Actions
-        # Retrieves a synonym rule from a synonym set
+        # Get a synonym rule.
+        # Get a synonym rule from a synonym set.
         #
-        # @option arguments [String] :set_id The id of the synonym set to retrieve the synonym rule from (*Required*)
-        # @option arguments [String] :rule_id The id of the synonym rule to retrieve (*Required*)
+        # @option arguments [String] :set_id The ID of the synonym set to retrieve the synonym rule from. (*Required*)
+        # @option arguments [String] :rule_id The ID of the synonym rule to retrieve. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/get-synonym-rule.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-synonyms-get-synonym-rule
         #
         def get_synonym_rule(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "synonyms.get_synonym_rule" }
+          request_opts = { endpoint: arguments[:endpoint] || 'synonyms.get_synonym_rule' }
 
-          defined_params = [:set_id, :rule_id].inject({}) do |set_variables, variable|
+          defined_params = [:set_id, :rule_id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/synonyms/get_synonyms_sets.rb

@@ -22,16 +22,17 @@ module ElasticsearchServerless
   module API
     module Synonyms
       module Actions
-        # Retrieves a summary of all defined synonym sets
+        # Get all synonym sets.
+        # Get a summary of all defined synonym sets.
         #
-        # @option arguments [Integer] :from Starting offset Server default: 0.
-        # @option arguments [Integer] :size specifies a max number of results to get Server default: 10.
+        # @option arguments [Integer] :from The starting offset for synonyms sets to retrieve. Server default: 0.
+        # @option arguments [Integer] :size The maximum number of synonyms sets to retrieve. Server default: 10.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/list-synonyms-sets.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-synonyms-get-synonym
         #
         def get_synonyms_sets(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "synonyms.get_synonyms_sets" }
+          request_opts = { endpoint: arguments[:endpoint] || 'synonyms.get_synonyms_sets' }
 
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
@@ -39,7 +40,7 @@ module ElasticsearchServerless
           body = nil
 
           method = ElasticsearchServerless::API::HTTP_GET
-          path   = "_synonyms"
+          path   = '_synonyms'
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(

data/lib/elasticsearch-serverless/api/synonyms/put_synonym.rb

@@ -22,20 +22,23 @@ module ElasticsearchServerless
   module API
     module Synonyms
       module Actions
-        # Creates or updates a synonym set.
+        # Create or update a synonym set.
+        # Synonyms sets are limited to a maximum of 10,000 synonym rules per set.
+        # If you need to manage more synonym rules, you can create multiple synonym sets.
+        # When an existing synonyms set is updated, the search analyzers that use the synonyms set are reloaded automatically for all indices.
+        # This is equivalent to invoking the reload search analyzers API for all indices that use the synonyms set.
         #
-        # @option arguments [String] :id The id of the synonyms set to be created or updated (*Required*)
+        # @option arguments [String] :id The ID of the synonyms set to be created or updated. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/put-synonyms-set.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-synonyms-put-synonym
         #
         def put_synonym(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "synonyms.put_synonym" }
+          request_opts = { endpoint: arguments[:endpoint] || 'synonyms.put_synonym' }
 
-          defined_params = [:id].inject({}) do |set_variables, variable|
+          defined_params = [:id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/synonyms/put_synonym_rule.rb

@@ -22,21 +22,23 @@ module ElasticsearchServerless
   module API
     module Synonyms
       module Actions
-        # Creates or updates a synonym rule in a synonym set
+        # Create or update a synonym rule.
+        # Create or update a synonym rule in a synonym set.
+        # If any of the synonym rules included is invalid, the API returns an error.
+        # When you update a synonym rule, all analyzers using the synonyms set will be reloaded automatically to reflect the new rule.
         #
-        # @option arguments [String] :set_id The id of the synonym set to be updated with the synonym rule (*Required*)
-        # @option arguments [String] :rule_id The id of the synonym rule to be updated or created (*Required*)
+        # @option arguments [String] :set_id The ID of the synonym set. (*Required*)
+        # @option arguments [String] :rule_id The ID of the synonym rule to be updated or created. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/put-synonym-rule.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-synonyms-put-synonym-rule
         #
         def put_synonym_rule(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "synonyms.put_synonym_rule" }
+          request_opts = { endpoint: arguments[:endpoint] || 'synonyms.put_synonym_rule' }
 
-          defined_params = [:set_id, :rule_id].inject({}) do |set_variables, variable|
+          defined_params = [:set_id, :rule_id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/tasks/get.rb

@@ -23,26 +23,28 @@ module ElasticsearchServerless
     module Tasks
       module Actions
         # Get task information.
-        # Returns information about the tasks currently executing in the cluster.
+        # Get information about a task currently running in the cluster.
+        # WARNING: The task management API is new and should still be considered a beta feature.
+        # The API may change in ways that are not backwards compatible.
+        # If the task identifier is not found, a 404 response code indicates that there are no resources that match the request.
         # This functionality is Experimental and may be changed or removed
         # completely in a future release. Elastic will take a best effort approach
         # to fix any issues, but experimental features are not subject to the
         # support SLA of official GA features.
         #
-        # @option arguments [String] :task_id ID of the task. (*Required*)
-        # @option arguments [Time] :timeout Period to wait for a response.
+        # @option arguments [String] :task_id The task identifier. (*Required*)
+        # @option arguments [Time] :timeout The period to wait for a response.
         #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
         # @option arguments [Boolean] :wait_for_completion If +true+, the request blocks until the task has completed.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/tasks.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-tasks
         #
         def get(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "tasks.get" }
+          request_opts = { endpoint: arguments[:endpoint] || 'tasks.get' }
 
-          defined_params = [:task_id].inject({}) do |set_variables, variable|
+          defined_params = [:task_id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/terms_enum.rb

@@ -23,23 +23,21 @@ module ElasticsearchServerless
     module Actions
       # Get terms in an index.
       # Discover terms that match a partial string in an index.
-      # This "terms enum" API is designed for low-latency look-ups used in auto-complete scenarios.
-      # If the +complete+ property in the response is false, the returned terms set may be incomplete and should be treated as approximate.
-      # This can occur due to a few reasons, such as a request timeout or a node error.
-      # NOTE: The terms enum API may return terms from deleted documents. Deleted documents are initially only marked as deleted. It is not until their segments are merged that documents are actually deleted. Until that happens, the terms enum API will return terms from these documents.
+      # This API is designed for low-latency look-ups used in auto-complete scenarios.
       #
-      # @option arguments [String] :index Comma-separated list of data streams, indices, and index aliases to search. Wildcard (*) expressions are supported. (*Required*)
+      # @option arguments [String] :index A comma-separated list of data streams, indices, and index aliases to search.
+      #  Wildcard (+*+) expressions are supported.
+      #  To search all data streams or indices, omit this parameter or use +*+  or +_all+. (*Required*)
       # @option arguments [Hash] :headers Custom HTTP headers
       # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/search-terms-enum.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-terms-enum
       #
       def terms_enum(arguments = {})
-        request_opts = { endpoint: arguments[:endpoint] || "terms_enum" }
+        request_opts = { endpoint: arguments[:endpoint] || 'terms_enum' }
 
-        defined_params = [:index].inject({}) do |set_variables, variable|
+        defined_params = [:index].each_with_object({}) do |variable, set_variables|
           set_variables[variable] = arguments[variable] if arguments.key?(variable)
-          set_variables
         end
         request_opts[:defined_params] = defined_params unless defined_params.empty?