elasticsearch-api 9.3.1 → 9.4.0

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

@@ -27,9 +27,16 @@ module Elasticsearch
       # @option arguments [String, Array] :index A  comma-separated list of data streams, indices, and index aliases used to limit the request.
       #  Wildcard (`*`) expressions are supported.
       #  To target all data streams and indices in a cluster, omit this parameter or use `_all` or `*`.
-      # @option arguments [Boolean] :allow_no_indices If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. This behavior applies even if the request targets other open indices. For example, a request targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`. Server default: true.
+      # @option arguments [Boolean] :allow_no_indices A setting that does two separate checks on the index expression.
+      #  If `false`, the request returns an error (1) if any wildcard expression
+      #  (including `_all` and `*`) resolves to zero matching indices or (2) if the
+      #  complete set of resolved indices, aliases or data streams is empty after all
+      #  expressions are evaluated. If `true`, index expressions that resolve to no
+      #  indices are allowed and the request returns an empty result. Server default: true.
       # @option arguments [String, Array<String>] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. Server default: open.
-      # @option arguments [Boolean] :ignore_unavailable If `true`, missing or closed indices are not included in the response.
+      # @option arguments [Boolean] :ignore_unavailable If `false`, the request returns an error if it targets a concrete (non-wildcarded)
+      #  index, alias, or data stream that is missing, closed, or otherwise unavailable.
+      #  If `true`, unavailable concrete targets are silently ignored.
       # @option arguments [String] :search_type Search operation type
       # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
       #  when they occur.
@@ -45,7 +52,7 @@ module Elasticsearch
       # @option arguments [Hash] :headers Custom HTTP headers
       # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-rank-eval
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-rank-eval
       #
       def rank_eval(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'rank_eval' }

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

@@ -36,6 +36,7 @@ module Elasticsearch
       # @option arguments [String] :task_id The task identifier, which can be found by using the tasks API. (*Required*)
       # @option arguments [Float] :requests_per_second The throttle for this request in sub-requests per second.
       #  It can be either `-1` to turn off throttling or any decimal number like `1.7` or `12` to throttle to that level. (*Required*)
+      # @option arguments [String] :group_by [TODO]
       # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
       #  when they occur.
       # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

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

@@ -40,7 +40,7 @@ module Elasticsearch
       # @option arguments [Hash] :headers Custom HTTP headers
       # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-render-search-template
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-render-search-template
       #
       def render_search_template(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'render_search_template' }

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

@@ -54,7 +54,7 @@ module Elasticsearch
       # Deprecated since version 7.0.0
       #
       #
-      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-scroll
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-scroll
       #
       def scroll(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'scroll' }

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

@@ -30,18 +30,20 @@ module Elasticsearch
       # **Search slicing**
       # When paging through a large number of documents, it can be helpful to split the search into multiple slices to consume them independently with the `slice` and `pit` properties.
       # By default the splitting is done first on the shards, then locally on each shard.
-      # The local splitting partitions the shard into contiguous ranges based on Lucene document IDs.
       # For instance if the number of shards is equal to 2 and you request 4 slices, the slices 0 and 2 are assigned to the first shard and the slices 1 and 3 are assigned to the second shard.
       # IMPORTANT: The same point-in-time ID should be used for all slices.
       # If different PIT IDs are used, slices can overlap and miss documents.
-      # This situation can occur because the splitting criterion is based on Lucene document IDs, which are not stable across changes to the index.
+      # This situation can occur because, by default, the splitting criterion is based on Lucene document IDs, which are not stable across changes to the index.
       #
       # @option arguments [String, Array] :index A comma-separated list of data streams, indices, and aliases to search.
       #  It supports wildcards (`*`).
       #  To search all data streams and indices, omit this parameter or use `*` or `_all`.
-      # @option arguments [Boolean] :allow_no_indices If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices.
-      #  This behavior applies even if the request targets other open indices.
-      #  For example, a request targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`. Server default: true.
+      # @option arguments [Boolean] :allow_no_indices A setting that does two separate checks on the index expression.
+      #  If `false`, the request returns an error (1) if any wildcard expression
+      #  (including `_all` and `*`) resolves to zero matching indices or (2) if the
+      #  complete set of resolved indices, aliases or data streams is empty after all
+      #  expressions are evaluated. If `true`, index expressions that resolve to no
+      #  indices are allowed and the request returns an empty result. Server default: true.
       # @option arguments [Boolean] :allow_partial_search_results If `true` and there are shard request timeouts or shard failures, the request returns partial results.
       #  If `false`, it returns an error with no partial results.To override the default behavior, you can set the `search.default_allow_partial_results` cluster setting to `false`. Server default: true.
       # @option arguments [String] :analyzer The analyzer to use for the query string.
