elasticsearch-api 8.19.0 → 9.0.0

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

@@ -15,23 +15,29 @@
 # 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
-        # Closes one or more anomaly detection jobs. A job can be opened and closed multiple times throughout its lifecycle.
+        # Close anomaly detection jobs.
+        # A job can be opened and closed multiple times throughout its lifecycle. A closed job cannot receive data or perform analysis operations, but you can still explore and navigate results.
+        # When you close a job, it runs housekeeping tasks such as pruning the model history, flushing buffers, calculating final results and persisting the model snapshots. Depending upon the size of the job, it could take several minutes to close and the equivalent time to re-open. After it is closed, the job has a minimal overhead on the cluster except for maintaining its meta data. Therefore it is a best practice to close jobs that are no longer required to process data.
+        # If you close an anomaly detection job whose datafeed is running, the request first tries to stop the datafeed. This behavior is equivalent to calling stop datafeed API with the same timeout and force parameters as the close job request.
+        # When a datafeed that has a specified end date stops, it automatically closes its associated job.
         #
-        # @option arguments [String] :job_id The name of the job to close
-        # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no jobs. (This includes `_all` string or when no jobs have been specified)
-        # @option arguments [Boolean] :force True if the job should be forcefully closed
-        # @option arguments [Time] :timeout Controls the time to wait until a job has closed. Default to 30 minutes
+        # @option arguments [String] :job_id Identifier for the anomaly detection job. It can be a job identifier, a group name, or a wildcard expression. You can close multiple anomaly detection jobs in a single API request by using a group name, a comma-separated list of jobs, or a wildcard expression. You can close all jobs by using +_all+ or by specifying +*+ as the job identifier. (*Required*)
+        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request: contains wildcard expressions and there are no jobs that match; contains the  +_all+ string or no identifiers and there are no matches; or contains wildcard expressions and there are only partial matches. By default, it returns an empty jobs array when there are no matches and the subset of results when there are partial matches.
+        #  If +false+, the request returns a 404 status code when there are no matches or only partial matches. Server default: true.
+        # @option arguments [Boolean] :force Use to close a failed job, or to forcefully close a job which has not responded to its initial close request; the request returns without performing the associated actions such as flushing buffers and persisting the model snapshots.
+        #  If you want the job to be in a consistent state after the close job API returns, do not set to +true+. This parameter should be used only in situations where the job has already failed or where you are not interested in results the job might have recently produced or might produce in the future.
+        # @option arguments [Time] :timeout Controls the time to wait until a job has closed. Server default: 30m.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The URL params optionally sent in the body
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-close-job.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-close-job
         #
         def close_job(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.close_job' }
@@ -51,7 +57,7 @@ module Elasticsearch
           _job_id = arguments.delete(:job_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/_close"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/_close"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,19 +15,20 @@
 # 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
-        # Deletes a calendar.
+        # Delete a calendar.
+        # Remove all scheduled events from a calendar, then delete it.
         #
-        # @option arguments [String] :calendar_id The ID of the calendar to delete
+        # @option arguments [String] :calendar_id A string that uniquely identifies a calendar. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-delete-calendar.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-delete-calendar
         #
         def delete_calendar(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.delete_calendar' }
@@ -47,7 +48,7 @@ module Elasticsearch
           _calendar_id = arguments.delete(:calendar_id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_ml/calendars/#{Utils.__listify(_calendar_id)}"
+          path   = "_ml/calendars/#{Utils.listify(_calendar_id)}"
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,25 +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
-        # Deletes scheduled events from a calendar.
+        # Delete events from a calendar.
         #
-        # @option arguments [String] :calendar_id The ID of the calendar to modify
-        # @option arguments [String] :event_id The ID of the event to remove from the calendar
+        # @option arguments [String] :calendar_id A string that uniquely identifies a calendar. (*Required*)
+        # @option arguments [String] :event_id Identifier for the scheduled event.
+        #  You can obtain this identifier by using the get calendar events API. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-delete-calendar-event.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-delete-calendar-event
         #
         def delete_calendar_event(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.delete_calendar_event' }
 
-          defined_params = %i[calendar_id event_id].each_with_object({}) do |variable, set_variables|
+          defined_params = [:calendar_id, :event_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?
@@ -51,7 +52,7 @@ module Elasticsearch
           _event_id = arguments.delete(:event_id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_ml/calendars/#{Utils.__listify(_calendar_id)}/events/#{Utils.__listify(_event_id)}"
+          path   = "_ml/calendars/#{Utils.listify(_calendar_id)}/events/#{Utils.listify(_event_id)}"
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,25 +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
-        # Deletes anomaly detection jobs from a calendar.
+        # Delete anomaly jobs from a calendar.
         #
-        # @option arguments [String] :calendar_id The ID of the calendar to modify
-        # @option arguments [String] :job_id The ID of the job to remove from the calendar
+        # @option arguments [String] :calendar_id A string that uniquely identifies a calendar. (*Required*)
+        # @option arguments [String, Array] :job_id An identifier for the anomaly detection jobs. It can be a job identifier, a group name, or a
+        #  comma-separated list of jobs or groups. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-delete-calendar-job.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-delete-calendar-job
         #
         def delete_calendar_job(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.delete_calendar_job' }
 
-          defined_params = %i[calendar_id job_id].each_with_object({}) do |variable, set_variables|
+          defined_params = [:calendar_id, :job_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?
@@ -51,7 +52,7 @@ module Elasticsearch
           _job_id = arguments.delete(:job_id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_ml/calendars/#{Utils.__listify(_calendar_id)}/jobs/#{Utils.__listify(_job_id)}"
+          path   = "_ml/calendars/#{Utils.listify(_calendar_id)}/jobs/#{Utils.listify(_job_id)}"
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,21 +15,21 @@
 # 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
-        # Deletes an existing data frame analytics job.
+        # Delete a data frame analytics job.
         #
-        # @option arguments [String] :id The ID of the data frame analytics to delete
-        # @option arguments [Boolean] :force True if the job should be forcefully deleted
-        # @option arguments [Time] :timeout Controls the time to wait until a job is deleted. Defaults to 1 minute
+        # @option arguments [String] :id Identifier for the data frame analytics job. (*Required*)
+        # @option arguments [Boolean] :force If +true+, it deletes a job that is not stopped; this method is quicker than stopping and deleting the job.
+        # @option arguments [Time] :timeout The time to wait for the job to be deleted. Server default: 1m.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/delete-dfanalytics.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-delete-data-frame-analytics
         #
         def delete_data_frame_analytics(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.delete_data_frame_analytics' }
@@ -49,7 +49,7 @@ module Elasticsearch
           _id = arguments.delete(:id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_ml/data_frame/analytics/#{Utils.__listify(_id)}"
+          path   = "_ml/data_frame/analytics/#{Utils.listify(_id)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,20 +15,24 @@
 # 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
-        # Deletes an existing datafeed.
+        # Delete a datafeed.
         #
-        # @option arguments [String] :datafeed_id The ID of the datafeed to delete
-        # @option arguments [Boolean] :force True if the datafeed should be forcefully deleted
+        # @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 [Boolean] :force Use to forcefully delete a started datafeed; this method is quicker than
+        #  stopping and deleting the datafeed.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-delete-datafeed.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-delete-datafeed
         #
         def delete_datafeed(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.delete_datafeed' }
@@ -48,7 +52,7 @@ module Elasticsearch
           _datafeed_id = arguments.delete(:datafeed_id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_ml/datafeeds/#{Utils.__listify(_datafeed_id)}"
+          path   = "_ml/datafeeds/#{Utils.listify(_datafeed_id)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,22 +15,32 @@
 # 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
-        # Deletes expired and unused machine learning data.
+        # Delete expired ML data.
+        # Delete all job results, model snapshots and forecast data that have exceeded
+        # their retention days period. Machine learning state documents that are not
+        # associated with any job are also deleted.
+        # You can limit the request to a single or set of anomaly detection jobs by
+        # using a job identifier, a group name, a comma-separated list of jobs, or a
+        # wildcard expression. You can delete expired data for all anomaly detection
+        # jobs by using +_all+, by specifying +*+ as the +<job_id>+, or by omitting the
+        # +<job_id>+.
         #
-        # @option arguments [String] :job_id The ID of the job(s) to perform expired data hygiene for
-        # @option arguments [Number] :requests_per_second The desired requests per second for the deletion processes.
-        # @option arguments [Time] :timeout How long can the underlying delete processes run until they are canceled
+        # @option arguments [String] :job_id Identifier for an anomaly detection job. It can be a job identifier, a
+        #  group name, or a wildcard expression.
+        # @option arguments [Float] :requests_per_second The desired requests per second for the deletion processes. The default
+        #  behavior is no throttling.
+        # @option arguments [Time] :timeout How long can the underlying delete processes run until they are canceled. Server default: 8h.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body deleting expired data parameters
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-delete-expired-data.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-delete-expired-data
         #
         def delete_expired_data(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.delete_expired_data' }
@@ -49,7 +59,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_DELETE
           path   = if _job_id
-                     "_ml/_delete_expired_data/#{Utils.__listify(_job_id)}"
+                     "_ml/_delete_expired_data/#{Utils.listify(_job_id)}"
                    else
                      '_ml/_delete_expired_data'
                    end

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

@@ -15,19 +15,21 @@
 # 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
-        # Deletes a filter.
+        # Delete a filter.
+        # If an anomaly detection job references the filter, you cannot delete the
+        # filter. You must update or delete the job before you can delete the filter.
         #
-        # @option arguments [String] :filter_id The ID of the filter to delete
+        # @option arguments [String] :filter_id A string that uniquely identifies a filter. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-delete-filter.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-delete-filter
         #
         def delete_filter(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.delete_filter' }
@@ -47,7 +49,7 @@ module Elasticsearch
           _filter_id = arguments.delete(:filter_id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_ml/filters/#{Utils.__listify(_filter_id)}"
+          path   = "_ml/filters/#{Utils.listify(_filter_id)}"
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,27 +15,38 @@
 # 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
-        # Deletes forecasts from a machine learning job.
+        # Delete forecasts from a job.
+        # By default, forecasts are retained for 14 days. You can specify a
+        # different retention period with the +expires_in+ parameter in the forecast
+        # jobs API. The delete forecast API enables you to delete one or more
+        # forecasts before they expire.
         #
-        # @option arguments [String] :job_id The ID of the job from which to delete forecasts
-        # @option arguments [String] :forecast_id The ID of the forecast to delete, can be comma delimited list. Leaving blank implies `_all`
-        # @option arguments [Boolean] :allow_no_forecasts Whether to ignore if `_all` matches no forecasts
-        # @option arguments [Time] :timeout Controls the time to wait until the forecast(s) are deleted. Default to 30 seconds
+        # @option arguments [String] :job_id Identifier for the anomaly detection job. (*Required*)
+        # @option arguments [String] :forecast_id A comma-separated list of forecast identifiers. If you do not specify
+        #  this optional parameter or if you specify +_all+ or +*+ the API deletes
+        #  all forecasts from the job.
+        # @option arguments [Boolean] :allow_no_forecasts Specifies whether an error occurs when there are no forecasts. In
+        #  particular, if this parameter is set to +false+ and there are no
+        #  forecasts associated with the job, attempts to delete all forecasts
+        #  return an error. Server default: true.
+        # @option arguments [Time] :timeout Specifies the period of time to wait for the completion of the delete
+        #  operation. When this period of time elapses, the API fails and returns an
+        #  error. Server default: 30s.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-delete-forecast.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-delete-forecast
         #
         def delete_forecast(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.delete_forecast' }
 
-          defined_params = %i[job_id forecast_id].each_with_object({}) do |variable, set_variables|
+          defined_params = [:job_id, :forecast_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,9 +64,9 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_DELETE
           path   = if _job_id && _forecast_id
-                     "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/_forecast/#{Utils.__listify(_forecast_id)}"
+                     "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/_forecast/#{Utils.listify(_forecast_id)}"
                    else
-                     "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/_forecast"
+                     "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/_forecast"
                    end
           params = Utils.process_params(arguments)
 

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

@@ -15,22 +15,32 @@
 # 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
-        # Deletes an existing anomaly detection job.
+        # Delete an anomaly detection job.
+        # All job configuration, model state and results are deleted.
+        # It is not currently possible to delete multiple jobs using wildcards or a
+        # comma separated list. If you delete a job that has a datafeed, the request
+        # first tries to delete the datafeed. This behavior is equivalent to calling
+        # the delete datafeed API with the same timeout and force parameters as the
+        # delete job request.
         #
-        # @option arguments [String] :job_id The ID of the job to delete
-        # @option arguments [Boolean] :force True if the job should be forcefully deleted
-        # @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 Identifier for the anomaly detection job. (*Required*)
+        # @option arguments [Boolean] :force Use to forcefully delete an opened job; this method is quicker than
+        #  closing and deleting the job.
+        # @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 [Boolean] :wait_for_completion Specifies whether the request should return immediately or wait until the
+        #  job deletion completes. Server default: true.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-delete-job.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-delete-job
         #
         def delete_job(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.delete_job' }
@@ -50,7 +60,7 @@ module Elasticsearch
           _job_id = arguments.delete(:job_id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,25 +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
-        # Deletes an existing model snapshot.
+        # Delete a model snapshot.
+        # You cannot delete the active model snapshot. To delete that snapshot, first
+        # revert to a different one. To identify the active model snapshot, refer to
+        # the +model_snapshot_id+ in the results from the get jobs API.
         #
-        # @option arguments [String] :job_id The ID of the job to fetch
-        # @option arguments [String] :snapshot_id The ID of the snapshot to delete
+        # @option arguments [String] :job_id Identifier for the anomaly detection job. (*Required*)
+        # @option arguments [String] :snapshot_id Identifier for the model snapshot. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-delete-snapshot.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-delete-model-snapshot
         #
         def delete_model_snapshot(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.delete_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?
@@ -51,7 +54,7 @@ module Elasticsearch
           _snapshot_id = arguments.delete(:snapshot_id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/model_snapshots/#{Utils.__listify(_snapshot_id)}"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/model_snapshots/#{Utils.listify(_snapshot_id)}"
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,21 +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
-        # Deletes an existing trained inference model that is currently not referenced by an ingest pipeline.
+        # Delete an unreferenced trained model.
+        # The request deletes a trained inference model that is not referenced by an ingest pipeline.
         #
-        # @option arguments [String] :model_id The ID of the trained model to delete
-        # @option arguments [Time] :timeout Controls the amount of time to wait for the model to be deleted.
-        # @option arguments [Boolean] :force True if the model should be forcefully deleted
+        # @option arguments [String] :model_id The unique identifier of the trained model. (*Required*)
+        # @option arguments [Boolean] :force Forcefully deletes a trained model that is referenced by ingest pipelines or has a started deployment.
+        # @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/8.18/delete-trained-models.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-delete-trained-model
         #
         def delete_trained_model(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.delete_trained_model' }
@@ -49,7 +50,7 @@ module Elasticsearch
           _model_id = arguments.delete(:model_id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          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/delete_trained_model_alias.rb

@@ -15,25 +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
-        # Deletes a model alias that refers to the trained model
+        # Delete a trained model alias.
+        # This API deletes an existing model alias that refers to a trained model. If
+        # the model alias is missing or refers to a model other than the one identified
+        # by the +model_id+, this API returns an error.
         #
-        # @option arguments [String] :model_alias The trained model alias to delete
-        # @option arguments [String] :model_id The trained model where the model alias is assigned
+        # @option arguments [String] :model_alias The model alias to delete. (*Required*)
+        # @option arguments [String] :model_id The trained model ID to which the model alias refers. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.18/delete-trained-models-aliases.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-delete-trained-model-alias
         #
         def delete_trained_model_alias(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.delete_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?
@@ -51,7 +54,7 @@ module Elasticsearch
           _model_id = arguments.delete(:model_id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          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 = {}
 
           Elasticsearch::API::Response.new(