elasticsearch-serverless 0.1.0.20231031.pre → 0.3.0

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

@@ -21,16 +21,19 @@
 module ElasticsearchServerless
   module API
     module Actions
+      # Get term vector information.
       # Returns information and statistics about terms in the fields of a particular document.
       #
       # @option arguments [String] :index Name of the index that contains the document. (*Required*)
       # @option arguments [String] :id Unique identifier of the document.
-      # @option arguments [String, Array<String>] :fields Comma-separated list or wildcard expressions of fields to include in the statistics. Used as the default list unless a specific field list is provided in the +completion_fields+ or +fielddata_fields+ parameters.
+      # @option arguments [String, Array<String>] :fields Comma-separated list or wildcard expressions of fields to include in the statistics.
+      #  Used as the default list unless a specific field list is provided in the +completion_fields+ or +fielddata_fields+ parameters.
       # @option arguments [Boolean] :field_statistics If +true+, the response includes the document count, sum of document frequencies, and sum of total term frequencies. Server default: true.
       # @option arguments [Boolean] :offsets If +true+, the response includes term offsets. Server default: true.
       # @option arguments [Boolean] :payloads If +true+, the response includes term payloads. Server default: true.
       # @option arguments [Boolean] :positions If +true+, the response includes term positions. Server default: true.
-      # @option arguments [String] :preference Specifies the node or shard the operation should be performed on. Random by default.
+      # @option arguments [String] :preference Specifies the node or shard the operation should be performed on.
+      #  Random by default.
       # @option arguments [Boolean] :realtime If true, the request is real-time as opposed to near-real-time. Server default: true.
       # @option arguments [String] :routing Custom value used to route operations to a specific shard.
       # @option arguments [Boolean] :term_statistics If +true+, the response includes term frequency and document frequency.
@@ -42,6 +45,14 @@ module ElasticsearchServerless
       # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-termvectors.html
       #
       def termvectors(arguments = {})
+        request_opts = { endpoint: arguments[:endpoint] || "termvectors" }
+
+        defined_params = [:index, :id].inject({}) do |set_variables, variable|
+          set_variables[variable] = arguments[variable] if arguments.key?(variable)
+          set_variables
+        end
+        request_opts[:defined_params] = defined_params unless defined_params.empty?
+
         raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
 
         arguments = arguments.clone
@@ -59,22 +70,23 @@ module ElasticsearchServerless
                    ElasticsearchServerless::API::HTTP_GET
                  end
 
-        endpoint = arguments.delete(:endpoint) || '_termvectors'
-        path   = if _index && _id
-                   "#{Utils.listify(_index)}/_termvectors/#{Utils.listify(_id)}"
-                 else
-                   "#{Utils.listify(_index)}/_termvectors"
-                 end
+        arguments.delete(:endpoint)
+        path = if _index && _id
+                 "#{Utils.listify(_index)}/_termvectors/#{Utils.listify(_id)}"
+               else
+                 "#{Utils.listify(_index)}/_termvectors"
+               end
         params = Utils.process_params(arguments)
 
         ElasticsearchServerless::API::Response.new(
-          perform_request(method, path, params, body, headers)
+          perform_request(method, path, params, body, headers, request_opts)
         )
       end
 
       # Deprecated: Use the plural version, {#termvectors}
       #
       def termvector(arguments = {})
+        warn "[DEPRECATION] `termvector` is deprecated. Please use the plural version, `termvectors` instead."
         termvectors(arguments.merge endpoint: '_termvector')
       end
     end

data/lib/elasticsearch-serverless/api/transform/delete_transform.rb

@@ -22,17 +22,28 @@ module ElasticsearchServerless
   module API
     module Transform
       module Actions
-        # Deletes an existing transform.
+        # Delete a transform.
+        # Deletes a transform.
         #
         # @option arguments [String] :transform_id Identifier for the transform. (*Required*)
