elasticsearch-api 8.17.2 → 9.0.0

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

@@ -15,28 +15,37 @@
 # 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 detection job results for one or more influencers.
+        # Get anomaly detection job results for influencers.
+        # Influencers are the entities that have contributed to, or are to blame for,
+        # the anomalies. Influencer results are available only if an
+        # +influencer_field_name+ is specified in the job configuration.
         #
-        # @option arguments [String] :job_id Identifier for the anomaly detection job
-        # @option arguments [Boolean] :exclude_interim Exclude interim results
-        # @option arguments [Integer] :from skips a number of influencers
-        # @option arguments [Integer] :size specifies a max number of influencers to get
-        # @option arguments [String] :start start timestamp for the requested influencers
-        # @option arguments [String] :end end timestamp for the requested influencers
-        # @option arguments [Double] :influencer_score influencer score threshold for the requested influencers
-        # @option arguments [String] :sort sort field for the requested influencers
-        # @option arguments [Boolean] :desc whether the results should be sorted in decending order
+        # @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 influencers with timestamps earlier than this time.
+        #  The default value means it is unset and results are not limited to
+        #  specific timestamps. Server default: -1.
+        # @option arguments [Boolean] :exclude_interim If true, the output excludes interim results. By default, interim results
+        #  are included.
+        # @option arguments [Float] :influencer_score Returns influencers with anomaly scores greater than or equal to this
+        #  value. Server default: 0.
+        # @option arguments [Integer] :from Skips the specified number of influencers. Server default: 0.
+        # @option arguments [Integer] :size Specifies the maximum number of influencers to obtain. Server default: 100.
+        # @option arguments [String] :sort Specifies the sort field for the requested influencers. By default, the
+        #  influencers are sorted by the +influencer_score+ value.
+        # @option arguments [String, Time] :start Returns influencers with timestamps after this time. The default value
+        #  means it is unset and results are not limited to specific timestamps. Server default: -1.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body Influencer selection criteria
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-get-influencer.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-get-influencers
         #
         def get_influencers(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.get_influencers' }
@@ -61,7 +70,7 @@ module Elasticsearch
                      Elasticsearch::API::HTTP_GET
                    end
 
-          path = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/results/influencers"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/results/influencers"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,20 +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 anomaly detection jobs.
+        # Get anomaly detection jobs usage info.
         #
-        # @option arguments [String] :job_id The ID of the jobs stats to fetch
-        # @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 [String] :job_id Identifier for the anomaly detection job. It can be a job identifier, a
+        #  group name, a comma-separated list of jobs, or a wildcard expression. If
+        #  you do not specify one of these options, the API returns information for
+        #  all anomaly detection jobs.
+        # @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.
+        #  - Contains wildcard expressions and there are only partial matches.
+        #  If +true+, the API returns an empty +jobs+ array when
+        #  there are no matches and the subset of results when there are partial
+        #  matches. If +false+, the API returns a +404+ status
+        #  code when there are no matches or only partial matches. Server default: true.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-get-job-stats.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-get-job-stats
         #
         def get_job_stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.get_job_stats' }
@@ -47,7 +57,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _job_id
-                     "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/_stats"
+                     "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/_stats"
                    else
                      '_ml/anomaly_detectors/_stats'
                    end

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

@@ -15,21 +15,36 @@
 # 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 anomaly detection jobs.
+        # Get anomaly detection jobs configuration info.
+        # You can get information for 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 get information 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 jobs to fetch
-        # @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] :exclude_generated Omits fields that are illegal to set on job PUT
+        # @option arguments [String, Array] :job_id Identifier for the anomaly detection job. It can be a job identifier, a
+        #  group name, or a wildcard expression. If you do not specify one of these
+        #  options, the API returns information for all anomaly detection jobs.
+        # @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.
+        #  - Contains wildcard expressions and there are only partial matches.
+        #  The default value is +true+, which returns an empty +jobs+ 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] :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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-get-job.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-get-jobs
         #
         def get_jobs(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.get_jobs' }
@@ -48,7 +63,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _job_id
-                     "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}"
+                     "_ml/anomaly_detectors/#{Utils.listify(_job_id)}"
                    else
                      '_ml/anomaly_detectors'
                    end

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

@@ -15,21 +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
-        # Returns information on how ML is using memory.
+        # Get machine learning memory usage info.
+        # Get information about how machine learning jobs and trained models are using memory,
+        # on each node, both within the JVM heap, and natively, outside of the JVM.
         #
-        # @option arguments [String] :node_id Specifies the node or nodes to retrieve stats for.
-        # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
-        # @option arguments [Time] :timeout Explicit operation timeout
+        # @option arguments [String] :node_id The names of particular nodes in the cluster to target. For example, +nodeId1,nodeId2+ or
+        #  +ml:true+
+        # @option arguments [Time] :master_timeout Period to wait for a connection to the master node. If no response is received before the timeout
+        #  expires, the request fails and returns an error. Server default: 30s.
+        # @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.17/get-ml-memory.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-get-memory-stats
         #
         def get_memory_stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.get_memory_stats' }
@@ -48,7 +53,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _node_id
-                     "_ml/memory/#{Utils.__listify(_node_id)}/_stats"
+                     "_ml/memory/#{Utils.listify(_node_id)}/_stats"
                    else
                      '_ml/memory/_stats'
                    end

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

@@ -15,26 +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
-        # Gets stats for anomaly detection job model snapshot upgrades that are in progress.
+        # Get anomaly detection job model snapshot upgrade usage info.
         #
-        # @option arguments [String] :job_id The ID of the job. May be a wildcard, comma separated list or `_all`.
-        # @option arguments [String] :snapshot_id The ID of the snapshot. May be a wildcard, comma separated list or `_all`.
-        # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no jobs or no snapshots. (This includes the `_all` string.)
+        # @option arguments [String] :job_id Identifier for the anomaly detection job. (*Required*)
+        # @option arguments [String] :snapshot_id A numerical character string that uniquely identifies the model snapshot. You can get information for multiple
+        #  snapshots by using a comma-separated list or a wildcard expression. You can get all snapshots by using +_all+,
+        #  by specifying +*+ as the snapshot ID, or by omitting the snapshot ID. (*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.
+        #  -  Contains wildcard expressions and there are only partial matches.
+        #  The default value is true, which returns an empty jobs 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.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-get-job-model-snapshot-upgrade-stats.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-get-model-snapshot-upgrade-stats
         #
         def get_model_snapshot_upgrade_stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.get_model_snapshot_upgrade_stats' }
 
-          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?
@@ -52,7 +60,7 @@ module Elasticsearch
           _snapshot_id = arguments.delete(:snapshot_id)
 
           method = Elasticsearch::API::HTTP_GET
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/model_snapshots/#{Utils.__listify(_snapshot_id)}/_upgrade/_stats"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/model_snapshots/#{Utils.listify(_snapshot_id)}/_upgrade/_stats"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,32 +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
-        # Retrieves information about model snapshots.
+        # Get model snapshots info.
         #
-        # @option arguments [String] :job_id The ID of the job to fetch
-        # @option arguments [String] :snapshot_id The ID of the snapshot to fetch
-        # @option arguments [Integer] :from Skips a number of documents
-        # @option arguments [Integer] :size The default number of documents returned in queries as a string.
-        # @option arguments [Date] :start The filter 'start' query parameter
-        # @option arguments [Date] :end The filter 'end' query parameter
-        # @option arguments [String] :sort Name of the field to sort on
-        # @option arguments [Boolean] :desc True if the results should be sorted in descending order
+        # @option arguments [String] :job_id Identifier for the anomaly detection job. (*Required*)
+        # @option arguments [String] :snapshot_id A numerical character string that uniquely identifies the model snapshot. You can get information for multiple
+        #  snapshots by using a comma-separated list or a wildcard expression. You can get all snapshots by using +_all+,
+        #  by specifying +*+ as the snapshot ID, or by omitting the snapshot ID.
+        # @option arguments [Boolean] :desc If true, the results are sorted in descending order.
+        # @option arguments [String, Time] :end Returns snapshots with timestamps earlier than this time.
+        # @option arguments [Integer] :from Skips the specified number of snapshots. Server default: 0.
+        # @option arguments [Integer] :size Specifies the maximum number of snapshots to obtain. Server default: 100.
+        # @option arguments [String] :sort Specifies the sort field for the requested snapshots. By default, the
+        #  snapshots are sorted by their timestamp.
+        # @option arguments [String, Time] :start Returns snapshots with timestamps after this time.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body Model snapshot selection criteria
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-get-snapshot.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-get-model-snapshots
         #
         def get_model_snapshots(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.get_model_snapshots' }
 
-          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?
@@ -62,11 +65,11 @@ module Elasticsearch
                      Elasticsearch::API::HTTP_GET
                    end
 
-          path = if _job_id && _snapshot_id
-                   "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/model_snapshots/#{Utils.__listify(_snapshot_id)}"
-                 else
-                   "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/model_snapshots"
-                 end
+          path   = if _job_id && _snapshot_id
+                     "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/model_snapshots/#{Utils.listify(_snapshot_id)}"
+                   else
+                     "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/model_snapshots"
+                   end
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,27 +15,59 @@
 # 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 overall bucket results that summarize the bucket results of multiple anomaly detection jobs.
+        # Get overall bucket results.
+        # Retrievs overall bucket results that summarize the bucket results of
+        # multiple anomaly detection jobs.
+        # The +overall_score+ is calculated by combining the scores of all the
+        # buckets within the overall bucket span. First, the maximum
+        # +anomaly_score+ per anomaly detection job in the overall bucket is
+        # calculated. Then the +top_n+ of those scores are averaged to result in
+        # the +overall_score+. This means that you can fine-tune the
+        # +overall_score+ so that it is more or less sensitive to the number of
+        # jobs that detect an anomaly at the same time. For example, if you set
+        # +top_n+ to +1+, the +overall_score+ is the maximum bucket score in the
+        # overall bucket. Alternatively, if you set +top_n+ to the number of jobs,
+        # the +overall_score+ is high only when all jobs detect anomalies in that
+        # overall bucket. If you set the +bucket_span+ parameter (to a value
+        # greater than its default), the +overall_score+ is the maximum
+        # +overall_score+ of the overall buckets that have a span equal to the
+        # jobs' largest bucket span.
         #
-        # @option arguments [String] :job_id The job IDs for which to calculate overall bucket results
-        # @option arguments [Integer] :top_n The number of top job bucket scores to be used in the overall_score calculation
-        # @option arguments [String] :bucket_span The span of the overall buckets. Defaults to the longest job bucket_span
-        # @option arguments [Double] :overall_score Returns overall buckets with overall scores higher than this value
-        # @option arguments [Boolean] :exclude_interim If true overall buckets that include interim buckets will be excluded
-        # @option arguments [String] :start Returns overall buckets with timestamps after this time
-        # @option arguments [String] :end Returns overall buckets with timestamps earlier than this time
-        # @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 [String] :job_id Identifier for the anomaly detection job. It can be a job identifier, a
+        #  group name, a comma-separated list of jobs or groups, or a wildcard
+        #  expression.You can summarize the bucket results for all anomaly detection jobs by
+        #  using +_all+ or by specifying +*+ as the +<job_id>+. (*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.
+        #  - Contains wildcard expressions and there are only partial matches.
+        #  If +true+, the request returns an empty +jobs+ 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 [Time] :bucket_span The span of the overall buckets. Must be greater or equal to the largest
+        #  bucket span of the specified anomaly detection jobs, which is the default
+        #  value.By default, an overall bucket has a span equal to the largest bucket span
+        #  of the specified anomaly detection jobs. To override that behavior, use
+        #  the optional +bucket_span+ parameter.
+        # @option arguments [String, Time] :end Returns overall buckets with timestamps earlier than this time.
+        # @option arguments [Boolean] :exclude_interim If +true+, the output excludes interim results.
+        # @option arguments [Double, String] :overall_score Returns overall buckets with overall scores greater than or equal to this
+        #  value.
+        # @option arguments [String, Time] :start Returns overall buckets with timestamps after this time.
+        # @option arguments [Integer] :top_n The number of top anomaly detection job bucket scores to be used in the
+        #  +overall_score+ calculation. Server default: 1.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body Overall bucket selection details if not provided in URI
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-get-overall-buckets.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-get-overall-buckets
         #
         def get_overall_buckets(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.get_overall_buckets' }
@@ -60,7 +92,7 @@ module Elasticsearch
                      Elasticsearch::API::HTTP_GET
                    end
 
-          path = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/results/overall_buckets"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/results/overall_buckets"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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