@@ -61,7 +63,9 @@ module Elasticsearch
       #  It supports comma-separated values such as `open,hidden`. Server default: open.
       # @option arguments [Boolean] :explain If `true`, the request returns detailed information about score computation as part of a hit.
       # @option arguments [Boolean] :ignore_throttled If `true`, concrete, expanded or aliased indices will be ignored when frozen. Server default: true.
-      # @option arguments [Boolean] :ignore_unavailable If `false`, the request returns an error if it targets a missing or closed index.
+      # @option arguments [Boolean] :ignore_unavailable If `false`, the request returns an error if it targets a concrete (non-wildcarded)
+      #  index, alias, or data stream that is missing, closed, or otherwise unavailable.
+      #  If `true`, unavailable concrete targets are silently ignored.
       # @option arguments [Boolean] :include_named_queries_score If `true`, the response includes the score contribution from any named queries.This functionality reruns each named query on every hit in a search response.
       #  Typically, this adds a small overhead to a request.
       #  However, using computationally expensive named queries on a large number of hits may add significant overhead.
@@ -162,7 +166,7 @@ module Elasticsearch
       # @option arguments [Hash] :headers Custom HTTP headers
       # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search
       #
       def search(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'search' }

data/lib/elasticsearch/api/actions/search_application/delete.rb

@@ -43,7 +43,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-application-delete
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-application-delete
         #
         def delete(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'search_application.delete' }

data/lib/elasticsearch/api/actions/search_application/delete_behavioral_analytics.rb

@@ -42,7 +42,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-application-delete-behavioral-analytics
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-application-delete-behavioral-analytics
         #
         def delete_behavioral_analytics(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'search_application.delete_behavioral_analytics' }

data/lib/elasticsearch/api/actions/search_application/get.rb

@@ -42,7 +42,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-application-get
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-application-get
         #
         def get(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'search_application.get' }

data/lib/elasticsearch/api/actions/search_application/get_behavioral_analytics.rb

@@ -41,7 +41,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-application-get-behavioral-analytics
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-application-get-behavioral-analytics
         #
         def get_behavioral_analytics(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'search_application.get_behavioral_analytics' }

data/lib/elasticsearch/api/actions/search_application/list.rb

@@ -45,7 +45,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-application-get-behavioral-analytics
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-application-get-behavioral-analytics
         #
         def list(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'search_application.list' }

data/lib/elasticsearch/api/actions/search_application/post_behavioral_analytics_event.rb

@@ -44,7 +44,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body payload
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-application-post-behavioral-analytics-event
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-application-post-behavioral-analytics-event
         #
         def post_behavioral_analytics_event(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'search_application.post_behavioral_analytics_event' }

data/lib/elasticsearch/api/actions/search_application/put.rb

@@ -44,7 +44,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body search_application
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-application-put
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-application-put
         #
         def put(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'search_application.put' }

data/lib/elasticsearch/api/actions/search_application/put_behavioral_analytics.rb

@@ -41,7 +41,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-application-put-behavioral-analytics
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-application-put-behavioral-analytics
         #
         def put_behavioral_analytics(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'search_application.put_behavioral_analytics' }

data/lib/elasticsearch/api/actions/search_application/render_query.rb

@@ -46,7 +46,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-application-render-query
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-application-render-query
         #
         def render_query(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'search_application.render_query' }

data/lib/elasticsearch/api/actions/search_application/search.rb

@@ -46,7 +46,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-application-search
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-application-search
         #
         def search(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'search_application.search' }

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

@@ -122,14 +122,6 @@ module Elasticsearch
       #  each feature represents a geotile_grid cell. If 'grid' each feature is a Polygon
       #  of the cells bounding box. If 'point' each feature is a Point that is the centroid
       #  of the cell. Server default: grid.