-        # @option arguments [Boolean] :force If this value is false, the transform must be stopped before it can be deleted. If true, the transform is deleted regardless of its current state.
-        # @option arguments [Boolean] :delete_dest_index If this value is true, the destination index is deleted together with the transform. If false, the destination index will not be deleted
+        # @option arguments [Boolean] :force If this value is false, the transform must be stopped before it can be deleted. If true, the transform is
+        #  deleted regardless of its current state.
+        # @option arguments [Boolean] :delete_dest_index If this value is true, the destination index is deleted together with the transform. If false, the destination
+        #  index will not be deleted
         # @option arguments [Time] :timeout 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 [Hash] :headers Custom HTTP headers
         #
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/delete-transform.html
         #
         def delete_transform(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || "transform.delete_transform" }
+
+          defined_params = [:transform_id].inject({}) do |set_variables, variable|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+            set_variables
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
           raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]
 
           arguments = arguments.clone
@@ -47,7 +58,7 @@ module ElasticsearchServerless
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(
-            perform_request(method, path, params, body, headers)
+            perform_request(method, path, params, body, headers, request_opts)
           )
         end
       end

data/lib/elasticsearch-serverless/api/transform/get_transform.rb

@@ -22,18 +22,37 @@ module ElasticsearchServerless
   module API
     module Transform
       module Actions
+        # Get transforms.
         # Retrieves configuration information for transforms.
         #
-        # @option arguments [String, Array<String>] :transform_id Identifier for the transform. It can be a transform identifier or a wildcard expression. You can get information for all transforms by using +_all+, by specifying +*+ as the +<transform_id>+, or by omitting the +<transform_id>+.
-        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request:  1. Contains wildcard expressions and there are no transforms that match. 2. Contains the _all string or no identifiers and there are no matches. 3. Contains wildcard expressions and there are only partial matches.  If this parameter is false, the request returns a 404 status code when there are no matches or only partial matches. Server default: true.
+        # @option arguments [String, Array<String>] :transform_id Identifier for the transform. It can be a transform identifier or a
+        #  wildcard expression. You can get information for all transforms by using
+        #  +_all+, by specifying +*+ as the +<transform_id>+, or by omitting the
+        #  +<transform_id>+.
+        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request:
+        #  - Contains wildcard expressions and there are no transforms that match.
+        #  - Contains the _all string or no identifiers and there are no matches.
+        #  - Contains wildcard expressions and there are only partial matches.
+        #  If this parameter is false, the request returns a 404 status code when
+        #  there are no matches or only partial matches. Server default: true.
         # @option arguments [Integer] :from Skips the specified number of transforms. Server default: 0.
         # @option arguments [Integer] :size Specifies the maximum number of transforms to obtain. Server default: 100.
-        # @option arguments [Boolean] :exclude_generated Excludes fields that were automatically added when creating the transform. This allows the configuration to be in an acceptable format to be retrieved and then added to another cluster.
+        # @option arguments [Boolean] :exclude_generated Excludes fields that were automatically added when creating the
+        #  transform. This allows the configuration to be in an acceptable format to
+        #  be retrieved and then added to another cluster.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/get-transform.html
         #
         def get_transform(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || "transform.get_transform" }
+
+          defined_params = [:transform_id].inject({}) do |set_variables, variable|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+            set_variables
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
@@ -50,7 +69,7 @@ module ElasticsearchServerless
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(
-            perform_request(method, path, params, body, headers)
+            perform_request(method, path, params, body, headers, request_opts)
           )
         end
       end

data/lib/elasticsearch-serverless/api/transform/get_transform_stats.rb

@@ -22,10 +22,19 @@ module ElasticsearchServerless
   module API
     module Transform
       module Actions
+        # Get transform stats.
         # Retrieves usage information for transforms.
         #
