elasticsearch-api 9.1.3 → 9.2.1

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

@@ -26,8 +26,9 @@ module Elasticsearch
         # Returns search results for an Event Query Language (EQL) query.
         # EQL assumes each document in a data stream or index corresponds to an event.
         #
-        # @option arguments [String, Array] :index The name of the index to scope the operation (*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) Server default: true.
+        # @option arguments [String, Array] :index Comma-separated list of index names to scope the operation (*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) Server default: true.
         # @option arguments [Boolean] :allow_partial_search_results If true, returns partial results if there are shard failures. If false, returns an error with no partial results. Server default: true.
         # @option arguments [Boolean] :allow_partial_sequence_results If true, sequence queries will return partial results in case of shard failures. If false, they will return no results at all.
         #  This flag has effect only if allow_partial_search_results is true.
@@ -36,6 +37,14 @@ module Elasticsearch
         # @option arguments [Boolean] :ignore_unavailable If true, missing or closed indices are not included in the response. Server default: true.
         # @option arguments [Time] :keep_alive Period for which the search and its results are stored on the cluster. Server default: 5d.
         # @option arguments [Boolean] :keep_on_completion If true, the search and its results are stored on the cluster.
+        # @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 [Time] :wait_for_completion_timeout Timeout duration to wait for the request to finish. Defaults to no timeout, meaning the request waits for complete search results.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.

data/lib/elasticsearch/api/actions/esql/get_query.rb

@@ -24,10 +24,9 @@ module Elasticsearch
       module Actions
         # Get a specific running ES|QL query information.
         # Returns an object extended information about a running ES|QL query.
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
+        # 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] :id The query ID (*Required*)
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors

data/lib/elasticsearch/api/actions/esql/list_queries.rb

@@ -24,10 +24,9 @@ module Elasticsearch
       module Actions
         # Get running ES|QL queries information.
         # Returns an object containing IDs and other information about the running ES|QL queries.
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
+        # 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 [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.

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

@@ -32,8 +32,8 @@ module Elasticsearch
       #  This parameter can be used only when the `q` query string parameter is specified.
       # @option arguments [Boolean] :analyze_wildcard If `true`, wildcard and prefix queries are analyzed.
       #  This parameter can be used only when the `q` query string parameter is specified.
-      # @option arguments [String] :default_operator The default operator for query string query: `AND` or `OR`.
-      #  This parameter can be used only when the `q` query string parameter is specified. Server default: OR.
+      # @option arguments [String] :default_operator The default operator for query string query: `and` or `or`.
+      #  This parameter can be used only when the `q` query string parameter is specified. Server default: or.
       # @option arguments [String] :df The field to use as default where no field prefix is given in the query string.
       #  This parameter can be used only when the `q` query string parameter is specified.
       # @option arguments [Boolean] :lenient If `true`, format-based query failures (such as providing text to a numeric field) in the query string will be ignored.

data/lib/elasticsearch/api/actions/features/reset_features.rb

@@ -33,10 +33,9 @@ module Elasticsearch
         # Using this API resets all features, both those that are built-in and implemented as plugins.
         # To list the features that will be affected, use the get features API.
         # IMPORTANT: The features installed on the node you submit this request to are the features that will be reset. Run on the master node if you have any doubts about which plugins are installed on individual nodes.
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
+        # 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 [Time] :master_timeout Period to wait for a connection to the master node. Server default: 30s.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors

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

@@ -40,6 +40,14 @@ module Elasticsearch
       #  Any fields that do not match one of these types will be excluded from the results.
       #  It defaults to empty, meaning that all field types are returned.
       # @option arguments [Boolean] :include_empty_fields If false, empty fields are not included in the response. Server default: true.
+      # @option arguments [String] :project_routing Specifies a subset of projects to target for the field-caps query 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 [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
       #  when they occur.
       # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

data/lib/elasticsearch/api/actions/fleet/msearch.rb

@@ -26,10 +26,9 @@ module Elasticsearch
         # Run several Fleet searches with a single API request.
         # The API follows the same structure as the multi search API.
         # However, similar to the Fleet search API, it supports the `wait_for_checkpoints` parameter.
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
+        # 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] :index A single target to search. If the target is an index alias, it must resolve to a single 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.

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

@@ -25,10 +25,9 @@ module Elasticsearch
         # Run a Fleet search.
         # The purpose of the Fleet search API is to provide an API where the search will be run only
         # after the provided checkpoint has been processed and is visible for searches inside of Elasticsearch.
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
+        # 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] :index A single target to search. If the target is an index alias, it must resolve to a single index. (*Required*)
         # @option arguments [Boolean] :allow_no_indices [TODO]