-      # @option arguments [String] :project_routing Specifies a subset of projects to target for the search using project
-      #  metadata tags in a subset of Lucene query syntax.
-      #  Allowed Lucene queries: the _alias tag and a single value (possibly wildcarded).
-      #  Examples:
-      #   _alias:my-project
-      #   _alias:_origin
-      #   _alias:*pr*
-      #  Supported in serverless only.
       # @option arguments [Integer] :size Maximum number of features to return in the hits layer. Accepts 0-10000.
       #  If 0, results don't include the hits layer. Server default: 10000.
       # @option arguments [Boolean, Integer] :track_total_hits The number of hits matching the query to count accurately.
@@ -157,7 +149,7 @@ module Elasticsearch
       # @option arguments [Hash] :headers Custom HTTP headers
       # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-mvt
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-mvt
       #
       def search_mvt(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'search_mvt' }

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

@@ -30,13 +30,18 @@ module Elasticsearch
       # @option arguments [String, Array] :index A comma-separated list of data streams, indices, and aliases to search.
       #  It supports wildcards (`*`).
       #  To search all data streams and indices, omit this parameter or use `*` or `_all`.
-      # @option arguments [Boolean] :allow_no_indices If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices.
-      #  This behavior applies even if the request targets other open indices.
-      #  For example, a request targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`.
+      # @option arguments [Boolean] :allow_no_indices A setting that does two separate checks on the index expression.
+      #  If `false`, the request returns an error (1) if any wildcard expression
+      #  (including `_all` and `*`) resolves to zero matching indices or (2) if the
+      #  complete set of resolved indices, aliases or data streams is empty after all
+      #  expressions are evaluated. If `true`, index expressions that resolve to no
+      #  indices are allowed and the request returns an empty result.
       # @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, such as `open,hidden`. Server default: open.
-      # @option arguments [Boolean] :ignore_unavailable If `false`, the request returns an error if it targets a missing or closed index.
+      # @option arguments [Boolean] :ignore_unavailable If `false`, the request returns an error if it targets a concrete (non-wildcarded)
+      #  index, alias, or data stream that is missing, closed, or otherwise unavailable.
+      #  If `true`, unavailable concrete targets are silently ignored.
       # @option arguments [Boolean] :local If `true`, the request retrieves information from the local node only.
       # @option arguments [Time] :master_timeout The period to wait for a connection to the master node.
       #  If the master node is not available before the timeout expires, the request fails and returns an error.
@@ -57,7 +62,7 @@ module Elasticsearch
       #  this option for debugging only.
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-shards
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-shards
       #
       def search_shards(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'search_shards' }

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

@@ -25,27 +25,24 @@ module Elasticsearch
       #
       # @option arguments [String, Array] :index A comma-separated list of data streams, indices, and aliases to search.
       #  It supports wildcards (`*`).
-      # @option arguments [Boolean] :allow_no_indices If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices.
-      #  This behavior applies even if the request targets other open indices.
-      #  For example, a request targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`. Server default: true.
+      # @option arguments [Boolean] :allow_no_indices A setting that does two separate checks on the index expression.
+      #  If `false`, the request returns an error (1) if any wildcard expression
+      #  (including `_all` and `*`) resolves to zero matching indices or (2) if the
+      #  complete set of resolved indices, aliases or data streams is empty after all
+      #  expressions are evaluated. If `true`, index expressions that resolve to no
+      #  indices are allowed and the request returns an empty result. Server default: true.
       # @option arguments [Boolean] :ccs_minimize_roundtrips Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution. Server default: true.
       # @option arguments [String, Array<String>] :expand_wildcards The 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, such as `open,hidden`. Server default: open.
       # @option arguments [Boolean] :explain If `true`, the response includes additional details about score computation as part of a hit.
       # @option arguments [Boolean] :ignore_throttled If `true`, specified concrete, expanded, or aliased indices are not included in the response when throttled. Server default: true.
-      # @option arguments [Boolean] :ignore_unavailable If `false`, the request returns an error if it targets a missing or closed index.
+      # @option arguments [Boolean] :ignore_unavailable If `false`, the request returns an error if it targets a concrete (non-wildcarded)
+      #  index, alias, or data stream that is missing, closed, or otherwise unavailable.
+      #  If `true`, unavailable concrete targets are silently ignored.
       # @option arguments [String] :preference The node or shard the operation should be performed on.
       #  It is random by default.
       # @option arguments [Boolean] :profile If `true`, the query execution is profiled.