-        # @option arguments [String, Array<String>] :transform_id Identifier for the transform. It can be a transform identifier or a wildcard expression. You can get information for all transforms by using +_all+, by specifying +*+ as the +<transform_id>+, or by omitting the +<transform_id>+. (*Required*)
-        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request:  1. Contains wildcard expressions and there are no transforms that match. 2. Contains the _all string or no identifiers and there are no matches. 3. Contains wildcard expressions and there are only partial matches.  If this parameter is false, the request returns a 404 status code when there are no matches or only partial matches. Server default: true.
+        # @option arguments [String, Array<String>] :transform_id Identifier for the transform. It can be a transform identifier or a
+        #  wildcard expression. You can get information for all transforms by using
+        #  +_all+, by specifying +*+ as the +<transform_id>+, or by omitting the
+        #  +<transform_id>+. (*Required*)
+        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request:
+        #  - Contains wildcard expressions and there are no transforms that match.
+        #  - Contains the _all string or no identifiers and there are no matches.
+        #  - Contains wildcard expressions and there are only partial matches.
+        #  If this parameter is false, the request returns a 404 status code when
+        #  there are no matches or only partial matches. Server default: true.
         # @option arguments [Integer] :from Skips the specified number of transforms. Server default: 0.
         # @option arguments [Integer] :size Specifies the maximum number of transforms to obtain. Server default: 100.
         # @option arguments [Time] :timeout Controls the time to wait for the stats
@@ -34,6 +43,14 @@ module ElasticsearchServerless
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/get-transform-stats.html
         #
         def get_transform_stats(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || "transform.get_transform_stats" }
+
+          defined_params = [:transform_id].inject({}) do |set_variables, variable|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+            set_variables
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
           raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]
 
           arguments = arguments.clone
@@ -48,7 +65,7 @@ module ElasticsearchServerless
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(
-            perform_request(method, path, params, body, headers)
+            perform_request(method, path, params, body, headers, request_opts)
           )
         end
       end

data/lib/elasticsearch-serverless/api/transform/preview_transform.rb

@@ -22,16 +22,30 @@ module ElasticsearchServerless
   module API
     module Transform
       module Actions
-        # Previews a transform.
+        # Preview a transform.
+        # Generates a preview of the results that you will get when you create a transform with the same configuration.
+        # It returns a maximum of 100 results. The calculations are based on all the current data in the source index. It also
+        # generates a list of mappings and settings for the destination index. These values are determined based on the field
+        # types of the source index and the transform aggregations.
         #
-        # @option arguments [String] :transform_id Identifier for the transform to preview. If you specify this path parameter, you cannot provide transform configuration details in the request body.
-        # @option arguments [Time] :timeout 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 [String] :transform_id Identifier for the transform to preview. If you specify this path parameter, you cannot provide transform
+        #  configuration details in the request body.
+        # @option arguments [Time] :timeout 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 [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/preview-transform.html
         #
         def preview_transform(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || "transform.preview_transform" }
+
+          defined_params = [:transform_id].inject({}) do |set_variables, variable|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+            set_variables
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
@@ -53,7 +67,7 @@ module ElasticsearchServerless
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(
-            perform_request(method, path, params, body, headers)
+            perform_request(method, path, params, body, headers, request_opts)
           )
         end
       end

data/lib/elasticsearch-serverless/api/transform/put_transform.rb

@@ -22,10 +22,32 @@ module ElasticsearchServerless
   module API
     module Transform
       module Actions
-        # Instantiates a transform.
+        # Create a transform.
+        # Creates a transform.
+        # A transform copies data from source indices, transforms it, and persists it into an entity-centric destination index. You can also think of the destination index as a two-dimensional tabular data structure (known as
+        # a data frame). The ID for each document in the data frame is generated from a hash of the entity, so there is a
+        # unique row per entity.
+        # You must choose either the latest or pivot method for your transform; you cannot use both in a single transform. If
+        # you choose to use the pivot method for your transform, the entities are defined by the set of +group_by+ fields in
+        # the pivot object. If you choose to use the latest method, the entities are defined by the +unique_key+ field values
+        # in the latest object.
+        # You must have +create_index+, +index+, and +read+ privileges on the destination index and +read+ and
+        # +view_index_metadata+ privileges on the source indices. When Elasticsearch security features are enabled, the
+        # transform remembers which roles the user that created it had at the time of creation and uses those same roles. If
+        # those roles do not have the required privileges on the source and destination indices, the transform fails when it
+        # attempts unauthorized operations.
+        # NOTE: You must use Kibana or this API to create a transform. Do not add a transform directly into any
+        # +.transform-internal*+ indices using the Elasticsearch index API. If Elasticsearch security features are enabled, do
+        # not give users any privileges on +.transform-internal*+ indices. If you used transforms prior to 7.5, also do not
+        # give users any privileges on +.data-frame-internal*+ indices.
         #
