elasticsearch-api 8.18.0 → 9.0.1

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

@@ -15,28 +15,40 @@
 # 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
-        # Retrieves anomaly records for an anomaly detection job.
+        # Get anomaly records for an anomaly detection job.
+        # Records contain the detailed analytical results. They describe the anomalous
+        # activity that has been identified in the input data based on the detector
+        # configuration.
+        # There can be many anomaly records depending on the characteristics and size
+        # of the input data. In practice, there are often too many to be able to
+        # manually process them. The machine learning features therefore perform a
+        # sophisticated aggregation of the anomaly records into buckets.
+        # The number of record results depends on the number of anomalies found in each
+        # bucket, which relates to the number of time series being modeled and the
+        # number of detectors.
         #
-        # @option arguments [String] :job_id The ID of the job
-        # @option arguments [Boolean] :exclude_interim Exclude interim results
-        # @option arguments [Integer] :from skips a number of records
-        # @option arguments [Integer] :size specifies a max number of records to get
-        # @option arguments [String] :start Start time filter for records
-        # @option arguments [String] :end End time filter for records
-        # @option arguments [Double] :record_score Returns records with anomaly scores greater or equal than this value
-        # @option arguments [String] :sort Sort records by a particular field
-        # @option arguments [Boolean] :desc Set the sort direction
+        # @option arguments [String] :job_id Identifier for the anomaly detection job. (*Required*)
+        # @option arguments [Boolean] :desc If true, the results are sorted in descending order.
+        # @option arguments [String, Time] :end Returns records with timestamps earlier than this time. The default value
+        #  means results are not limited to specific timestamps. Server default: -1.
+        # @option arguments [Boolean] :exclude_interim If +true+, the output excludes interim results.
+        # @option arguments [Integer] :from Skips the specified number of records. Server default: 0.
+        # @option arguments [Float] :record_score Returns records with anomaly scores greater or equal than this value. Server default: 0.
+        # @option arguments [Integer] :size Specifies the maximum number of records to obtain. Server default: 100.
+        # @option arguments [String] :sort Specifies the sort field for the requested records. Server default: record_score.
+        # @option arguments [String, Time] :start Returns records with timestamps after this time. The default value means
+        #  results are not limited to specific timestamps. Server default: -1.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body Record selection criteria
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-get-record.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-get-records
         #
         def get_records(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.get_records' }
@@ -61,7 +73,7 @@ module Elasticsearch
                      Elasticsearch::API::HTTP_GET
                    end
 
-          path = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/results/records"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/results/records"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,27 +15,39 @@
 # 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
-        # Retrieves configuration information for a trained inference model.
+        # Get trained model configuration info.
         #
-        # @option arguments [String] :model_id The ID of the trained models to fetch
-        # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no trained models. (This includes `_all` string or when no trained models have been specified)
-        # @option arguments [String] :include A comma-separate list of fields to optionally include. Valid options are 'definition' and 'total_feature_importance'. Default is none.
-        # @option arguments [Boolean] :include_model_definition Should the full model definition be included in the results. These definitions can be large. So be cautious when including them. Defaults to false. *Deprecated*
-        # @option arguments [Boolean] :decompress_definition Should the model definition be decompressed into valid JSON or returned in a custom compressed format. Defaults to true.
-        # @option arguments [Integer] :from skips a number of trained models
-        # @option arguments [Integer] :size specifies a max number of trained models to get
-        # @option arguments [List] :tags A comma-separated list of tags that the model must have.
-        # @option arguments [Boolean] :exclude_generated Omits fields that are illegal to set on model PUT
+        # @option arguments [String, Array] :model_id The unique identifier of the trained model or a model alias.You can get information for multiple trained models in a single API
+        #  request by using a comma-separated list of model IDs or a wildcard
+        #  expression.
+        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request:
+        #  - Contains wildcard expressions and there are no models that match.
+        #  - Contains the _all string or no identifiers and there are no matches.
+        #  - Contains wildcard expressions and there are only partial matches.
+        #  If true, it returns an empty array when there are no matches and the
+        #  subset of results when there are partial matches. Server default: true.
+        # @option arguments [Boolean] :decompress_definition Specifies whether the included model definition should be returned as a
+        #  JSON map (true) or in a custom compressed format (false). Server default: true.
+        # @option arguments [Boolean] :exclude_generated Indicates if certain fields should be removed from the configuration on
+        #  retrieval. This allows the configuration to be in an acceptable format to
+        #  be retrieved and then added to another cluster.
+        # @option arguments [Integer] :from Skips the specified number of models. Server default: 0.
+        # @option arguments [String] :include A comma delimited string of optional fields to include in the response
+        #  body.
+        # @option arguments [Integer] :size Specifies the maximum number of models to obtain. Server default: 100.
+        # @option arguments [String] :tags A comma delimited string of tags. A trained model can have many tags, or
+        #  none. When supplied, only trained models that contain all the supplied
+        #  tags are returned.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-trained-models.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-get-trained-models
         #
         def get_trained_models(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.get_trained_models' }
@@ -54,7 +66,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _model_id
-                     "_ml/trained_models/#{Utils.__listify(_model_id)}"
+                     "_ml/trained_models/#{Utils.listify(_model_id)}"
                    else
                      '_ml/trained_models'
                    end

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

@@ -15,22 +15,30 @@
 # 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
-        # Retrieves usage information for trained inference models.
+        # Get trained models usage info.
+        # You can get usage information for multiple trained
+        # models in a single API request by using a comma-separated list of model IDs or a wildcard expression.
         #
-        # @option arguments [String] :model_id The ID of the trained models stats to fetch
-        # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no trained models. (This includes `_all` string or when no trained models have been specified)
-        # @option arguments [Integer] :from skips a number of trained models
-        # @option arguments [Integer] :size specifies a max number of trained models to get
+        # @option arguments [String, Array] :model_id The unique identifier of the trained model or a model alias. It can be a
+        #  comma-separated list or a wildcard expression.
+        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request:
+        #  - Contains wildcard expressions and there are no models that match.
+        #  - Contains the _all string or no identifiers and there are no matches.
+        #  - Contains wildcard expressions and there are only partial matches.
+        #  If true, it returns an empty array when there are no matches and the
+        #  subset of results when there are partial matches. Server default: true.
+        # @option arguments [Integer] :from Skips the specified number of models. Server default: 0.
+        # @option arguments [Integer] :size Specifies the maximum number of models to obtain. Server default: 100.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-trained-models-stats.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-get-trained-models-stats
         #
         def get_trained_models_stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.get_trained_models_stats' }
@@ -49,7 +57,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _model_id
-                     "_ml/trained_models/#{Utils.__listify(_model_id)}/_stats"
+                     "_ml/trained_models/#{Utils.listify(_model_id)}/_stats"
                    else
                      '_ml/trained_models/_stats'
                    end

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

@@ -15,9 +15,9 @@
 # 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
@@ -25,16 +25,11 @@ module Elasticsearch
         # Evaluate a trained model.
         #
         # @option arguments [String] :model_id The unique identifier of the trained model. (*Required*)
-        # @option arguments [Time] :timeout Controls the amount of time to wait for inference results.
+        # @option arguments [Time] :timeout Controls the amount of time to wait for inference results. Server default: 10s.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The docs to apply inference on and inference configuration overrides (*Required*)
-        #
-        # *Deprecation notice*:
-        # /_ml/trained_models/{model_id}/deployment/_infer is deprecated. Use /_ml/trained_models/{model_id}/_infer instead
-        # Deprecated since version 8.3.0
-        #
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/infer-trained-model.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-infer-trained-model
         #
         def infer_trained_model(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.infer_trained_model' }
@@ -55,7 +50,7 @@ module Elasticsearch
           _model_id = arguments.delete(:model_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = ("_ml/trained_models/#{Utils.__listify(_model_id)}/deployment/_infer" if _model_id)
+          path   = "_ml/trained_models/#{Utils.listify(_model_id)}/_infer"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,18 +15,25 @@
 # 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
-        # Returns defaults and limits used by machine learning.
+        # Get machine learning information.
+        # Get defaults and limits used by machine learning.
+        # This endpoint is designed to be used by a user interface that needs to fully
+        # understand machine learning configurations where some options are not
+        # specified, meaning that the defaults should be used. This endpoint may be
+        # used to find out what those defaults are. It also provides information about
+        # the maximum size of machine learning jobs that could run in the current
+        # cluster configuration.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-ml-info.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-info
         #
         def info(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.info' }
@@ -34,7 +41,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_ml/info'

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

@@ -15,20 +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
-        # Opens one or more anomaly detection jobs.
+        # Open anomaly detection jobs.
+        # An anomaly detection job must be opened to be ready to receive and analyze
+        # data. It can be opened and closed multiple times throughout its lifecycle.
+        # When you open a new job, it starts with an empty model.
+        # When you open an existing job, the most recent model state is automatically
+        # loaded. The job is ready to resume its analysis from where it left off, once
+        # new data is received.
         #
-        # @option arguments [String] :job_id The ID of the job to open
+        # @option arguments [String] :job_id Identifier for the anomaly detection job. (*Required*)
+        # @option arguments [Time] :timeout Controls the time to wait until a job has opened. Server default: 30m.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body Query parameters can be specified in the body
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-open-job.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-open-job
         #
         def open_job(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.open_job' }
@@ -48,8 +55,8 @@ module Elasticsearch
           _job_id = arguments.delete(:job_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/_open"
-          params = {}
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/_open"
+          params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(
             perform_request(method, path, params, body, headers, request_opts)

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

@@ -15,20 +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
-        # Posts scheduled events in a calendar.
+        # Add scheduled events to the calendar.
         #
-        # @option arguments [String] :calendar_id The ID of the calendar to modify
+        # @option arguments [String] :calendar_id A string that uniquely identifies a calendar. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body A list of events (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-post-calendar-event.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-post-calendar-events
         #
         def post_calendar_events(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.post_calendar_events' }
@@ -49,7 +49,7 @@ module Elasticsearch
           _calendar_id = arguments.delete(:calendar_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/calendars/#{Utils.__listify(_calendar_id)}/events"
+          path   = "_ml/calendars/#{Utils.listify(_calendar_id)}/events"
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,22 +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
-        # Sends data to an anomaly detection job for analysis.
+        # Send data to an anomaly detection job for analysis.
+        # IMPORTANT: For each job, data can be accepted from only a single connection at a time.
+        # It is not currently possible to post data to multiple jobs using wildcards or a comma-separated list.
         #
-        # @option arguments [String] :job_id The name of the job receiving the data
-        # @option arguments [String] :reset_start Optional parameter to specify the start of the bucket resetting range
-        # @option arguments [String] :reset_end Optional parameter to specify the end of the bucket resetting range
+        # @option arguments [String] :job_id Identifier for the anomaly detection job. The job must have a state of open to receive and process the data. (*Required*)
+        # @option arguments [String, Time] :reset_end Specifies the end of the bucket resetting range.
+        # @option arguments [String, Time] :reset_start Specifies the start of the bucket resetting range.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The data to process (*Required*)
+        # @option arguments [Hash] :body data
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-post-data.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-post-data
         #
         def post_data(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.post_data' }
@@ -51,7 +53,7 @@ module Elasticsearch
           _job_id = arguments.delete(:job_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/_data"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/_data"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,20 +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
-        # Previews that will be analyzed given a data frame analytics config.
+        # Preview features used by data frame analytics.
+        # Preview the extracted features used by a data frame analytics config.
         #
-        # @option arguments [String] :id The ID of the data frame analytics to preview
+        # @option arguments [String] :id Identifier for the data frame analytics job.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The data frame analytics config to preview
+        # @option arguments [Hash] :body request body
         #
-        # @see http://www.elastic.co/guide/en/elasticsearch/reference/8.17/preview-dfanalytics.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-preview-data-frame-analytics
         #
         def preview_data_frame_analytics(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.preview_data_frame_analytics' }
@@ -51,11 +52,11 @@ module Elasticsearch
                      Elasticsearch::API::HTTP_GET
                    end
 
-          path = if _id
-                   "_ml/data_frame/analytics/#{Utils.__listify(_id)}/_preview"
-                 else
-                   '_ml/data_frame/analytics/_preview'
-                 end
+          path   = if _id
+                     "_ml/data_frame/analytics/#{Utils.listify(_id)}/_preview"
+                   else
+                     '_ml/data_frame/analytics/_preview'
+                   end
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,22 +15,33 @@
 # 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
-        # Previews a datafeed.
+        # Preview a datafeed.
+        # This API returns the first "page" of search results from a datafeed.
+        # You can preview an existing datafeed or provide configuration details for a datafeed
+        # and anomaly detection job in the API. The preview shows the structure of the data
+        # that will be passed to the anomaly detection engine.
+        # IMPORTANT: When Elasticsearch security features are enabled, the preview uses the credentials of the user that
+        # called the API. However, when the datafeed starts it uses the roles of the last user that created or updated the
+        # datafeed. To get a preview that accurately reflects the behavior of the datafeed, use the appropriate credentials.
+        # You can also use secondary authorization headers to supply the credentials.
         #
-        # @option arguments [String] :datafeed_id The ID of the datafeed to preview
-        # @option arguments [String] :start The start time from where the datafeed preview should begin
-        # @option arguments [String] :end The end time when the datafeed preview should stop
+        # @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. NOTE: If you use this path parameter, you cannot provide datafeed or anomaly detection job
+        #  configuration details in the request body.
+        # @option arguments [String, Time] :start The start time from where the datafeed preview should begin
+        # @option arguments [String, Time] :end The end time when the datafeed preview should stop
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The datafeed config and job config with which to execute the preview
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-preview-datafeed.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-preview-datafeed
         #
         def preview_datafeed(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.preview_datafeed' }
@@ -53,11 +64,11 @@ module Elasticsearch
                      Elasticsearch::API::HTTP_GET
                    end
 
-          path = if _datafeed_id
-                   "_ml/datafeeds/#{Utils.__listify(_datafeed_id)}/_preview"
-                 else
-                   '_ml/datafeeds/_preview'
-                 end
+          path   = if _datafeed_id
+                     "_ml/datafeeds/#{Utils.listify(_datafeed_id)}/_preview"
+                   else
+                     '_ml/datafeeds/_preview'
+                   end
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,20 +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
-        # Instantiates a calendar.
+        # Create a calendar.
         #
-        # @option arguments [String] :calendar_id The ID of the calendar to create
+        # @option arguments [String] :calendar_id A string that uniquely identifies a calendar. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The calendar details
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-put-calendar.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-put-calendar
         #
         def put_calendar(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.put_calendar' }
@@ -48,7 +48,7 @@ module Elasticsearch
           _calendar_id = arguments.delete(:calendar_id)
 
           method = Elasticsearch::API::HTTP_PUT
-          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/put_calendar_job.rb

@@ -15,25 +15,25 @@
 # 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
-        # Adds an anomaly detection job to a calendar.
+        # Add anomaly detection job to calendar.
         #
-        # @option arguments [String] :calendar_id The ID of the calendar to modify
-        # @option arguments [String] :job_id The ID of the job to add to 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.17/ml-put-calendar-job.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-put-calendar-job
         #
         def put_calendar_job(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.put_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 +51,7 @@ module Elasticsearch
           _job_id = arguments.delete(:job_id)
 
           method = Elasticsearch::API::HTTP_PUT
-          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(