-      # @option arguments [String] :project_routing Specifies a subset of projects to target for the search using project
-      #  metadata tags in a subset of Lucene query syntax.
-      #  Allowed Lucene queries: the _alias tag and a single value (possibly wildcarded).
-      #  Examples:
-      #   _alias:my-project
-      #   _alias:_origin
-      #   _alias:*pr*
-      #  Supported in serverless only.
       # @option arguments [String, Array<String>] :routing A custom value used to route operations to a specific shard.
       # @option arguments [Time] :scroll Specifies how long a consistent view of the index
       #  should be maintained for scrolled search.
@@ -67,7 +64,7 @@ module Elasticsearch
       # @option arguments [Hash] :headers Custom HTTP headers
       # @option arguments [Hash] :body request body
       #
-      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-search-template
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-search-template
       #
       def search_template(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'search_template' }

data/lib/elasticsearch/api/actions/searchable_snapshots/cache_stats.rb

@@ -42,7 +42,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-searchable-snapshots-cache-stats
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-searchable-snapshots-cache-stats
         #
         def cache_stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'searchable_snapshots.cache_stats' }

data/lib/elasticsearch/api/actions/searchable_snapshots/clear_cache.rb

@@ -31,9 +31,15 @@ module Elasticsearch
         # @option arguments [String, Array] :index A comma-separated list of data streams, indices, and aliases to clear from the cache.
         #  It supports wildcards (`*`).
         # @option arguments [String, Array<String>] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both Server default: open.
-        # @option arguments [Boolean] :allow_no_indices Whether to ignore if a wildcard indices expression resolves into no concrete indices.
-        #  (This includes `_all` string or when no indices have been specified)
-        # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when unavailable (missing or closed)
+        # @option arguments [Boolean] :allow_no_indices A setting that does two separate checks on the index expression.
+        #  If `false`, the request returns an error (1) if any wildcard expression
+        #  (including `_all` and `*`) resolves to zero matching indices or (2) if the
+        #  complete set of resolved indices, aliases or data streams is empty after all
+        #  expressions are evaluated. If `true`, index expressions that resolve to no
+        #  indices are allowed and the request returns an empty result.
+        # @option arguments [Boolean] :ignore_unavailable If `false`, the request returns an error if it targets a concrete (non-wildcarded)
+        #  index, alias, or data stream that is missing, closed, or otherwise unavailable.
+        #  If `true`, unavailable concrete targets are silently ignored.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.
         # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response
@@ -47,7 +53,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-searchable-snapshots-clear-cache
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-searchable-snapshots-clear-cache
         #
         def clear_cache(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'searchable_snapshots.clear_cache' }

data/lib/elasticsearch/api/actions/searchable_snapshots/mount.rb

@@ -33,7 +33,8 @@ module Elasticsearch
         #  If the master node is not available before the timeout expires, the request fails and returns an error.
         #  To indicate that the request should never timeout, set it to `-1`. Server default: 30s.
         # @option arguments [Boolean] :wait_for_completion If true, the request blocks until the operation is complete.
-        # @option arguments [String] :storage The mount option for the searchable snapshot index. Server default: full_copy.
+        # @option arguments [String] :storage The mount option for the searchable snapshot index.
+        #  For further information on mount options, refer to: {https://www.elastic.co/docs/deploy-manage/tools/snapshot-and-restore/searchable-snapshots#searchable-snapshot-mount-storage-options Mount options} Server default: full_copy.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.
         # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response
@@ -48,7 +49,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-searchable-snapshots-mount
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-searchable-snapshots-mount
         #
         def mount(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'searchable_snapshots.mount' }

data/lib/elasticsearch/api/actions/searchable_snapshots/stats.rb

@@ -39,7 +39,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-searchable-snapshots-stats
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-searchable-snapshots-stats
         #
         def stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'searchable_snapshots.stats' }

data/lib/elasticsearch/api/actions/security/clone_api_key.rb