-        # @option arguments [String] :transform_id Identifier for the transform. This identifier can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores. It has a 64 character limit and must start and end with alphanumeric characters. (*Required*)
-        # @option arguments [Boolean] :defer_validation When the transform is created, a series of validations occur to ensure its success. For example, there is a check for the existence of the source indices and a check that the destination index is not part of the source index pattern. You can use this parameter to skip the checks, for example when the source index does not exist until after the transform is created. The validations are always run when you start the transform, however, with the exception of privilege checks.
+        # @option arguments [String] :transform_id Identifier for the transform. This identifier can contain lowercase alphanumeric characters (a-z and 0-9),
+        #  hyphens, and underscores. It has a 64 character limit and must start and end with alphanumeric characters. (*Required*)
+        # @option arguments [Boolean] :defer_validation When the transform is created, a series of validations occur to ensure its success. For example, there is a
+        #  check for the existence of the source indices and a check that the destination index is not part of the source
+        #  index pattern. You can use this parameter to skip the checks, for example when the source index does not exist
+        #  until after the transform is created. The validations are always run when you start the transform, however, with
+        #  the exception of privilege checks.
         # @option arguments [Time] :timeout 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 [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
@@ -33,6 +55,14 @@ module ElasticsearchServerless
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/put-transform.html
         #
         def put_transform(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || "transform.put_transform" }
+
+          defined_params = [:transform_id].inject({}) do |set_variables, variable|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+            set_variables
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
           raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
           raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]
 
@@ -48,7 +78,7 @@ module ElasticsearchServerless
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(
-            perform_request(method, path, params, body, headers)
+            perform_request(method, path, params, body, headers, request_opts)
           )
         end
       end

data/lib/elasticsearch-serverless/api/transform/reset_transform.rb

@@ -22,15 +22,28 @@ module ElasticsearchServerless
   module API
     module Transform
       module Actions
-        # Resets an existing transform.
+        # Reset a transform.
+        # Resets a transform.
+        # Before you can reset it, you must stop it; alternatively, use the +force+ query parameter.
+        # If the destination index was created by the transform, it is deleted.
         #
-        # @option arguments [String] :transform_id Identifier for the transform. This identifier can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores. It has a 64 character limit and must start and end with alphanumeric characters. (*Required*)
-        # @option arguments [Boolean] :force If this value is +true+, the transform is reset regardless of its current state. If it's +false+, the transform must be stopped before it can be reset.
+        # @option arguments [String] :transform_id Identifier for the transform. This identifier can contain lowercase alphanumeric characters (a-z and 0-9),
+        #  hyphens, and underscores. It has a 64 character limit and must start and end with alphanumeric characters. (*Required*)
+        # @option arguments [Boolean] :force If this value is +true+, the transform is reset regardless of its current state. If it's +false+, the transform
+        #  must be stopped before it can be reset.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/reset-transform.html
         #
         def reset_transform(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || "transform.reset_transform" }
+
+          defined_params = [:transform_id].inject({}) do |set_variables, variable|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+            set_variables
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
           raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]
 
           arguments = arguments.clone
@@ -45,7 +58,7 @@ module ElasticsearchServerless
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(
-            perform_request(method, path, params, body, headers)
+            perform_request(method, path, params, body, headers, request_opts)
           )
         end
       end

