elasticsearch-api 9.0.3 → 9.1.0

data/lib/elasticsearch/api/actions/indices/put_template.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Indices
       module Actions
-        # Create or update an index template.
+        # Create or update a legacy index template.
         # Index templates define settings, mappings, and aliases that can be applied automatically to new indices.
         # Elasticsearch applies templates to new indices based on an index pattern that matches the index name.
         # IMPORTANT: This documentation is about legacy index templates, which are deprecated and will be replaced by the composable templates introduced in Elasticsearch 7.8.
@@ -31,7 +31,7 @@ module Elasticsearch
         # Index templates are only applied during index creation.
         # Changes to index templates do not affect existing indices.
         # Settings and mappings specified in create index API requests override any settings or mappings specified in an index template.
-        # You can use C-style +/* *\/+ block comments in index templates.
+        # You can use C-style `/* *\/` block comments in index templates.
         # You can include comments anywhere in the request body, except before the opening curly bracket.
         # **Indices matching multiple templates**
         # Multiple index templates can potentially match an index, in this case, both the settings and mappings are merged into the final configuration of the index.
@@ -46,10 +46,21 @@ module Elasticsearch
         #  matches multiple templates.Templates with lower 'order' values are merged first. Templates with higher
         #  'order' values are merged later, overriding templates with lower values.
         # @option arguments [String] :cause User defined reason for creating/updating the index template