@@ -0,0 +1,73 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# 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 Security
+      module Actions
+        # Clone an API key.
+        # Create a copy of an existing API key with a new ID.
+        # The cloned key inherits the role descriptors of the source key.
+        # This is intended for applications (such as Kibana) that need to
+        # create API keys on behalf of a user using an existing API key credential,
+        # since derived API keys (API keys created by API keys) are not otherwise supported.
+        # This functionality is in technical preview and may be changed or removed in a future
+        # release. Elastic will apply best effort to fix any issues, but features in technical
+        # preview are not subject to the support SLA of official GA features.
+        #
+        # @option arguments [String] :refresh If `true` (the default) then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` then do nothing with refreshes.
+        # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
+        #  when they occur.
+        # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response
+        #  returned by Elasticsearch.
+        # @option arguments [Boolean] :human When set to `true` will return statistics in a format suitable for humans.
+        #  For example `"exists_time": "1h"` for humans and
+        #  `"exists_time_in_millis": 3600000` for computers. When disabled the human
+        #  readable values will be omitted. This makes sense for responses being consumed
+        #  only by machines.
+        # @option arguments [Boolean] :pretty If set to `true` the returned JSON will be "pretty-formatted". Only use
+        #  this option for debugging only.
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body request body
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch#TODO
+        #
+        def clone_api_key(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'security.clone_api_key' }
+
+          raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = arguments.delete(:body)
+
+          method = Elasticsearch::API::HTTP_POST
+          path   = '_security/api_key/clone'
+          params = Utils.process_params(arguments)
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers, request_opts)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/api/actions/simulate/ingest.rb

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

data/lib/elasticsearch/api/actions/snapshot/cleanup_repository.rb

@@ -45,7 +45,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-snapshot-cleanup-repository
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-snapshot-cleanup-repository
         #
         def cleanup_repository(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.cleanup_repository' }

data/lib/elasticsearch/api/actions/snapshot/clone.rb

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

data/lib/elasticsearch/api/actions/snapshot/create.rb

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

data/lib/elasticsearch/api/actions/snapshot/create_repository.rb

@@ -53,7 +53,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body repository
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-snapshot-create-repository
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-snapshot-create-repository
         #
         def create_repository(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.create_repository' }

data/lib/elasticsearch/api/actions/snapshot/delete.rb

@@ -45,7 +45,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-snapshot-delete
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-snapshot-delete
         #
         def delete(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.delete' }

data/lib/elasticsearch/api/actions/snapshot/delete_repository.rb

@@ -47,7 +47,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-snapshot-delete-repository
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-snapshot-delete-repository
         #
         def delete_repository(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.delete_repository' }

data/lib/elasticsearch/api/actions/snapshot/get.rb

@@ -72,7 +72,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-snapshot-get
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-snapshot-get
         #
         def get(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.get' }

data/lib/elasticsearch/api/actions/snapshot/get_repository.rb

@@ -44,7 +44,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-snapshot-get-repository
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-snapshot-get-repository
         #
         def get_repository(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.get_repository' }

data/lib/elasticsearch/api/actions/snapshot/repository_analyze.rb

@@ -45,6 +45,10 @@ module Elasticsearch
         # This allows you to demonstrate to your storage supplier that a repository analysis failure must only be caused by an incompatibility with AWS S3 and cannot be attributed to a problem in Elasticsearch.
         # Please do not report Elasticsearch issues involving third-party storage systems unless you can demonstrate that the same issue exists when analysing a repository that uses the reference implementation of the same storage protocol.
         # You will need to work with the supplier of your storage system to address the incompatibilities that Elasticsearch detects.
+        # The analysis may also report a failure if your repository experienced a service disruption while the analysis was running.
+        # In practice, occasional service disruptions are inevitable, but the analysis cannot itself distinguish such disruptions from incorrect behavior so must report all deviations from the expected behavior as failures.
+        # If you are certain that you can ascribe an analysis failure to such a service disruption, wait for your service provider to resolve the disruption and then re-run the analysis.
+        # Elasticsearch will be unable to create or restore snapshots during repository service disruptions, so you must ensure that these events occur only very rarely.
         # If the analysis is successful, the API returns details of the testing process, optionally including how long each operation took.
         # You can use this information to determine the performance of your storage system.
         # If any operation fails or returns an incorrect result, the API returns an error.
@@ -148,7 +152,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-snapshot-repository-analyze
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-snapshot-repository-analyze
         #
         def repository_analyze(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.repository_analyze' }

data/lib/elasticsearch/api/actions/snapshot/repository_verify_integrity.rb

@@ -79,7 +79,7 @@ module Elasticsearch
         #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-snapshot-repository-verify-integrity
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation-snapshot-repository-verify-integrity
         #
         def repository_verify_integrity(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.repository_verify_integrity' }

data/lib/elasticsearch/api/actions/snapshot/restore.rb

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