@@ -102,6 +101,7 @@ module Elasticsearch
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
+          raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
           raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
 
           arguments = arguments.clone
@@ -111,12 +111,7 @@ module Elasticsearch
 
           _index = arguments.delete(:index)
 
-          method = if body
-                     Elasticsearch::API::HTTP_POST
-                   else
-                     Elasticsearch::API::HTTP_GET
-                   end
-
+          method = Elasticsearch::API::HTTP_POST
           path   = "#{Utils.listify(_index)}/_fleet/_fleet_search"
           params = Utils.process_params(arguments)
 

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

@@ -88,6 +88,7 @@ module Elasticsearch
       # @option arguments [String, Array<String>] :_source_excludes A comma-separated list of source fields to exclude from the response.
       #  You can also use this parameter to exclude fields from the subset specified in `_source_includes` query parameter.
       #  If the `_source` parameter is `false`, this parameter is ignored.
+      # @option arguments [Boolean] :_source_exclude_vectors Whether vectors should be excluded from _source
       # @option arguments [String, Array<String>] :_source_includes A comma-separated list of source fields to include in the response.
       #  If this parameter is specified, only these source fields are returned.
       #  You can exclude fields from this subset using the `_source_excludes` query parameter.

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

@@ -58,6 +58,7 @@ module Elasticsearch
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
+          raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
           raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
 
           arguments = arguments.clone
@@ -67,12 +68,7 @@ module Elasticsearch
 
           _index = arguments.delete(:index)
 
-          method = if body
-                     Elasticsearch::API::HTTP_POST
-                   else
-                     Elasticsearch::API::HTTP_GET
-                   end
-
+          method = Elasticsearch::API::HTTP_POST
           path   = "#{Utils.listify(_index)}/_graph/explore"
           params = Utils.process_params(arguments)
 

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

@@ -93,6 +93,7 @@ module Elasticsearch
       # When using the external version type, the system checks to see if the version number passed to the index request is greater than the version of the currently stored document.
       # If true, the document will be indexed and the new version number used.
       # If the value provided is less than or equal to the stored document's version number, a version conflict will occur and the index operation will fail. For example:
+      #
       # ```
       # PUT my-index-000001/_doc/1?version=2&version_type=external
       # {
@@ -100,6 +101,8 @@ module Elasticsearch
       #     "id": "elkbee"
       #   }
       # }
+      # ```
+      #
       # In this example, the operation will succeed since the supplied version of 2 is higher than the current document version of 1.
       # If the document was already updated and its version was set to 2 or higher, the indexing command will fail and result in a conflict (409 HTTP status code).
       # A nice side effect is that there is no need to maintain strict ordering of async indexing operations run as a result of changes to a source database, as long as version numbers from the source database are used.

data/lib/elasticsearch/api/actions/index_lifecycle_management/move_to_step.rb

@@ -59,6 +59,7 @@ module Elasticsearch
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
+          raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
           raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
 
           arguments = arguments.clone

data/lib/elasticsearch/api/actions/index_lifecycle_management/put_lifecycle.rb

@@ -53,6 +53,7 @@ module Elasticsearch
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
+          raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
           raise ArgumentError, "Required argument 'policy' missing" unless arguments[:policy]
 
           arguments = arguments.clone

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

@@ -56,6 +56,8 @@ module Elasticsearch
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
+          raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
+
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
@@ -63,12 +65,7 @@ module Elasticsearch
 
           _index = arguments.delete(:index)
 
-          method = if body
-                     Elasticsearch::API::HTTP_POST
-                   else
-                     Elasticsearch::API::HTTP_GET
-                   end
-
+          method = Elasticsearch::API::HTTP_POST
           path   = if _index
                      "#{Utils.listify(_index)}/_analyze"
                    else

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

@@ -24,10 +24,6 @@ module Elasticsearch
       module Actions
         # Cancel a migration reindex operation.
         # Cancel a migration reindex attempt for a data stream or index.
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
         #
         # @option arguments [String, Array] :index The index or data stream name (*Required*)
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors

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

@@ -24,10 +24,6 @@ module Elasticsearch
       module Actions
         # Create an index from a source index.
         # Copy the mappings and settings from the source index to a destination index while allowing request settings and mappings to override the source values.
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
         #
         # @option arguments [String] :source The source index or data stream name (*Required*)
         # @option arguments [String] :dest The destination index or data stream name (*Required*)

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

@@ -29,7 +29,7 @@ module Elasticsearch
         #  Wildcard expressions (`*`) are supported.
         #  To target all data streams in a cluster, omit this parameter or use `*`.
         # @option arguments [String, Array<String>] :expand_wildcards Type of data stream that wildcard patterns can match.