data/lib/elasticsearch-serverless/api/transform/schedule_now_transform.rb

@@ -22,7 +22,12 @@ module ElasticsearchServerless
   module API
     module Transform
       module Actions
-        # Schedules now a transform.
+        # Schedule a transform to start now.
+        # Instantly runs a transform to process data.
+        # If you _schedule_now a transform, it will process the new data instantly,
+        # without waiting for the configured frequency interval. After _schedule_now API is called,
+        # the transform will be processed again at now + frequency unless _schedule_now API
+        # is called again in the meantime.
         #
         # @option arguments [String] :transform_id Identifier for the transform. (*Required*)
         # @option arguments [Time] :timeout Controls the time to wait for the scheduling to take place Server default: 30s.
@@ -31,6 +36,14 @@ module ElasticsearchServerless
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/schedule-now-transform.html
         #
         def schedule_now_transform(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || "transform.schedule_now_transform" }
+
+          defined_params = [:transform_id].inject({}) do |set_variables, variable|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+            set_variables
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
           raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]
 
           arguments = arguments.clone
@@ -45,7 +58,7 @@ module ElasticsearchServerless
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(
-            perform_request(method, path, params, body, headers)
+            perform_request(method, path, params, body, headers, request_opts)
           )
         end
       end

data/lib/elasticsearch-serverless/api/transform/start_transform.rb

@@ -22,7 +22,21 @@ module ElasticsearchServerless
   module API
     module Transform
       module Actions
-        # Starts one or more transforms.
+        # Start a transform.
+        # Starts a transform.
+        # When you start a transform, it creates the destination index if it does not already exist. The +number_of_shards+ is
+        # set to +1+ and the +auto_expand_replicas+ is set to +0-1+. If it is a pivot transform, it deduces the mapping
+        # definitions for the destination index from the source indices and the transform aggregations. If fields in the
+        # destination index are derived from scripts (as in the case of +scripted_metric+ or +bucket_script+ aggregations),
+        # the transform uses dynamic mappings unless an index template exists. If it is a latest transform, it does not deduce
+        # mapping definitions; it uses dynamic mappings. To use explicit mappings, create the destination index before you
+        # start the transform. Alternatively, you can create an index template, though it does not affect the deduced mappings
+        # in a pivot transform.
+        # When the transform starts, a series of validations occur to ensure its success. If you deferred validation when you
+        # created the transform, they occur when you start the transform—​with the exception of privilege checks. When
+        # Elasticsearch security features are enabled, the transform remembers which roles the user that created it had at the
+        # time of creation and uses those same roles. If those roles do not have the required privileges on the source and
+        # destination indices, the transform fails when it attempts unauthorized operations.
         #
         # @option arguments [String] :transform_id Identifier for the transform. (*Required*)
         # @option arguments [Time] :timeout 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.
@@ -32,6 +46,14 @@ module ElasticsearchServerless
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/start-transform.html
         #
         def start_transform(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || "transform.start_transform" }
+
+          defined_params = [:transform_id].inject({}) do |set_variables, variable|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+            set_variables
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
           raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]
 
           arguments = arguments.clone
@@ -46,7 +68,7 @@ module ElasticsearchServerless
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(
-            perform_request(method, path, params, body, headers)
+            perform_request(method, path, params, body, headers, request_opts)
           )
         end
       end

data/lib/elasticsearch-serverless/api/transform/stop_transform.rb

@@ -22,19 +22,36 @@ module ElasticsearchServerless
   module API
     module Transform
       module Actions
+        # Stop transforms.
         # Stops one or more transforms.
         #
