elasticsearch-api 9.3.0 → 9.4.0

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

@@ -93,7 +93,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/operation/operation-reindex
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-reindex
       #
       def reindex(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'reindex' }

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
@@ -49,7 +50,7 @@ module Elasticsearch
       #  this option for debugging only.
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-reindex
+      # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-reindex
       #
       def reindex_rethrottle(arguments = {})
         request_opts = { endpoint: arguments[:endpoint] || 'reindex_rethrottle' }

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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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] :ccs_minimize_roundtrips If `true`, network round-trips are minimized for cross-cluster search requests.
+      # @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/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

@@ -29,7 +29,6 @@ module Elasticsearch
         # preview are not subject to the support SLA of official GA features.
         #
         # @option arguments [String, Array] :node_id The names of the nodes in the cluster to target.
-        # @option arguments [Time] :master_timeout [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
@@ -43,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/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/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/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/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/activate_user_profile.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/operation/operation-security-activate-user-profile
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-activate-user-profile
         #
         def activate_user_profile(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.activate_user_profile' }

data/lib/elasticsearch/api/actions/security/authenticate.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/operation/operation-security-authenticate
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-authenticate
         #
         def authenticate(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.authenticate' }

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

@@ -41,7 +41,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/operation/operation-security-bulk-delete-role
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-bulk-delete-role
         #
         def bulk_delete_role(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.bulk_delete_role' }

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

@@ -41,7 +41,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/operation/operation-security-bulk-put-role
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-bulk-put-role
         #
         def bulk_put_role(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.bulk_put_role' }

data/lib/elasticsearch/api/actions/security/bulk_update_api_keys.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/operation/operation-security-bulk-update-api-keys
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-bulk-update-api-keys
         #
         def bulk_update_api_keys(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.bulk_update_api_keys' }

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

@@ -42,7 +42,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/operation/operation-security-change-password
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-change-password
         #
         def change_password(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.change_password' }

data/lib/elasticsearch/api/actions/security/clear_api_key_cache.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/operation/operation-security-clear-api-key-cache
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-clear-api-key-cache
         #
         def clear_api_key_cache(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.clear_api_key_cache' }

data/lib/elasticsearch/api/actions/security/clear_cached_privileges.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/operation/operation-security-clear-cached-privileges
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-clear-cached-privileges
         #
         def clear_cached_privileges(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.clear_cached_privileges' }

data/lib/elasticsearch/api/actions/security/clear_cached_realms.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/operation/operation-security-clear-cached-realms
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-clear-cached-realms
         #
         def clear_cached_realms(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.clear_cached_realms' }

data/lib/elasticsearch/api/actions/security/clear_cached_roles.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/operation/operation-security-clear-cached-roles
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-clear-cached-roles
         #
         def clear_cached_roles(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.clear_cached_roles' }

data/lib/elasticsearch/api/actions/security/clear_cached_service_tokens.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/operation/operation-security-clear-cached-service-tokens
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-clear-cached-service-tokens
         #
         def clear_cached_service_tokens(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.clear_cached_service_tokens' }

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/security/create_api_key.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/operation/operation-security-create-api-key
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-create-api-key
         #
         def create_api_key(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.create_api_key' }

data/lib/elasticsearch/api/actions/security/create_cross_cluster_api_key.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/operation/operation-security-create-cross-cluster-api-key
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-create-cross-cluster-api-key
         #
         def create_cross_cluster_api_key(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.create_cross_cluster_api_key' }

data/lib/elasticsearch/api/actions/security/create_service_token.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/operation/operation-security-create-service-token
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-create-service-token
         #
         def create_service_token(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.create_service_token' }