-        #  Supports comma-separated values, such as `open,hidden`. Server default: open.
+        #  Supports comma-separated values, such as `open,hidden`. Server default: open,closed.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.
         # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

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

@@ -37,7 +37,7 @@ module Elasticsearch
         #  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.
+        #  Supports comma-separated values, such as `open,hidden`. Server default: open,closed.
         # @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 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.

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

@@ -25,10 +25,11 @@ module Elasticsearch
         # Delete data stream lifecycles.
         # Removes the data stream lifecycle from a data stream, rendering it not managed by the data stream lifecycle.
         #
-        # @option arguments [String, Array<String>] :name A comma-separated list of data streams of which the data stream lifecycle will be deleted; use `*` to get all data streams (*Required*)
-        # @option arguments [String, Array<String>] :expand_wildcards Whether wildcard expressions should get expanded to open or closed indices (default: open)
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master Server default: 30s.
-        # @option arguments [Time] :timeout Explicit timestamp for the document
+        # @option arguments [String, Array<String>] :name A comma-separated list of data streams of which the data stream lifecycle will be deleted.
+        #  Use `*` to get all data streams (*Required*)
+        # @option arguments [String, Array<String>] :expand_wildcards Whether wildcard expressions should get expanded to open or closed indices (default: open) Server default: open.
+        # @option arguments [Time] :master_timeout The period to wait for a connection to the master node. Server default: 30s.
+        # @option arguments [Time] :timeout The period to wait for a response. 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

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

@@ -25,10 +25,11 @@ module Elasticsearch
         # Delete data stream options.
         # Removes the data stream options from a data stream.
         #
-        # @option arguments [String, Array<String>] :name A comma-separated list of data streams of which the data stream options will be deleted; use `*` to get all data streams (*Required*)
-        # @option arguments [String, Array<String>] :expand_wildcards Whether wildcard expressions should get expanded to open or closed indices (default: open)
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master Server default: 30s.
-        # @option arguments [Time] :timeout Explicit timestamp for the document
+        # @option arguments [String, Array<String>] :name A comma-separated list of data streams of which the data stream options will be deleted.
+        #  Use `*` to get all data streams (*Required*)
+        # @option arguments [String, Array<String>] :expand_wildcards Whether wildcard expressions should get expanded to open or closed indices Server default: open.
+        # @option arguments [Time] :master_timeout The period to wait for a connection to the master node. Server default: 30s.
+        # @option arguments [Time] :timeout The period to wait for a response. 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

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

@@ -29,10 +29,10 @@ module Elasticsearch
         # NOTE: The total size of fields of the analyzed shards of the index in the response is usually smaller than the index `store_size` value because some small metadata files are ignored and some parts of data files might not be scanned by the API.
         # Since stored fields are stored together in a compressed format, the sizes of stored fields are also estimates and can be inaccurate.
         # The stored size of the `_id` field is likely underestimated while the `_source` field is overestimated.
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
+        # For usage examples see the External documentation or refer to {https://www.elastic.co/docs/reference/elasticsearch/rest-apis/index-disk-usage Analyze the index disk usage example} for an example.
+        # 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, Array] :index Comma-separated list of data streams, indices, and aliases used to limit the request.
         #  It’s recommended to execute this API with a single index (or the latest backing index of a data stream) as the API consumes resources significantly. (*Required*)

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

@@ -29,10 +29,9 @@ module Elasticsearch
         # NOTE: Only indices in a time series data stream are supported.
         # Neither field nor document level security can be defined on the source index.
         # The source index must be read only (`index.blocks.write: true`).
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
+        # 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] :index Name of the time series index to downsample. (*Required*)
         # @option arguments [String] :target_index Name of the index to create. (*Required*)

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

@@ -32,7 +32,7 @@ module Elasticsearch
         #  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.
+        #  Supports comma-separated values, such as `open,hidden`. Server default: all.
         # @option arguments [Boolean] :ignore_unavailable If `false`, requests that include a missing data stream or index in the target indices or data streams return an error.
         # @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.

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

@@ -25,9 +25,9 @@ module Elasticsearch
         # Get the status for a data stream lifecycle.
         # Get information about an index or data stream's current data stream lifecycle status, such as time since index creation, time since rollover, the lifecycle configuration managing the index, or any errors encountered during lifecycle execution.
         #
-        # @option arguments [String, Array] :index The name of the index to explain (*Required*)
-        # @option arguments [Boolean] :include_defaults indicates if the API should return the default values the system uses for the index's lifecycle
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master Server default: 30s.
+        # @option arguments [String, Array] :index Comma-separated list of index names to explain (*Required*)
+        # @option arguments [Boolean] :include_defaults Indicates if the API should return the default values the system uses for the index's lifecycle
+        # @option arguments [Time] :master_timeout The period to wait for a connection to the master node. Server default: 30s.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.
         # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

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

