elasticsearch-api 8.17.2 → 9.0.0

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

@@ -15,24 +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
-        # Stops one or more datafeeds.
+        # Stop datafeeds.
+        # A datafeed that is stopped ceases to retrieve data from Elasticsearch. A datafeed can be started and stopped
+        # multiple times throughout its lifecycle.
         #
-        # @option arguments [String] :datafeed_id The ID of the datafeed to stop
-        # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no datafeeds. (This includes `_all` string or when no datafeeds have been specified)
-        # @option arguments [Boolean] :allow_no_datafeeds Whether to ignore if a wildcard expression matches no datafeeds. (This includes `_all` string or when no datafeeds have been specified) *Deprecated*
-        # @option arguments [Boolean] :force True if the datafeed should be forcefully stopped.
-        # @option arguments [Time] :timeout Controls the time to wait until a datafeed has stopped. Default to 20 seconds
+        # @option arguments [String] :datafeed_id Identifier for the datafeed. You can stop multiple datafeeds in a single API request by using a comma-separated
+        #  list of datafeeds or a wildcard expression. You can close all datafeeds by using +_all+ or by specifying +*+ as
+        #  the identifier. (*Required*)
+        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request:
+        #  - Contains wildcard expressions and there are no datafeeds 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 datafeeds 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 [Boolean] :force If +true+, the datafeed is stopped forcefully.
+        # @option arguments [Time] :timeout Specifies the amount of time to wait until a datafeed stops. Server default: 20s.
         # @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.17/ml-stop-datafeed.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-stop-datafeed
         #
         def stop_datafeed(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.stop_datafeed' }
@@ -52,7 +61,7 @@ module Elasticsearch
           _datafeed_id = arguments.delete(:datafeed_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/datafeeds/#{Utils.__listify(_datafeed_id)}/_stop"
+          path   = "_ml/datafeeds/#{Utils.listify(_datafeed_id)}/_stop"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/stop_trained_model_deployment.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,12 +25,15 @@ module Elasticsearch
         # Stop a trained model deployment.
         #
         # @option arguments [String] :model_id The unique identifier of the trained model. (*Required*)
-        # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no deployments. (This includes `_all` string or when no deployments have been specified)
-        # @option arguments [Boolean] :force True if the deployment should be forcefully stopped
+        # @option arguments [Boolean] :allow_no_match Specifies what to do when the request: contains wildcard expressions and there are no deployments 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 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 Forcefully stops the deployment, even if it is used by ingest pipelines. You can't use these pipelines until you
+        #  restart the model deployment.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The stop deployment parameters
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/stop-trained-model-deployment.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-stop-trained-model-deployment
         #
         def stop_trained_model_deployment(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.stop_trained_model_deployment' }
@@ -45,12 +48,12 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body = arguments.delete(:body)
+          body = nil
 
           _model_id = arguments.delete(:model_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/trained_models/#{Utils.__listify(_model_id)}/deployment/_stop"
+          path   = "_ml/trained_models/#{Utils.listify(_model_id)}/deployment/_stop"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,20 +15,22 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
-        # Updates certain properties of a data frame analytics job.
+        # Update a data frame analytics job.
         #
-        # @option arguments [String] :id The ID of the data frame analytics to update
+        # @option arguments [String] :id Identifier for the data frame analytics job. This identifier can contain
+        #  lowercase alphanumeric characters (a-z and 0-9), hyphens, and
+        #  underscores. It must start and end with alphanumeric characters. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The data frame analytics settings to update (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/update-dfanalytics.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-update-data-frame-analytics
         #
         def update_data_frame_analytics(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.update_data_frame_analytics' }
@@ -49,7 +51,7 @@ module Elasticsearch
           _id = arguments.delete(:id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/data_frame/analytics/#{Utils.__listify(_id)}/_update"
+          path   = "_ml/data_frame/analytics/#{Utils.listify(_id)}/_update"
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,24 +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
-        # Updates certain properties of a datafeed.
+        # Update a datafeed.
+        # You must stop and start the datafeed for the changes to be applied.
+        # When Elasticsearch security features are enabled, your datafeed remembers which roles the user who updated it had at
+        # the time of the update and runs the query using those same roles. If you provide secondary authorization headers,
+        # those credentials are used instead.
         #
-        # @option arguments [String] :datafeed_id The ID of the datafeed to update
-        # @option arguments [Boolean] :ignore_unavailable Ignore unavailable indexes (default: false)
-        # @option arguments [Boolean] :allow_no_indices Ignore if the source indices expressions resolves to no concrete indices (default: true)
-        # @option arguments [Boolean] :ignore_throttled Ignore indices that are marked as throttled (default: true)
-        # @option arguments [String] :expand_wildcards Whether source index expressions should get expanded to open or closed indices (default: open) (options: open, closed, hidden, none, all)
+        # @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] :allow_no_indices If +true+, wildcard indices expressions that resolve into no concrete indices are ignored. This includes the
+        #  +_all+ string or when no indices are specified. Server default: true.
+        # @option arguments [String, Array<String>] :expand_wildcards Type of index that wildcard patterns can match. If the request can target data streams, this argument determines
+        #  whether wildcard expressions match hidden data streams. Supports comma-separated values. Valid values are:
+        #  - +all+: Match any data stream or index, including hidden ones.
+        #  - +closed+: Match closed, non-hidden indices. Also matches any non-hidden data stream. Data streams cannot be closed.
+        #  - +hidden+: Match hidden data streams and hidden indices. Must be combined with +open+, +closed+, or both.
+        #  - +none+: Wildcard patterns are not accepted.
+        #  - +open+: Match open, non-hidden indices. Also matches any non-hidden data stream. Server default: open.
+        # @option arguments [Boolean] :ignore_throttled If +true+, concrete, expanded or aliased indices are ignored when frozen. Server default: true.
+        # @option arguments [Boolean] :ignore_unavailable If +true+, unavailable indices (missing or closed) are ignored.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The datafeed update settings (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-update-datafeed.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-update-datafeed
         #
         def update_datafeed(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.update_datafeed' }
@@ -53,7 +66,7 @@ module Elasticsearch
           _datafeed_id = arguments.delete(:datafeed_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/datafeeds/#{Utils.__listify(_datafeed_id)}/_update"
+          path   = "_ml/datafeeds/#{Utils.listify(_datafeed_id)}/_update"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/update_filter.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
-        # Updates the description of a filter, adds items, or removes items.
+        # Update a filter.
+        # Updates the description of a filter, adds items, or removes items from the list.
         #
-        # @option arguments [String] :filter_id The ID of the filter to update
+        # @option arguments [String] :filter_id A string that uniquely identifies a filter. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The filter update (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-update-filter.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-update-filter
         #
         def update_filter(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.update_filter' }
@@ -49,7 +50,7 @@ module Elasticsearch
           _filter_id = arguments.delete(:filter_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/filters/#{Utils.__listify(_filter_id)}/_update"
+          path   = "_ml/filters/#{Utils.listify(_filter_id)}/_update"
           params = {}
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/update_job.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
+        # Update an anomaly detection job.
         # Updates certain properties of an anomaly detection job.
         #
-        # @option arguments [String] :job_id The ID of the job to create
+        # @option arguments [String] :job_id Identifier for the job. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The job update settings (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-update-job.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-update-job
         #
         def update_job(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.update_job' }
@@ -49,7 +50,7 @@ module Elasticsearch
           _job_id = arguments.delete(:job_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/_update"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/_update"
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,26 +15,27 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module MachineLearning
       module Actions
+        # Update a snapshot.
         # Updates certain properties of a snapshot.
         #
-        # @option arguments [String] :job_id The ID of the job to fetch
-        # @option arguments [String] :snapshot_id The ID of the snapshot to update
+        # @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
-        # @option arguments [Hash] :body The model snapshot properties to update (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-update-snapshot.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-update-model-snapshot
         #
         def update_model_snapshot(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.update_model_snapshot' }
 
-          defined_params = %i[job_id snapshot_id].each_with_object({}) do |variable, set_variables|
+          defined_params = [:job_id, :snapshot_id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
@@ -53,7 +54,7 @@ module Elasticsearch
           _snapshot_id = arguments.delete(:snapshot_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/model_snapshots/#{Utils.__listify(_snapshot_id)}/_update"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/model_snapshots/#{Utils.listify(_snapshot_id)}/_update"
           params = {}
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/machine_learning/update_trained_model_deployment.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
-        # Updates certain properties of trained model deployment.
+        # Update a trained model deployment.
         #
-        # @option arguments [String] :model_id The unique identifier of the trained model.
-        # @option arguments [Integer] :number_of_allocations Update the model deployment to this number of allocations.
+        # @option arguments [String] :model_id The unique identifier of the trained model. Currently, only PyTorch models are supported. (*Required*)
+        # @option arguments [Integer] :number_of_allocations The number of model allocations on each node where the model is deployed.
+        #  All allocations on a node share the same copy of the model in memory but use
+        #  a separate set of threads to evaluate the model.
+        #  Increasing this value generally increases the throughput.
+        #  If this setting is greater than the number of hardware threads
+        #  it will automatically be changed to a value less than the number of hardware threads. Server default: 1.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The updated trained model deployment settings
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/update-trained-model-deployment.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-update-trained-model-deployment
         #
         def update_trained_model_deployment(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.update_trained_model_deployment' }
@@ -49,7 +54,7 @@ module Elasticsearch
           _model_id = arguments.delete(:model_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/trained_models/#{Utils.__listify(_model_id)}/deployment/_update"
+          path   = "_ml/trained_models/#{Utils.listify(_model_id)}/deployment/_update"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,27 +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
-        # Upgrades a given job snapshot to the current major version.
+        # Upgrade a snapshot.
+        # Upgrade an anomaly detection model snapshot to the latest major version.
+        # Over time, older snapshot formats are deprecated and removed. Anomaly
+        # detection jobs support only snapshots that are from the current or previous
+        # major version.
+        # This API provides a means to upgrade a snapshot to the current major version.
+        # This aids in preparing the cluster for an upgrade to the next major version.
+        # Only one snapshot per anomaly detection job can be upgraded at a time and the
+        # upgraded snapshot cannot be the current snapshot of the anomaly detection
+        # job.
         #
-        # @option arguments [String] :job_id The ID of the job
-        # @option arguments [String] :snapshot_id The ID of the snapshot
-        # @option arguments [Time] :timeout How long should the API wait for the job to be opened and the old snapshot to be loaded.
-        # @option arguments [Boolean] :wait_for_completion Should the request wait until the task is complete before responding to the caller. Default is false.
+        # @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. (*Required*)
+        # @option arguments [Boolean] :wait_for_completion When true, the API won’t respond until the upgrade is complete.
+        #  Otherwise, it responds as soon as the upgrade task is assigned to a node.
+        # @option arguments [Time] :timeout Controls the time to wait for the request to complete. Server default: 30m.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ml-upgrade-job-model-snapshot.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-upgrade-job-snapshot
         #
         def upgrade_job_snapshot(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ml.upgrade_job_snapshot' }
 
-          defined_params = %i[job_id snapshot_id].each_with_object({}) do |variable, set_variables|
+          defined_params = [:job_id, :snapshot_id].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
@@ -53,7 +63,7 @@ module Elasticsearch
           _snapshot_id = arguments.delete(:snapshot_id)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_ml/anomaly_detectors/#{Utils.__listify(_job_id)}/model_snapshots/#{Utils.__listify(_snapshot_id)}/_upgrade"
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/model_snapshots/#{Utils.listify(_snapshot_id)}/_upgrade"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/mget.rb

@@ -15,28 +15,44 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Actions
-      # Allows to get multiple documents in one request.
+      # Get multiple documents.
+      # Get multiple JSON documents by ID from one or more indices.
+      # If you specify an index in the request URI, you only need to specify the document IDs in the request body.
+      # To ensure fast responses, this multi get (mget) API responds with partial results if one or more shards fail.
+      # **Filter source fields**
+      # By default, the +_source+ field is returned for every document (if stored).
+      # Use the +_source+ and +_source_include+ or +source_exclude+ attributes to filter what fields are returned for a particular document.
+      # You can include the +_source+, +_source_includes+, and +_source_excludes+ query parameters in the request URI to specify the defaults to use when there are no per-document instructions.
+      # **Get stored fields**
+      # Use the +stored_fields+ attribute to specify the set of stored fields you want to retrieve.
+      # Any requested fields that are not stored are ignored.
+      # You can include the +stored_fields+ query parameter in the request URI to specify the defaults to use when there are no per-document instructions.
       #
-      # @option arguments [String] :index The name of the index
-      # @option arguments [Boolean] :force_synthetic_source Should this request force synthetic _source? Use this to test if the mapping supports synthetic _source and to get a sense of the worst case performance. Fetches with this enabled will be slower the enabling synthetic source natively in the index.
-      # @option arguments [List] :stored_fields A comma-separated list of stored fields to return in the response
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on (default: random)
-      # @option arguments [Boolean] :realtime Specify whether to perform the operation in realtime or search mode
-      # @option arguments [Boolean] :refresh Refresh the shard containing the document before performing the operation
-      # @option arguments [String] :routing Specific routing value
-      # @option arguments [List] :_source True or false to return the _source field or not, or a list of fields to return
-      # @option arguments [List] :_source_excludes A list of fields to exclude from the returned _source field
-      # @option arguments [List] :_source_includes A list of fields to extract and return from the _source field
+      # @option arguments [String] :index Name of the index to retrieve documents from when +ids+ are specified, or when a document in the +docs+ array does not specify an index.
+      # @option arguments [Boolean] :force_synthetic_source Should this request force synthetic _source?
+      #  Use this to test if the mapping supports synthetic _source and to get a sense of the worst case performance.
+      #  Fetches with this enabled will be slower the enabling synthetic source natively in the index.
+      # @option arguments [String] :preference Specifies the node or shard the operation should be performed on. Random by default.
+      # @option arguments [Boolean] :realtime If +true+, the request is real-time as opposed to near-real-time. Server default: true.
+      # @option arguments [Boolean] :refresh If +true+, the request refreshes relevant shards before retrieving documents.
+      # @option arguments [String] :routing Custom value used to route operations to a specific shard.
+      # @option arguments [Boolean, String, Array<String>] :_source True or false to return the +_source+ field or not, or a list of fields to return.
+      # @option arguments [String, Array<String>] :_source_excludes A comma-separated list of source fields to exclude from the response.
+      #  You can also use this parameter to exclude fields from the subset specified in +_source_includes+ query parameter.
+      # @option arguments [String, Array<String>] :_source_includes A comma-separated list of source fields to include in the response.
+      #  If this parameter is specified, only these source fields are returned. You can exclude fields from this subset using the +_source_excludes+ query parameter.
+      #  If the +_source+ parameter is +false+, this parameter is ignored.
+      # @option arguments [String, Array<String>] :stored_fields If +true+, retrieves the document fields stored in the index rather than the document +_source+. Server default: false.
       # @option arguments [Hash] :headers Custom HTTP headers
-      # @option arguments [Hash] :body Document identifiers; can be either `docs` (containing full document information) or `ids` (when index is provided in the URL. (*Required*)
+      # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/docs-multi-get.html
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-mget
       #
       def mget(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'mget' }
@@ -51,13 +67,13 @@ module Elasticsearch
         arguments = arguments.clone
         headers = arguments.delete(:headers) || {}
 
-        body   = arguments.delete(:body)
+        body = arguments.delete(:body)
 
         _index = arguments.delete(:index)
 
         method = Elasticsearch::API::HTTP_POST
         path   = if _index
-                   "#{Utils.__listify(_index)}/_mget"
+                   "#{Utils.listify(_index)}/_mget"
                  else
                    '_mget'
                  end

data/lib/elasticsearch/api/actions/migration/deprecations.rb

@@ -15,19 +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 Migration
       module Actions
-        # Retrieves information about different cluster, node, and index level settings that use deprecated features that will be removed or changed in the next major version.
+        # Get deprecation information.
+        # Get information about different cluster, node, and index level settings that use deprecated features that will be removed or changed in the next major version.
+        # TIP: This APIs is designed for indirect use by the Upgrade Assistant.
+        # You are strongly recommended to use the Upgrade Assistant.
         #
-        # @option arguments [String] :index Index pattern
+        # @option arguments [String] :index Comma-separate list of data streams or indices to check. Wildcard (*) expressions are supported.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/migration-api-deprecation.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-migration-deprecations
         #
         def deprecations(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'migration.deprecations' }
@@ -40,13 +43,13 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           _index = arguments.delete(:index)
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _index
-                     "#{Utils.__listify(_index)}/_migration/deprecations"
+                     "#{Utils.listify(_index)}/_migration/deprecations"
                    else
                      '_migration/deprecations'
                    end

data/lib/elasticsearch/api/actions/migration/get_feature_upgrade_status.rb

@@ -15,18 +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 Migration
       module Actions
-        # Find out whether system features need to be upgraded or not
+        # Get feature migration information.
+        # Version upgrades sometimes require changes to how features store configuration information and data in system indices.
+        # Check which features need to be migrated and the status of any migrations that are in progress.
+        # TIP: This API is designed for indirect use by the Upgrade Assistant.
+        # You are strongly recommended to use the Upgrade Assistant.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/migration-api-feature-upgrade.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-migration-get-feature-upgrade-status
         #
         def get_feature_upgrade_status(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'migration.get_feature_upgrade_status' }
@@ -34,7 +38,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_migration/system_features'