-        # @option arguments [String] :transform_id Identifier for the transform. To stop multiple transforms, use a comma-separated list or a wildcard expression. To stop all transforms, use +_all+ or +*+ as the identifier. (*Required*)
-        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request: contains wildcard expressions and there are no transforms that match; contains the +_all+ string or no identifiers and there are no matches; contains wildcard expressions and there are only partial matches.  If it is true, the API returns a successful acknowledgement message when there are no matches. When there are only partial matches, the API stops the appropriate transforms.  If it is false, the request returns a 404 status code when there are no matches or only partial matches. Server default: true.
+        # @option arguments [String] :transform_id Identifier for the transform. To stop multiple transforms, use a comma-separated list or a wildcard expression.
+        #  To stop all transforms, use +_all+ or +*+ as the identifier. (*Required*)
+        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request: contains wildcard expressions and there are no transforms that match;
+        #  contains the +_all+ string or no identifiers and there are no matches; contains wildcard expressions and there
+        #  are only partial matches.If it is true, the API returns a successful acknowledgement message when there are no matches. When there are
+        #  only partial matches, the API stops the appropriate transforms.If it is false, the request returns a 404 status code when there are no matches or only partial matches. Server default: true.
         # @option arguments [Boolean] :force If it is true, the API forcefully stops the transforms.
-        # @option arguments [Time] :timeout Period to wait for a response when +wait_for_completion+ is +true+. If no response is received before the timeout expires, the request returns a timeout exception. However, the request continues processing and eventually moves the transform to a STOPPED state. Server default: 30s.
-        # @option arguments [Boolean] :wait_for_checkpoint If it is true, the transform does not completely stop until the current checkpoint is completed. If it is false, the transform stops as soon as possible.
-        # @option arguments [Boolean] :wait_for_completion If it is true, the API blocks until the indexer state completely stops. If it is false, the API returns immediately and the indexer is stopped asynchronously in the background.
+        # @option arguments [Time] :timeout Period to wait for a response when +wait_for_completion+ is +true+. If no response is received before the
+        #  timeout expires, the request returns a timeout exception. However, the request continues processing and
+        #  eventually moves the transform to a STOPPED state. Server default: 30s.
+        # @option arguments [Boolean] :wait_for_checkpoint If it is true, the transform does not completely stop until the current checkpoint is completed. If it is false,
+        #  the transform stops as soon as possible.
+        # @option arguments [Boolean] :wait_for_completion If it is true, the API blocks until the indexer state completely stops. If it is false, the API returns
+        #  immediately and the indexer is stopped asynchronously in the background.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/stop-transform.html
         #
         def stop_transform(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || "transform.stop_transform" }
+
+          defined_params = [:transform_id].inject({}) do |set_variables, variable|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+            set_variables
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
           raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]
 
           arguments = arguments.clone
@@ -49,7 +66,7 @@ module ElasticsearchServerless
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(
-            perform_request(method, path, params, body, headers)
+            perform_request(method, path, params, body, headers, request_opts)
           )
         end
       end

data/lib/elasticsearch-serverless/api/transform/update_transform.rb

@@ -22,17 +22,34 @@ module ElasticsearchServerless
   module API
     module Transform
       module Actions
+        # Update a transform.
         # Updates certain properties of a transform.
+        # All updated properties except +description+ do not take effect until after the transform starts the next checkpoint,
+        # thus there is data consistency in each checkpoint. To use this API, you must have +read+ and +view_index_metadata+
+        # privileges for the source indices. You must also have +index+ and +read+ privileges for the destination index. When
+        # Elasticsearch security features are enabled, the transform remembers which roles the user who updated it had at the
+        # time of update and runs with those privileges.
         #
         # @option arguments [String] :transform_id Identifier for the transform. (*Required*)
-        # @option arguments [Boolean] :defer_validation When true, deferrable validations are not run. This behavior may be desired if the source index does not exist until after the transform is created.
-        # @option arguments [Time] :timeout 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] :defer_validation When true, deferrable validations are not run. This behavior may be
+        #  desired if the source index does not exist until after the transform is
+        #  created.
+        # @option arguments [Time] :timeout 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 [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/update-transform.html
         #
         def update_transform(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || "transform.update_transform" }
+
+          defined_params = [:transform_id].inject({}) do |set_variables, variable|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+            set_variables
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
           raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
           raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]
 
