[API] Updates generated API to df81426e814ecb513b012f2c0a706572964c606c

Author: picandocodigo

elasticsearch-api/lib/elasticsearch/api/actions/cat/indices.rb

@@ -32,6 +32,8 @@ module Actions
         # - total store size of all shards, including shard replicas
         # These metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.
         # To get an accurate count of Elasticsearch documents, use the cat count or count APIs.
+        # NOTE: Storage metrics reported by this API reflect the post-compression size of the indices on disk. Because these values are calculated after Elasticsearch compresses the data and processes deletions, they are typically significantly smaller than the raw, uncompressed data volume ingested.
+        # IMPORTANT: For Elastic Cloud Serverless, ingest billing is based on the raw, uncompressed data volume, not the post-compression metrics reported here. To learn more, refer to {https://www.elastic.co/docs/deploy-manage/cloud-organization/billing/elasticsearch-billing-dimensions Elasticsearch billing dimensions}.
         # CAT APIs are only intended for human consumption using the command line or Kibana console.
         # They are not intended for use by applications. For application consumption, use an index endpoint.
         #

elasticsearch-api/lib/elasticsearch/api/actions/graph/explore.rb

@@ -48,7 +48,7 @@ module Actions
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/group/endpoint-graph
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-graph
         #
         def explore(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'graph.explore' }

elasticsearch-api/lib/elasticsearch/api/actions/indices/get_migrate_reindex_status.rb

@@ -39,7 +39,7 @@ module Actions
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/group/endpoint-migration
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-migration
         #
         def get_migrate_reindex_status(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.get_migrate_reindex_status' }

elasticsearch-api/lib/elasticsearch/api/actions/indices/shrink.rb

@@ -34,6 +34,7 @@ module Actions
         # For example an index with 8 primary shards can be shrunk into 4, 2 or 1 primary shards or an index with 15 primary shards can be shrunk into 5, 3 or 1.
         # If the number of shards in the index is a prime number it can only be shrunk into a single primary shard
         #  Before shrinking, a (primary or replica) copy of every shard in the index must be present on the same node.
+        # IMPORTANT: If the source index already has one primary shard, configuring the shrink operation with 'index.number_of_shards: 1' will cause the request to fail. An index with one primary shard cannot be shrunk further.
         # The current write index on a data stream cannot be shrunk. In order to shrink the current write index, the data stream must first be rolled over so that a new write index is created and then the previous write index can be shrunk.
         # A shrink operation:
         # * Creates a new target index with the same definition as the source index, but with a smaller number of primary shards.

elasticsearch-api/lib/elasticsearch/api/actions/indices/stats.rb

@@ -31,7 +31,7 @@ module Actions
         # NOTE: When moving to another node, the shard-level statistics for a shard are cleared.
         # Although the shard is no longer part of the node, that node retains any node-level statistics to which the shard contributed.
         #
-        # @option arguments [String, Array<String>] :metric Limit the information returned the specific metrics
+        # @option arguments [String, Array<String>] :metric Comma-separated list of metrics used to limit the request.
         # @option arguments [String, Array] :index A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices
         # @option arguments [String, Array<String>] :completion_fields Comma-separated list or wildcard expressions of fields to include in fielddata and suggest statistics.
         # @option arguments [String, Array<String>] :expand_wildcards Type of index that wildcard patterns can match. If the request can target data streams, this argument

elasticsearch-api/lib/elasticsearch/api/actions/inference/put.rb

@@ -49,7 +49,7 @@ module Actions
         # * OpenAI (`chat_completion`, `completion`, `text_embedding`)
         # * OpenShift AI (`chat_completion`, `completion`, `rerank`, `text_embedding`)
         # * VoyageAI (`rerank`, `text_embedding`)
-        # * Watsonx inference integration (`text_embedding`)
+        # * Watsonx (`chat_completion`, `completion`, `rerank`, `text_embedding`)
         #
         # @option arguments [String] :task_type The task type. Refer to the integration list in the API description for the available task types.
         # @option arguments [String] :inference_id The inference Id (*Required*)

elasticsearch-api/lib/elasticsearch/api/actions/license/post.rb

@@ -30,7 +30,8 @@ module Actions
         # NOTE: If Elasticsearch security features are enabled and you are installing a gold or higher license, you must enable TLS on the transport networking layer before you install the license.
         # If the operator privileges feature is enabled, only operator users can use this API.
         #
-        # @option arguments [Boolean] :acknowledge Specifies whether you acknowledge the license changes.
+        # @option arguments [Boolean] :acknowledge To update a license, you must accept the acknowledge messages and set this parameter to `true`.
+        #  In particular, if you are upgrading or downgrading a license, you must acknowlege the feature changes.
         # @option arguments [Time] :master_timeout The period to wait for a connection to the master node. Server default: 30s.
         # @option arguments [Time] :timeout The 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 [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors

elasticsearch-api/lib/elasticsearch/api/actions/license/post_start_basic.rb

@@ -29,7 +29,7 @@ module Actions
         # You must then re-submit the API request with the `acknowledge` parameter set to `true`.
         # To check the status of your basic license, use the get basic license API.
         #
-        # @option arguments [Boolean] :acknowledge Whether the user has acknowledged acknowledge messages
+        # @option arguments [Boolean] :acknowledge To start a basic license, you must accept the acknowledge messages and set this parameter to `true`.
         # @option arguments [Time] :master_timeout Period to wait for a connection to the master node. 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 [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors

elasticsearch-api/lib/elasticsearch/api/actions/license/post_start_trial.rb

@@ -28,7 +28,7 @@ module Actions
         # For example, if you have already activated a trial for v8.0, you cannot start a new trial until v9.0. You can, however, request an extended trial at https://www.elastic.co/trialextension.
         # To check the status of your trial, use the get trial status API.
         #
-        # @option arguments [Boolean] :acknowledge Whether the user has acknowledged acknowledge messages
+        # @option arguments [Boolean] :acknowledge To start a trial, you must accept the acknowledge messages and set this parameter to `true`.
         # @option arguments [String] :type The type of trial license to generate Server default: trial.
         # @option arguments [Time] :master_timeout Period to wait for a connection to the master node. Server default: 30s.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors

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

@@ -23,9 +23,12 @@ module API
     module Migration
       module Actions
         # 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.
+        # Returns information about deprecated features which are in use in the cluster.
+        # The reported features include cluster, node, and index level settings that will be removed or changed in the next major version.
+        # You must address the reported issues before upgrading to the next major version.
+        # However, no action is required when upgrading within the current major version.
+        # Deprecated features remain fully supported and will continue to work in the current version, and when upgrading to a newer minor or patch release in the same major version.
+        # Use this API to review your usage of these features and migrate away from them at your own pace, before upgrading to a new major version.
         #
         # @option arguments [String] :index Comma-separate list of data streams or indices to check. Wildcard (*) expressions are supported.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors