elasticsearch-api 8.17.2 → 9.0.0

data/lib/elasticsearch/api/actions/machine_learning/put_trained_model.rb

@@ -15,22 +15,26 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Creates an inference trained model.
+        # Create a trained model.
+        # Enable you to supply a trained model that is not created by data frame analytics.
         #
-        # @option arguments [String] :model_id The ID of the trained models to store
-        # @option arguments [Boolean] :defer_definition_decompression If set to `true` and a `compressed_definition` is provided, the request defers definition decompression and skips relevant validations.
-        # @option arguments [Boolean] :wait_for_completion Whether to wait for all child operations(e.g. model download) to complete, before returning or not. Default to false
+        # @option arguments [String] :model_id The unique identifier of the trained model. (*Required*)
+        # @option arguments [Boolean] :defer_definition_decompression If set to +true+ and a +compressed_definition+ is provided,
+        #  the request defers definition decompression and skips relevant
+        #  validations.
+        # @option arguments [Boolean] :wait_for_completion Whether to wait for all child operations (e.g. model download)
+        #  to complete.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The trained model configuration (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/put-trained-models.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-put-trained-model
         #
         def put_trained_model(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.put_trained_model' }
@@ -51,7 +55,7 @@ module Elasticsearch
           _model_id = arguments.delete(:model_id)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "_ml/trained_models/#{Utils.__listify(_model_id)}"
+          path   = "_ml/trained_models/#{Utils.listify(_model_id)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/put_trained_model_alias.rb

@@ -15,26 +15,44 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Creates a new model alias (or reassigns an existing one) to refer to the trained model
+        # Create or update a trained model alias.
+        # A trained model alias is a logical name used to reference a single trained
+        # model.
+        # You can use aliases instead of trained model identifiers to make it easier to
+        # reference your models. For example, you can use aliases in inference
+        # aggregations and processors.
+        # An alias must be unique and refer to only a single trained model. However,
+        # you can have multiple aliases for each trained model.
+        # If you use this API to update an alias such that it references a different
+        # trained model ID and the model uses a different type of data frame analytics,
+        # an error occurs. For example, this situation occurs if you have a trained
+        # model for regression analysis and a trained model for classification
+        # analysis; you cannot reassign an alias from one type of trained model to
+        # another.
+        # If you use this API to update an alias and there are very few input fields in
+        # common between the old and new trained models for the model alias, the API
+        # returns a warning.
         #
-        # @option arguments [String] :model_alias The trained model alias to update
-        # @option arguments [String] :model_id The trained model where the model alias should be assigned
-        # @option arguments [Boolean] :reassign If the model_alias already exists and points to a separate model_id, this parameter must be true. Defaults to false.
+        # @option arguments [String] :model_alias The alias to create or update. This value cannot end in numbers. (*Required*)
+        # @option arguments [String] :model_id The identifier for the trained model that the alias refers to. (*Required*)
+        # @option arguments [Boolean] :reassign Specifies whether the alias gets reassigned to the specified trained
+        #  model if it is already assigned to a different model. If the alias is
+        #  already assigned and this parameter is false, the API returns an error.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/put-trained-models-aliases.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-put-trained-model-alias
         #
         def put_trained_model_alias(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.put_trained_model_alias' }
 
-          defined_params = %i[model_id model_alias].each_with_object({}) do |variable, set_variables|
+          defined_params = [:model_id, :model_alias].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?
@@ -52,7 +70,7 @@ module Elasticsearch
           _model_id = arguments.delete(:model_id)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "_ml/trained_models/#{Utils.__listify(_model_id)}/model_aliases/#{Utils.__listify(_model_alias)}"
+          path   = "_ml/trained_models/#{Utils.listify(_model_id)}/model_aliases/#{Utils.listify(_model_alias)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/put_trained_model_definition_part.rb

@@ -15,26 +15,27 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Creates part of a trained model definition
+        # Create part of a trained model definition.
         #
-        # @option arguments [String] :model_id The ID of the trained model for this definition part
-        # @option arguments [Integer] :part The part number
+        # @option arguments [String] :model_id The unique identifier of the trained model. (*Required*)
+        # @option arguments [Integer] :part The definition part number. When the definition is loaded for inference the definition parts are streamed in the
+        #  order of their part number. The first part must be +0+ and the final part must be +total_parts - 1+. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The trained model definition part (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/put-trained-model-definition-part.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-put-trained-model-definition-part
         #
         def put_trained_model_definition_part(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.put_trained_model_definition_part' }
 
-          defined_params = %i[model_id part].each_with_object({}) do |variable, set_variables|
+          defined_params = [:model_id, :part].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?
@@ -53,7 +54,7 @@ module Elasticsearch
           _part = arguments.delete(:part)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "_ml/trained_models/#{Utils.__listify(_model_id)}/definition/#{Utils.__listify(_part)}"
+          path   = "_ml/trained_models/#{Utils.listify(_model_id)}/definition/#{Utils.listify(_part)}"
           params = {}
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/put_trained_model_vocabulary.rb

@@ -15,20 +15,22 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Creates a trained model vocabulary
+        # Create a trained model vocabulary.
+        # This API is supported only for natural language processing (NLP) models.
+        # The vocabulary is stored in the index as described in +inference_config.*.vocabulary+ of the trained model definition.
         #
-        # @option arguments [String] :model_id The ID of the trained model for this vocabulary
+        # @option arguments [String] :model_id The unique identifier of the trained model. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The trained model vocabulary (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/put-trained-model-vocabulary.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-put-trained-model-vocabulary
         #
         def put_trained_model_vocabulary(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.put_trained_model_vocabulary' }
@@ -49,7 +51,7 @@ module Elasticsearch
           _model_id = arguments.delete(:model_id)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "_ml/trained_models/#{Utils.__listify(_model_id)}/vocabulary"
+          path   = "_ml/trained_models/#{Utils.listify(_model_id)}/vocabulary"
           params = {}
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/reset_job.rb

@@ -15,21 +15,28 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Resets an existing anomaly detection job.
+        # Reset an anomaly detection job.
+        # All model state and results are deleted. The job is ready to start over as if
+        # it had just been created.
+        # It is not currently possible to reset multiple jobs using wildcards or a
+        # comma separated list.
         #
-        # @option arguments [String] :job_id The ID of the job to reset
-        # @option arguments [Boolean] :wait_for_completion Should this request wait until the operation has completed before returning
-        # @option arguments [Boolean] :delete_user_annotations Should annotations added by the user be deleted
+        # @option arguments [String] :job_id The ID of the job to reset. (*Required*)
+        # @option arguments [Boolean] :wait_for_completion Should this request wait until the operation has completed before
+        #  returning. Server default: true.
+        # @option arguments [Boolean] :delete_user_annotations Specifies whether annotations that have been added by the
+        #  user should be deleted along with any auto-generated annotations when the job is
+        #  reset.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-reset-job.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-reset-job
         #
         def reset_job(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.reset_job' }
@@ -49,7 +56,7 @@ module Elasticsearch
           _job_id = arguments.delete(:job_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/_reset"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/_reset"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/revert_model_snapshot.rb

@@ -15,27 +15,41 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Reverts to a specific snapshot.
+        # Revert to a snapshot.
+        # The machine learning features react quickly to anomalous input, learning new
+        # behaviors in data. Highly anomalous input increases the variance in the
+        # models whilst the system learns whether this is a new step-change in behavior
+        # or a one-off event. In the case where this anomalous input is known to be a
+        # one-off, then it might be appropriate to reset the model state to a time
+        # before this event. For example, you might consider reverting to a saved
+        # snapshot after Black Friday or a critical system failure.
         #
-        # @option arguments [String] :job_id The ID of the job to fetch
-        # @option arguments [String] :snapshot_id The ID of the snapshot to revert to
-        # @option arguments [Boolean] :delete_intervening_results Should we reset the results back to the time of the snapshot?
+        # @option arguments [String] :job_id Identifier for the anomaly detection job. (*Required*)
+        # @option arguments [String] :snapshot_id You can specify +empty+ as the <snapshot_id>. Reverting to the empty
+        #  snapshot means the anomaly detection job starts learning a new model from
+        #  scratch when it is started. (*Required*)
+        # @option arguments [Boolean] :delete_intervening_results If true, deletes the results in the time period between the latest
+        #  results and the time of the reverted snapshot. It also resets the model
+        #  to accept records for this time period. If you choose not to delete
+        #  intervening results when reverting a snapshot, the job will not accept
+        #  input data that is older than the current time. If you want to resend
+        #  data, then delete the intervening results.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body Reversion options
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-revert-snapshot.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-revert-model-snapshot
         #
         def revert_model_snapshot(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.revert_model_snapshot' }
 
-          defined_params = %i[job_id snapshot_id].each_with_object({}) do |variable, set_variables|
+          defined_params = [:job_id, :snapshot_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?
@@ -53,7 +67,7 @@ module Elasticsearch
           _snapshot_id = arguments.delete(:snapshot_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/model_snapshots/#{Utils.__listify(_snapshot_id)}/_revert"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/model_snapshots/#{Utils.listify(_snapshot_id)}/_revert"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/set_upgrade_mode.rb

@@ -15,20 +15,34 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Sets a cluster wide upgrade_mode setting that prepares machine learning indices for an upgrade.
+        # Set upgrade_mode for ML indices.
+        # Sets a cluster wide upgrade_mode setting that prepares machine learning
+        # indices for an upgrade.
+        # When upgrading your cluster, in some circumstances you must restart your
+        # nodes and reindex your machine learning indices. In those circumstances,
+        # there must be no machine learning jobs running. You can close the machine
+        # learning jobs, do the upgrade, then open all the jobs again. Alternatively,
+        # you can use this API to temporarily halt tasks associated with the jobs and
+        # datafeeds and prevent new jobs from opening. You can also use this API
+        # during upgrades that do not require you to reindex your machine learning
+        # indices, though stopping jobs is not a requirement in that case.
+        # You can see the current value for the upgrade_mode setting by using the get
+        # machine learning info API.
         #
-        # @option arguments [Boolean] :enabled Whether to enable upgrade_mode ML setting or not. Defaults to false.
-        # @option arguments [Time] :timeout Controls the time to wait before action times out. Defaults to 30 seconds
+        # @option arguments [Boolean] :enabled When +true+, it enables +upgrade_mode+ which temporarily halts all job
+        #  and datafeed tasks and prohibits new job and datafeed tasks from
+        #  starting.
+        # @option arguments [Time] :timeout The time to wait for the request to be completed. Server default: 30s.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-set-upgrade-mode.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-set-upgrade-mode
         #
         def set_upgrade_mode(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.set_upgrade_mode' }
@@ -36,7 +50,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_ml/set_upgrade_mode'

data/lib/elasticsearch/api/actions/machine_learning/start_data_frame_analytics.rb

@@ -15,21 +15,34 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Starts a data frame analytics job.
+        # Start a data frame analytics job.
+        # A data frame analytics job can be started and stopped multiple times
+        # throughout its lifecycle.
+        # If the destination index does not exist, it is created automatically the
+        # first time you start the data frame analytics job. The
+        # +index.number_of_shards+ and +index.number_of_replicas+ settings for the
+        # destination index are copied from the source index. If there are multiple
+        # source indices, the destination index copies the highest setting values. The
+        # mappings for the destination index are also copied from the source indices.
+        # If there are any mapping conflicts, the job fails to start.
+        # If the destination index exists, it is used as is. You can therefore set up
+        # the destination index in advance with custom settings and mappings.
         #
-        # @option arguments [String] :id The ID of the data frame analytics to start
-        # @option arguments [Time] :timeout Controls the time to wait until the task has started. Defaults to 20 seconds
+        # @option arguments [String] :id Identifier for the data frame analytics job. This identifier can contain
+        #  lowercase alphanumeric characters (a-z and 0-9), hyphens, and
+        #  underscores. It must start and end with alphanumeric characters. (*Required*)
+        # @option arguments [Time] :timeout Controls the amount of time to wait until the data frame analytics job
+        #  starts. Server default: 20s.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The start data frame analytics parameters
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/start-dfanalytics.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-start-data-frame-analytics
         #
         def start_data_frame_analytics(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.start_data_frame_analytics' }
@@ -44,12 +57,12 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body = arguments.delete(:body)
+          body = nil
 
           _id = arguments.delete(:id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/data_frame/analytics/#{Utils.__listify(_id)}/_start"
+          path   = "_ml/data_frame/analytics/#{Utils.listify(_id)}/_start"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/start_datafeed.rb

@@ -15,23 +15,46 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Starts one or more datafeeds.
+        # Start datafeeds.
+        # A datafeed must be started in order to retrieve data from Elasticsearch. A datafeed can be started and stopped
+        # multiple times throughout its lifecycle.
+        # Before you can start a datafeed, the anomaly detection job must be open. Otherwise, an error occurs.
+        # If you restart a stopped datafeed, it continues processing input data from the next millisecond after it was stopped.
+        # If new data was indexed for that exact millisecond between stopping and starting, it will be ignored.
+        # When Elasticsearch security features are enabled, your datafeed remembers which roles the last user to create or
+        # update it had at the time of creation or update and runs the query using those same roles. If you provided secondary
+        # authorization headers when you created or updated the datafeed, those credentials are used instead.
         #
-        # @option arguments [String] :datafeed_id The ID of the datafeed to start
-        # @option arguments [String] :start The start time from where the datafeed should begin
-        # @option arguments [String] :end The end time when the datafeed should stop. When not set, the datafeed continues in real time
-        # @option arguments [Time] :timeout Controls the time to wait until a datafeed has started. Default to 20 seconds
+        # @option arguments [String] :datafeed_id A numerical character string that uniquely identifies the datafeed. This identifier can contain lowercase
+        #  alphanumeric characters (a-z and 0-9), hyphens, and underscores. It must start and end with alphanumeric
+        #  characters. (*Required*)
+        # @option arguments [String, Time] :end The time that the datafeed should end, which can be specified by using one of the following formats:
+        #  - ISO 8601 format with milliseconds, for example +2017-01-22T06:00:00.000Z+
+        #  - ISO 8601 format without milliseconds, for example +2017-01-22T06:00:00+00:00+
+        #  - Milliseconds since the epoch, for example +1485061200000+
+        #  Date-time arguments using either of the ISO 8601 formats must have a time zone designator, where +Z+ is accepted
+        #  as an abbreviation for UTC time. When a URL is expected (for example, in browsers), the +++ used in time zone
+        #  designators must be encoded as +%2B+.
+        #  The end time value is exclusive. If you do not specify an end time, the datafeed
+        #  runs continuously.
+        # @option arguments [String, Time] :start The time that the datafeed should begin, which can be specified by using the same formats as the +end+ parameter.
+        #  This value is inclusive.
+        #  If you do not specify a start time and the datafeed is associated with a new anomaly detection job, the analysis
+        #  starts from the earliest time for which data is available.
+        #  If you restart a stopped datafeed and specify a start value that is earlier than the timestamp of the latest
+        #  processed record, the datafeed continues from 1 millisecond after the timestamp of the latest processed record.
+        # @option arguments [Time] :timeout Specifies the amount of time to wait until a datafeed starts. Server default: 20s.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The start datafeed parameters
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-start-datafeed.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-start-datafeed
         #
         def start_datafeed(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.start_datafeed' }
@@ -51,7 +74,7 @@ module Elasticsearch
           _datafeed_id = arguments.delete(:datafeed_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/datafeeds/#{Utils.__listify(_datafeed_id)}/_start"
+          path   = "_ml/datafeeds/#{Utils.listify(_datafeed_id)}/_start"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/start_trained_model_deployment.rb

@@ -15,27 +15,42 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
         # Start a trained model deployment.
+        # It allocates the model to every machine learning node.
         #
-        # @option arguments [String] :model_id The unique identifier of the trained model. (*Required*)
-        # @option arguments [String] :cache_size A byte-size value for configuring the inference cache size. For example, 20mb.
-        # @option arguments [String] :deployment_id The Id of the new deployment. Defaults to the model_id if not set.
-        # @option arguments [Integer] :number_of_allocations The total number of allocations this model is assigned across machine learning nodes.
-        # @option arguments [Integer] :threads_per_allocation The number of threads used by each model allocation during inference.
+        # @option arguments [String] :model_id The unique identifier of the trained model. Currently, only PyTorch models are supported. (*Required*)
+        # @option arguments [Integer, String] :cache_size The inference cache size (in memory outside the JVM heap) per node for the model.
+        #  The default value is the same size as the +model_size_bytes+. To disable the cache,
+        #  +0b+ can be provided.
+        # @option arguments [String] :deployment_id A unique identifier for the deployment of the model.
+        # @option arguments [Integer] :number_of_allocations The number of model allocations on each node where the model is deployed.
+        #  All allocations on a node share the same copy of the model in memory but use
+        #  a separate set of threads to evaluate the model.
+        #  Increasing this value generally increases the throughput.
+        #  If this setting is greater than the number of hardware threads
+        #  it will automatically be changed to a value less than the number of hardware threads.
+        #  If adaptive_allocations is enabled, do not set this value, because it’s automatically set. Server default: 1.
         # @option arguments [String] :priority The deployment priority.
-        # @option arguments [Integer] :queue_capacity Controls how many inference requests are allowed in the queue at a time.
-        # @option arguments [Time] :timeout Controls the amount of time to wait for the model to deploy.
-        # @option arguments [String] :wait_for The allocation status for which to wait (options: starting, started, fully_allocated)
+        # @option arguments [Integer] :queue_capacity Specifies the number of inference requests that are allowed in the queue. After the number of requests exceeds
+        #  this value, new requests are rejected with a 429 error. Server default: 1024.
+        # @option arguments [Integer] :threads_per_allocation Sets the number of threads used by each model allocation during inference. This generally increases
+        #  the inference speed. The inference process is a compute-bound process; any number
+        #  greater than the number of available hardware threads on the machine does not increase the
+        #  inference speed. If this setting is greater than the number of hardware threads
+        #  it will automatically be changed to a value less than the number of hardware threads. Server default: 1.
+        # @option arguments [Time] :timeout Specifies the amount of time to wait for the model to deploy. Server default: 20s.
+        # @option arguments [String] :wait_for Specifies the allocation status to wait for before returning. Server default: started.
         # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/start-trained-model-deployment.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-start-trained-model-deployment
         #
         def start_trained_model_deployment(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.start_trained_model_deployment' }
@@ -50,12 +65,12 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body = nil
+          body = arguments.delete(:body)
 
           _model_id = arguments.delete(:model_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/trained_models/#{Utils.__listify(_model_id)}/deployment/_start"
+          path   = "_ml/trained_models/#{Utils.listify(_model_id)}/deployment/_start"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/stop_data_frame_analytics.rb

@@ -15,23 +15,35 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Stops one or more data frame analytics jobs.
+        # Stop data frame analytics jobs.
+        # A data frame analytics job can be started and stopped multiple times
+        # throughout its lifecycle.
         #
-        # @option arguments [String] :id The ID of the data frame analytics to stop
-        # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no data frame analytics. (This includes `_all` string or when no data frame analytics have been specified)
-        # @option arguments [Boolean] :force True if the data frame analytics should be forcefully stopped
-        # @option arguments [Time] :timeout Controls the time to wait until the task has stopped. Defaults to 20 seconds
+        # @option arguments [String] :id Identifier for the data frame analytics job. This identifier can contain
+        #  lowercase alphanumeric characters (a-z and 0-9), hyphens, and
+        #  underscores. It must start and end with alphanumeric characters. (*Required*)
+        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request:
+        #  - Contains wildcard expressions and there are no data frame analytics
+        #  jobs that match.
+        #  - Contains the _all string or no identifiers and there are no matches.
+        #  - Contains wildcard expressions and there are only partial matches.
+        #  The default value is true, which returns an empty data_frame_analytics
+        #  array when there are no matches and the subset of results when there are
+        #  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 [Boolean] :force If true, the data frame analytics job is stopped forcefully.
+        # @option arguments [Time] :timeout Controls the amount of time to wait until the data frame analytics job
+        #  stops. Defaults to 20 seconds. Server default: 20s.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The stop data frame analytics parameters
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/stop-dfanalytics.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-stop-data-frame-analytics
         #
         def stop_data_frame_analytics(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.stop_data_frame_analytics' }
@@ -46,12 +58,12 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body = arguments.delete(:body)
+          body = nil
 
           _id = arguments.delete(:id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/data_frame/analytics/#{Utils.__listify(_id)}/_stop"
+          path   = "_ml/data_frame/analytics/#{Utils.listify(_id)}/_stop"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(