+        # @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/v9/operation/operation-indices-put-template
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-template
         #
         def put_template(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.put_template' }

data/lib/elasticsearch/api/actions/indices/recovery.rb

@@ -41,13 +41,30 @@ module Elasticsearch
         # This means that if a shard copy completes a recovery and then Elasticsearch relocates it onto a different node then the information about the original recovery will not be shown in the recovery API.
         #
         # @option arguments [String, Array] :index Comma-separated list of data streams, indices, and aliases used to limit the request.
-        #  Supports wildcards (+*+).
-        #  To target all data streams and indices, omit this parameter or use +*+ or +_all+.
-        # @option arguments [Boolean] :active_only If +true+, the response only includes ongoing shard recoveries.
-        # @option arguments [Boolean] :detailed If +true+, the response includes detailed information about shard recoveries.
+        #  Supports wildcards (`*`).
+        #  To target all data streams and indices, omit this parameter or use `*` or `_all`.
+        # @option arguments [Boolean] :active_only If `true`, the response only includes ongoing shard recoveries.
+        # @option arguments [Boolean] :detailed If `true`, the response includes detailed information about shard recoveries.
+        # @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. Server default: true.
+        # @option arguments [String, Array<String>] :expand_wildcards Type of index that wildcard patterns can match.
+        #  If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.
+        #  Supports comma-separated values, 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] :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
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-recovery
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-recovery
         #
         def recovery(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.recovery' }

data/lib/elasticsearch/api/actions/indices/refresh.rb

@@ -26,26 +26,36 @@ module Elasticsearch
         # A refresh makes recent operations performed on one or more indices available for search.
         # For data streams, the API runs the refresh operation on the stream’s backing indices.
         # By default, Elasticsearch periodically refreshes indices every second, but only on indices that have received one search request or more in the last 30 seconds.
-        # You can change this default interval with the +index.refresh_interval+ setting.
+        # You can change this default interval with the `index.refresh_interval` setting.
         # Refresh requests are synchronous and do not return a response until the refresh operation completes.
         # Refreshes are resource-intensive.
         # To ensure good cluster performance, it's recommended to wait for Elasticsearch's periodic refresh rather than performing an explicit refresh when possible.
-        # If your application workflow indexes documents and then runs a search to retrieve the indexed document, it's recommended to use the index API's +refresh=wait_for+ query parameter option.
+        # If your application workflow indexes documents and then runs a search to retrieve the indexed document, it's recommended to use the index API's `refresh=wait_for` query parameter option.
         # This option ensures the indexing operation waits for a periodic refresh before running the search.
         #
         # @option arguments [String, Array] :index Comma-separated list of data streams, indices, and aliases used to limit the request.
-        #  Supports wildcards (+*+).
-        #  To target 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.
+        #  Supports wildcards (`*`).
+        #  To target 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. Server default: true.
         # @option arguments [String, Array<String>] :expand_wildcards Type of index that wildcard patterns can match.
         #  If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.
-        #  Supports comma-separated values, such as +open,hidden+.
-        #  Valid values are: +all+, +open+, +closed+, +hidden+, +none+. Server default: open.
-        # @option arguments [Boolean] :ignore_unavailable If +false+, the request returns an error if it targets a missing or closed index.
+        #  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] :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
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-refresh
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-refresh
         #
         def refresh(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.refresh' }

data/lib/elasticsearch/api/actions/indices/reload_search_analyzers.rb

@@ -26,8 +26,8 @@ module Elasticsearch
         # Reload an index's search analyzers and their resources.
         # For data streams, the API reloads search analyzers and resources for the stream's backing indices.
         # IMPORTANT: After reloading the search analyzers you should clear the request cache to make sure it doesn't contain responses derived from the previous versions of the analyzer.
-        # You can use the reload search analyzers API to pick up changes to synonym files used in the +synonym_graph+ or +synonym+ token filter of a search analyzer.
-        # To be eligible, the token filter must have an +updateable+ flag of +true+ and only be used in search analyzers.
+        # You can use the reload search analyzers API to pick up changes to synonym files used in the `synonym_graph` or `synonym` token filter of a search analyzer.
+        # To be eligible, the token filter must have an `updateable` flag of `true` and only be used in search analyzers.
         # NOTE: This API does not perform a reload for each shard of an index.
         # Instead, it performs a reload for each node containing index shards.
         # As a result, the total shard count returned by the API can differ from the number of index shards.
@@ -35,13 +35,24 @@ module Elasticsearch
         # This ensures the synonym file is updated everywhere in the cluster in case shards are relocated in the future.
         #
         # @option arguments [String, Array] :index A comma-separated list of index names to reload analyzers for (*Required*)
-        # @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] :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 [String, Array<String>] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both.
         # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when unavailable (missing or closed)
         # @option arguments [String] :resource Changed resource to reload analyzers from if applicable
+        # @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
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-reload-search-analyzers
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-reload-search-analyzers
         #
         def reload_search_analyzers(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.reload_search_analyzers' }

data/lib/elasticsearch/api/actions/indices/remove_block.rb

@@ -0,0 +1,93 @@
+# 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 Indices
+      module Actions
+        # Remove an index block.
+        # Remove an index block from an index.
+        # Index blocks limit the operations allowed on an index by blocking specific operation types.
+        #
+        # @option arguments [String] :index A comma-separated list or wildcard expression of index names used to limit the request.
+        #  By default, you must explicitly name the indices you are removing blocks from.
+        #  To allow the removal of blocks from indices with `_all`, `*`, or other wildcard expressions, change the `action.destructive_requires_name` setting to `false`.
+        #  You can update this setting in the `elasticsearch.yml` file or by using the cluster update settings API. (*Required*)
+        # @option arguments [String] :block The block type to remove from the index. (*Required*)
+        # @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 [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.
+        #  It 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 [Time] :master_timeout The period to wait for the master node.
+        #  If the master node is not available before the timeout expires, the request fails and returns an error.
+        #  It can also be set to `-1` to indicate that the request should never timeout. Server default: 30s.
+        # @option arguments [Time] :timeout The period to wait for a response from all relevant nodes in the cluster after updating the cluster metadata.
+        #  If no response is received before the timeout expires, the cluster metadata update still applies but the response will indicate that it was not completely acknowledged.
+        #  It can also be set to `-1` to indicate that the request should never timeout. Server default: 30s.
+        # @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
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-remove-block
+        #
+        def remove_block(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.remove_block' }
+
+          defined_params = [:index, :block].each_with_object({}) do |variable, set_variables|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
+          raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
+          raise ArgumentError, "Required argument 'block' missing" unless arguments[:block]
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = nil
+
+          _index = arguments.delete(:index)
+
+          _block = arguments.delete(:block)
+
+          method = Elasticsearch::API::HTTP_DELETE
+          path   = "#{Utils.listify(_index)}/_block/#{Utils.listify(_block)}"
+          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/indices/resolve_cluster.rb

@@ -29,58 +29,68 @@ module Elasticsearch
         # You use the same index expression with this endpoint as you would for cross-cluster search.
         # Index and cluster exclusions are also supported with this endpoint.
         # For each cluster in the index expression, information is returned about:
-        # * Whether the querying ("local") cluster is currently connected to each remote cluster specified in the index expression. Note that this endpoint actively attempts to contact the remote clusters, unlike the +remote/info+ endpoint.
-        # * Whether each remote cluster is configured with +skip_unavailable+ as +true+ or +false+.
+        # * Whether the querying ("local") cluster is currently connected to each remote cluster specified in the index expression. Note that this endpoint actively attempts to contact the remote clusters, unlike the `remote/info` endpoint.
+        # * Whether each remote cluster is configured with `skip_unavailable` as `true` or `false`.
         # * Whether there are any indices, aliases, or data streams on that cluster that match the index expression.
         # * Whether the search is likely to have errors returned when you do the cross-cluster search (including any authorization errors if you do not have permission to query the index).
         # * Cluster version information, including the Elasticsearch server version.
-        # For example, +GET /_resolve/cluster/my-index-*,cluster*:my-index-*+ returns information about the local cluster and all remotely configured clusters that start with the alias +cluster*+.
-        # Each cluster returns information about whether it has any indices, aliases or data streams that match +my-index-*+.The ability to query without an index expression was added in version 8.18, so when
+        # For example, `GET /_resolve/cluster/my-index-*,cluster*:my-index-*` returns information about the local cluster and all remotely configured clusters that start with the alias `cluster*`.
+        # Each cluster returns information about whether it has any indices, aliases or data streams that match `my-index-*`.The ability to query without an index expression was added in version 8.18, so when
         # querying remote clusters older than that, the local cluster will send the index
-        # expression +dummy*+ to those remote clusters. Thus, if an errors occur, you may see a reference
+        # expression `dummy*` to those remote clusters. Thus, if an errors occur, you may see a reference
         # to that index expression even though you didn't request it. If it causes a problem, you can
-        # instead include an index expression like +*:*+ to bypass the issue.You may want to exclude a cluster or index from a search when:
-        # * A remote cluster is not currently connected and is configured with +skip_unavailable=false+. Running a cross-cluster search under those conditions will cause the entire search to fail.
-        # * A cluster has no matching indices, aliases or data streams for the index expression (or your user does not have permissions to search them). For example, suppose your index expression is +logs*,remote1:logs*+ and the remote1 cluster has no indices, aliases or data streams that match +logs*+. In that case, that cluster will return no results from that cluster if you include it in a cross-cluster search.
-        # * The index expression (combined with any query parameters you specify) will likely cause an exception to be thrown when you do the search. In these cases, the "error" field in the +_resolve/cluster+ response will be present. (This is also where security/permission errors will be shown.)
-        # * A remote cluster is an older version that does not support the feature you want to use in your search.The +remote/info+ endpoint is commonly used to test whether the "local" cluster (the cluster being queried) is connected to its remote clusters, but it does not necessarily reflect whether the remote cluster is available or not.
+        # instead include an index expression like `*:*` to bypass the issue.You may want to exclude a cluster or index from a search when:
+        # * A remote cluster is not currently connected and is configured with `skip_unavailable=false`. Running a cross-cluster search under those conditions will cause the entire search to fail.
+        # * A cluster has no matching indices, aliases or data streams for the index expression (or your user does not have permissions to search them). For example, suppose your index expression is `logs*,remote1:logs*` and the remote1 cluster has no indices, aliases or data streams that match `logs*`. In that case, that cluster will return no results from that cluster if you include it in a cross-cluster search.
+        # * The index expression (combined with any query parameters you specify) will likely cause an exception to be thrown when you do the search. In these cases, the "error" field in the `_resolve/cluster` response will be present. (This is also where security/permission errors will be shown.)
+        # * A remote cluster is an older version that does not support the feature you want to use in your search.The `remote/info` endpoint is commonly used to test whether the "local" cluster (the cluster being queried) is connected to its remote clusters, but it does not necessarily reflect whether the remote cluster is available or not.
         # The remote cluster may be available, while the local cluster is not currently connected to it.
-        # You can use the +_resolve/cluster+ API to attempt to reconnect to remote clusters.
-        # For example with +GET _resolve/cluster+ or +GET _resolve/cluster/*:*+.
-        # The +connected+ field in the response will indicate whether it was successful.
-        # If a connection was (re-)established, this will also cause the +remote/info+ endpoint to now indicate a connected status.
+        # You can use the `_resolve/cluster` API to attempt to reconnect to remote clusters.
+        # For example with `GET _resolve/cluster` or `GET _resolve/cluster/*:*`.
+        # The `connected` field in the response will indicate whether it was successful.
+        # If a connection was (re-)established, this will also cause the `remote/info` endpoint to now indicate a connected status.
         #
         # @option arguments [String, Array<String>] :name A comma-separated list of names or index patterns for the indices, aliases, and data streams to resolve.
-        #  Resources on remote clusters can be specified using the +<cluster>+:+<name>+ syntax.
-        #  Index and cluster exclusions (e.g., +-cluster1:*+) are also supported.
+        #  Resources on remote clusters can be specified using the `<cluster>`:`<name>` syntax.
+        #  Index and cluster exclusions (e.g., `-cluster1:*`) are also supported.
         #  If no index expression is specified, information about all remote clusters configured on the local cluster
         #  is returned without doing any index matching
-        # @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
+        # @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+.
+        #  targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`.
         #  NOTE: This option is only supported when specifying an index expression. You will get an error if you specify index
-        #  options to the +_resolve/cluster+ API endpoint that takes no index expression. Server default: true.
+        #  options to the `_resolve/cluster` API endpoint that takes no index expression. Server default: true.
         # @option arguments [String, Array<String>] :expand_wildcards Type of index that wildcard patterns can match.
         #  If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.
-        #  Supports comma-separated values, such as +open,hidden+.
-        #  Valid values are: +all+, +open+, +closed+, +hidden+, +none+.
+        #  Supports comma-separated values, such as `open,hidden`.
         #  NOTE: This option is only supported when specifying an index expression. You will get an error if you specify index
-        #  options to the +_resolve/cluster+ API endpoint that takes no index expression. Server default: open.
+        #  options to the `_resolve/cluster` API endpoint that takes no index expression. Server default: open.
         # @option arguments [Boolean] :ignore_throttled If true, concrete, expanded, or aliased indices are ignored when frozen.
         #  NOTE: This option is only supported when specifying an index expression. You will get an error if you specify index
-        #  options to the +_resolve/cluster+ API endpoint that takes no index expression.
+        #  options to the `_resolve/cluster` API endpoint that takes no index expression.
         # @option arguments [Boolean] :ignore_unavailable If false, the request returns an error if it targets a missing or closed index.
         #  NOTE: This option is only supported when specifying an index expression. You will get an error if you specify index
-        #  options to the +_resolve/cluster+ API endpoint that takes no index expression.
+        #  options to the `_resolve/cluster` API endpoint that takes no index expression.
         # @option arguments [Time] :timeout The maximum time to wait for remote clusters to respond.
         #  If a remote cluster does not respond within this timeout period, the API response
         #  will show the cluster as not connected and include an error message that the
         #  request timed out.The default timeout is unset and the query can take
         #  as long as the networking layer is configured to wait for remote clusters that are
         #  not responding (typically 30 seconds).
+        # @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
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-resolve-cluster
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-cluster
         #
         def resolve_cluster(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.resolve_cluster' }

data/lib/elasticsearch/api/actions/indices/resolve_index.rb

@@ -27,18 +27,28 @@ module Elasticsearch
         # Multiple patterns and remote clusters are supported.
         #
         # @option arguments [String, Array<String>] :name Comma-separated name(s) or index pattern(s) of the indices, aliases, and data streams to resolve.
-        #  Resources on remote clusters can be specified using the +<cluster>+:+<name>+ syntax. (*Required*)
+        #  Resources on remote clusters can be specified using the `<cluster>`:`<name>` syntax. (*Required*)
         # @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+.
-        #  Valid values are: +all+, +open+, +closed+, +hidden+, +none+. 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] :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.
+        #  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] :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.
+        #  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] :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
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-resolve-index
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-index
         #
         def resolve_index(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.resolve_index' }

data/lib/elasticsearch/api/actions/indices/rollover.rb

@@ -34,38 +34,49 @@ module Elasticsearch
         # TIP: Prior to Elasticsearch 7.9, you'd typically use an index alias with a write index to manage time series data.
         # Data streams replace this functionality, require less maintenance, and automatically integrate with data tiers.
         # If an index alias points to multiple indices, one of the indices must be a write index.
-        # The rollover API creates a new write index for the alias with +is_write_index+ set to +true+.
-        # The API also +sets is_write_index+ to +false+ for the previous write index.
+        # The rollover API creates a new write index for the alias with `is_write_index` set to `true`.
+        # The API also `sets is_write_index` to `false` for the previous write index.
         # **Roll over an index alias with one index**
         # If you roll over an index alias that points to only one index, the API creates a new index for the alias and removes the original index from the alias.
-        # NOTE: A rollover creates a new index and is subject to the +wait_for_active_shards+ setting.
+        # NOTE: A rollover creates a new index and is subject to the `wait_for_active_shards` setting.
         # **Increment index names for an alias**
         # When you roll over an index alias, you can specify a name for the new index.
-        # If you don't specify a name and the current index ends with +-+ and a number, such as +my-index-000001+ or +my-index-3+, the new index name increments that number.
-        # For example, if you roll over an alias with a current index of +my-index-000001+, the rollover creates a new index named +my-index-000002+.
+        # If you don't specify a name and the current index ends with `-` and a number, such as `my-index-000001` or `my-index-3`, the new index name increments that number.
+        # For example, if you roll over an alias with a current index of `my-index-000001`, the rollover creates a new index named `my-index-000002`.
         # This number is always six characters and zero-padded, regardless of the previous index's name.
         # If you use an index alias for time series data, you can use date math in the index name to track the rollover date.
-        # For example, you can create an alias that points to an index named +<my-index-{now/d}-000001>+.
-        # If you create the index on May 6, 2099, the index's name is +my-index-2099.05.06-000001+.
-        # If you roll over the alias on May 7, 2099, the new index's name is +my-index-2099.05.07-000002+.
+        # For example, you can create an alias that points to an index named `<my-index-{now/d}-000001>`.
+        # If you create the index on May 6, 2099, the index's name is `my-index-2099.05.06-000001`.
+        # If you roll over the alias on May 7, 2099, the new index's name is `my-index-2099.05.07-000002`.
         #
         # @option arguments [String] :alias Name of the data stream or index alias to roll over. (*Required*)
         # @option arguments [String] :new_index Name of the index to create.
         #  Supports date math.
         #  Data streams do not support this parameter.
-        # @option arguments [Boolean] :dry_run If +true+, checks whether the current index satisfies the specified conditions but does not perform a rollover.
+        # @option arguments [Boolean] :dry_run If `true`, checks whether the current index satisfies the specified conditions but does not perform a rollover.
         # @option arguments [Time] :master_timeout Period to wait for a connection to the master node.
         #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
         # @option arguments [Time] :timeout Period to wait for a response.
         #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
         # @option arguments [Integer, String] :wait_for_active_shards The number of shard copies that must be active before proceeding with the operation.
-        #  Set to all or any positive integer up to the total number of shards in the index (+number_of_replicas+1+). Server default: 1.
+        #  Set to all or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). Server default: 1.
         # @option arguments [Boolean] :lazy If set to true, the rollover action will only mark a data stream to signal that it needs to be rolled over at the next write.
         #  Only allowed on data streams.
+        # @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/v9/operation/operation-indices-rollover
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-rollover
         #
         def rollover(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.rollover' }

data/lib/elasticsearch/api/actions/indices/segments.rb

@@ -27,18 +27,28 @@ module Elasticsearch
         # For data streams, the API returns information about the stream's backing indices.
         #
         # @option arguments [String, Array] :index Comma-separated list of data streams, indices, and aliases used to limit the request.
-        #  Supports wildcards (+*+).
-        #  To target 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.
+        #  Supports wildcards (`*`).
+        #  To target 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. Server default: true.
         # @option arguments [String, Array<String>] :expand_wildcards Type of index that wildcard patterns can match.
         #  If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.
-        #  Supports comma-separated values, such as +open,hidden+.
-        #  Valid values are: +all+, +open+, +closed+, +hidden+, +none+. Server default: open.
-        # @option arguments [Boolean] :ignore_unavailable If +false+, the request returns an error if it targets a missing or closed index.
+        #  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] :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
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-segments
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-segments
         #
         def segments(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.segments' }

data/lib/elasticsearch/api/actions/indices/shard_stores.rb

@@ -39,10 +39,21 @@ module Elasticsearch
         # @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. Server default: open.
         # @option arguments [Boolean] :ignore_unavailable If true, missing or closed indices are not included in the response.
-        # @option arguments [Shardstorestatus] :status List of shard health statuses used to limit the request.
+        # @option arguments [String, Array<String>] :status List of shard health statuses used to limit the request.
+        # @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
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-shard-stores
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-shard-stores
         #
         def shard_stores(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.shard_stores' }

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

@@ -38,7 +38,7 @@ module Elasticsearch
         # A shrink operation:
         # * Creates a new target index with the same definition as the source index, but with a smaller number of primary shards.
         # * Hard-links segments from the source index into the target index. If the file system does not support hard-linking, then all segments are copied into the new index, which is a much more time consuming process. Also if using multiple data paths, shards on different data paths require a full copy of segment files if they are not on the same disk since hardlinks do not work across disks.
-        # * Recovers the target index as though it were a closed index which had just been re-opened. Recovers shards to the +.routing.allocation.initial_recovery._id+ index setting.
+        # * Recovers the target index as though it were a closed index which had just been re-opened. Recovers shards to the `.routing.allocation.initial_recovery._id` index setting.
         # IMPORTANT: Indices can only be shrunk if they satisfy the following requirements:
         # * The target index must not exist.
         # * The source index must have more primary shards than the target index.
@@ -53,11 +53,22 @@ module Elasticsearch
         # @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 [Integer, String] :wait_for_active_shards The number of shard copies that must be active before proceeding with the operation.
-        #  Set to +all+ or any positive integer up to the total number of shards in the index (+number_of_replicas+1+). Server default: 1.
+        #  Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). Server default: 1.
+        # @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/v9/operation/operation-indices-shrink
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-shrink
         #
         def shrink(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.shrink' }

data/lib/elasticsearch/api/actions/indices/simulate_index_template.rb

@@ -30,9 +30,20 @@ module Elasticsearch
         # @option arguments [String] :cause User defined reason for dry-run creating the new template for simulation purposes Server default: false.
         # @option arguments [Time] :master_timeout Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
         # @option arguments [Boolean] :include_defaults If true, returns all relevant default configurations for the index template.
+        # @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
         #
-        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-simulate-index-template
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-simulate-index-template
         #
         def simulate_index_template(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.simulate_index_template' }