@@ -48,7 +65,7 @@ module ElasticsearchServerless
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(
-            perform_request(method, path, params, body, headers)
+            perform_request(method, path, params, body, headers, request_opts)
           )
         end
       end

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

@@ -21,20 +21,28 @@
 module ElasticsearchServerless
   module API
     module Actions
-      # Updates a document with a script or partial document.
+      # Update a document.
+      # Updates a document by running a script or passing a partial document.
       #
       # @option arguments [String] :id Document ID (*Required*)
       # @option arguments [String] :index The name of the index (*Required*)
       # @option arguments [Integer] :if_primary_term Only perform the operation if the document has this primary term.
       # @option arguments [Integer] :if_seq_no Only perform the operation if the document has this sequence number.
       # @option arguments [String] :lang The script language. Server default: painless.
-      # @option arguments [String] :refresh If 'true', Elasticsearch 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. Server default: false.
+      # @option arguments [String] :refresh If 'true', Elasticsearch 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. Server default: false.
       # @option arguments [Boolean] :require_alias If true, the destination must be an index alias.
       # @option arguments [Integer] :retry_on_conflict Specify how many times should the operation be retried when a conflict occurs. Server default: 0.
       # @option arguments [String] :routing Custom value used to route operations to a specific shard.
-      # @option arguments [Time] :timeout Period to wait for dynamic mapping updates and active shards. This guarantees Elasticsearch waits for at least the timeout before failing. The actual wait time could be longer, particularly when multiple waits occur. Server default: 1m.
-      # @option arguments [Integer, String] :wait_for_active_shards The number of shard copies that must be active before proceeding with the operations. Set to 'all' or any positive integer up to the total number of shards in the index (number_of_replicas+1). Defaults to 1 meaning the primary shard. Server default: 1.
-      # @option arguments [Boolean, String, Array<String>] :_source Set to false to disable source retrieval. You can also specify a comma-separated list of the fields you want to retrieve. Server default: true.
+      # @option arguments [Time] :timeout Period to wait for dynamic mapping updates and active shards.
+      #  This guarantees Elasticsearch waits for at least the timeout before failing.
+      #  The actual wait time could be longer, particularly when multiple waits occur. Server default: 1m.
+      # @option arguments [Integer, String] :wait_for_active_shards The number of shard copies that must be active before proceeding with the operations.
+      #  Set to 'all' or any positive integer up to the total number of shards in the index
+      #  (number_of_replicas+1). Defaults to 1 meaning the primary shard. Server default: 1.
+      # @option arguments [Boolean, String, Array<String>] :_source Set to false to disable source retrieval. You can also specify a comma-separated
+      #  list of the fields you want to retrieve. Server default: true.
       # @option arguments [String, Array<String>] :_source_excludes Specify the source fields you want to exclude.
       # @option arguments [String, Array<String>] :_source_includes Specify the source fields you want to retrieve.
       # @option arguments [Hash] :headers Custom HTTP headers
@@ -43,6 +51,14 @@ module ElasticsearchServerless
       # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-update.html
       #
       def update(arguments = {})
+        request_opts = { endpoint: arguments[:endpoint] || "update" }
+
+        defined_params = [:index, :id].inject({}) do |set_variables, variable|
+          set_variables[variable] = arguments[variable] if arguments.key?(variable)
+          set_variables
+        end
+        request_opts[:defined_params] = defined_params unless defined_params.empty?
+
         raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
         raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
         raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
@@ -63,12 +79,12 @@ module ElasticsearchServerless
         if Array(arguments[:ignore]).include?(404)
           Utils.rescue_from_not_found {
             ElasticsearchServerless::API::Response.new(
-              perform_request(method, path, params, body, headers)
+              perform_request(method, path, params, body, headers, request_opts)
             )
           }
         else
           ElasticsearchServerless::API::Response.new(
-            perform_request(method, path, params, body, headers)
+            perform_request(method, path, params, body, headers, request_opts)
           )
         end
       end