@@ -28,10 +28,9 @@ module Elasticsearch
         # A shard-level search request that accesses a given field, even if multiple times during that request, is counted as a single use.
         # The response body reports the per-shard usage count of the data structures that back the fields in the index.
         # A given request will increment each count by a maximum value of 1, even if the request accesses the same field multiple times.
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
+        # 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, Array] :index Comma-separated list or wildcard expression of index names used to limit the request. (*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.
@@ -39,7 +38,7 @@ module Elasticsearch
         #  For example, a request targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`.
         # @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`.
+        #  Supports comma-separated values, such as `open,hidden`. Server default: open.
         # @option arguments [Boolean] :ignore_unavailable If `true`, missing or closed indices are not included in the response.
         # @option arguments [String, Array<String>] :fields Comma-separated list or wildcard expressions of fields to include in the statistics.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors

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

@@ -64,13 +64,14 @@ module Elasticsearch
         # ```
         #
         # @option arguments [String, Array] :index A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices
-        # @option arguments [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] :flush Specify whether the index should be flushed after performing the operation (default: true)
+        # @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. Server default: open.
+        # @option arguments [Boolean] :flush Specify whether the index should be flushed after performing the operation Server default: true.
         # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when unavailable (missing or closed)
         # @option arguments [Integer] :max_num_segments The number of segments the index should be merged into (default: dynamic)
         # @option arguments [Boolean] :only_expunge_deletes Specify whether the operation should only expunge deleted documents
-        # @option arguments [Boolean] :wait_for_completion Should the request wait until the force merge is completed. Server default: true.
+        # @option arguments [Boolean] :wait_for_completion Should the request wait until the force merge is completed 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

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

@@ -35,7 +35,7 @@ module Elasticsearch
         #  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.
+        #  Supports comma-separated values, such as `open,hidden`. Server default: all.
         # @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 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.

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

@@ -0,0 +1,75 @@
+# 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
+        # Get data stream mappings.
+        # Get mapping information for one or more data streams.
+        #
+        # @option arguments [String, Array] :name A comma-separated list of data streams or data stream patterns. Supports wildcards (`*`). (*Required*)
+        # @option arguments [Time] :master_timeout The 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] :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-get-data-stream-mappings
+        #
+        def get_data_stream_mappings(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.get_data_stream_mappings' }
+
+          defined_params = [:name].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 'name' missing" unless arguments[:name]
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = nil
+
+          _name = arguments.delete(:name)
+
+          method = Elasticsearch::API::HTTP_GET
+          path   = "_data_stream/#{Utils.listify(_name)}/_mappings"
+          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/get_index_template.rb

@@ -25,7 +25,7 @@ module Elasticsearch
         # Get index templates.
         # Get information about one or more index templates.
         #
-        # @option arguments [String] :name Comma-separated list of index template names used to limit the request. Wildcard (*) expressions are supported.
+        # @option arguments [String] :name Name of index template to retrieve. Wildcard (*) expressions are supported.
         # @option arguments [Boolean] :local If true, the request retrieves information from the local node only. Defaults to false, which means information is retrieved from the master node.
         # @option arguments [Boolean] :flat_settings If true, returns settings in flat format.
         # @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.

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

@@ -24,10 +24,6 @@ module Elasticsearch
       module Actions
         # Get the migration reindexing status.
         # Get the status of a migration reindex attempt for a data stream or index.
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
         #
         # @option arguments [String, Array] :index The index or data stream name. (*Required*)
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors

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

@@ -26,10 +26,6 @@ module Elasticsearch
         # Reindex all legacy backing indices for a data stream.
         # This operation occurs in a persistent task.
         # The persistent task ID is returned immediately and the reindexing work is completed in that task.
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
         #
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.

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

@@ -49,7 +49,7 @@ module Elasticsearch
         #  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.
+        #  Supports comma-separated values, such as `open,hidden`. Server default: closed.
         # @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 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.

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

@@ -32,7 +32,7 @@ module Elasticsearch
         # If this is missing, the data stream will not be able to roll over until a matching index template is created.
         # This will affect the lifecycle management of the data stream and interfere with the data stream size and retention.
         #
-        # @option arguments [String] :name The name of the data stream (*Required*)
+        # @option arguments [String] :name The name of the data stream to promote (*Required*)
         # @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] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.

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

@@ -59,6 +59,7 @@ module Elasticsearch
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
+          raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
           raise ArgumentError, "Required argument 'name' missing" unless arguments[:name]
 
           arguments = arguments.clone