elasticsearch-serverless 0.5.0 → 0.7.0

data/lib/elasticsearch-serverless/api/indices/get.rb

@@ -23,7 +23,7 @@ module ElasticsearchServerless
     module Indices
       module Actions
         # Get index information.
-        # Returns information about one or more indices. For data streams, the API returns information about the
+        # Get information about one or more indices. 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 index aliases used to limit the request.
@@ -42,14 +42,13 @@ module ElasticsearchServerless
         # @option arguments [String, Array<String>] :features Return only information on specified index features Server default: ['aliases', 'mappings', 'settings'].
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-index.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get
         #
         def get(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.get" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.get' }
 
-          defined_params = [:index].inject({}) do |set_variables, variable|
+          defined_params = [:index].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
@@ -63,7 +62,7 @@ module ElasticsearchServerless
           _index = arguments.delete(:index)
 
           method = ElasticsearchServerless::API::HTTP_GET
-          path   = "#{Utils.listify(_index)}"
+          path   = Utils.listify(_index).to_s
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(

data/lib/elasticsearch-serverless/api/indices/get_alias.rb

@@ -38,17 +38,17 @@ module ElasticsearchServerless
         #  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] :local If +true+, the request retrieves information from the local node only.
+        # @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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-aliases.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-alias
         #
         def get_alias(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.get_alias" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.get_alias' }
 
-          defined_params = [:name, :index].inject({}) do |set_variables, variable|
+          defined_params = [:name, :index].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
@@ -69,7 +69,7 @@ module ElasticsearchServerless
                    elsif _name
                      "_alias/#{Utils.listify(_name)}"
                    else
-                     "_alias"
+                     '_alias'
                    end
           params = Utils.process_params(arguments)
 

data/lib/elasticsearch-serverless/api/indices/get_data_lifecycle.rb

@@ -23,7 +23,7 @@ module ElasticsearchServerless
     module Indices
       module Actions
         # Get data stream lifecycles.
-        # Retrieves the data stream lifecycle configuration of one or more data streams.
+        # Get the data stream lifecycle configuration of one or more data streams.
         #
         # @option arguments [String, Array<String>] :name Comma-separated list of data streams to limit the request.
         #  Supports wildcards (+*+).
@@ -35,14 +35,13 @@ module ElasticsearchServerless
         # @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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/data-streams-get-lifecycle.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-data-lifecycle
         #
         def get_data_lifecycle(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.get_data_lifecycle" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.get_data_lifecycle' }
 
-          defined_params = [:name].inject({}) do |set_variables, variable|
+          defined_params = [:name].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/indices/get_data_stream.rb

@@ -23,7 +23,7 @@ module ElasticsearchServerless
     module Indices
       module Actions
         # Get data streams.
-        # Retrieves information about one or more data streams.
+        # Get information about one or more data streams.
         #
         # @option arguments [String, Array<String>] :name Comma-separated list of data stream names used to limit the request.
         #  Wildcard (+*+) expressions are supported. If omitted, all data streams are returned.
@@ -34,14 +34,13 @@ module ElasticsearchServerless
         # @option arguments [Boolean] :verbose Whether the maximum timestamp for each data stream should be calculated and returned.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/data-streams.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-data-stream
         #
         def get_data_stream(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.get_data_stream" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.get_data_stream' }
 
-          defined_params = [:name].inject({}) do |set_variables, variable|
+          defined_params = [:name].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
@@ -56,7 +55,7 @@ module ElasticsearchServerless
           path   = if _name
                      "_data_stream/#{Utils.listify(_name)}"
                    else
-                     "_data_stream"
+                     '_data_stream'
                    end
           params = Utils.process_params(arguments)
 

data/lib/elasticsearch-serverless/api/indices/get_index_template.rb

@@ -23,7 +23,7 @@ module ElasticsearchServerless
     module Indices
       module Actions
         # Get index templates.
-        # Returns information about one or more 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 [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.
@@ -32,14 +32,13 @@ module ElasticsearchServerless
         # @option arguments [Boolean] :include_defaults If true, returns all relevant default configurations for the index template.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-template.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-index-template
         #
         def get_index_template(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.get_index_template" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.get_index_template' }
 
-          defined_params = [:name].inject({}) do |set_variables, variable|
+          defined_params = [:name].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
@@ -54,7 +53,7 @@ module ElasticsearchServerless
           path   = if _name
                      "_index_template/#{Utils.listify(_name)}"
                    else
-                     "_index_template"
+                     '_index_template'
                    end
           params = Utils.process_params(arguments)
 

data/lib/elasticsearch-serverless/api/indices/get_mapping.rb

@@ -23,7 +23,6 @@ module ElasticsearchServerless
     module Indices
       module Actions
         # Get mapping definitions.
-        # Retrieves mapping definitions for one or more indices.
         # For data streams, the API retrieves mappings for the stream’s backing indices.
         #
         # @option arguments [String, Array] :index Comma-separated list of data streams, indices, and aliases used to limit the request.
@@ -41,14 +40,13 @@ module ElasticsearchServerless
         #  If no response is received before the timeout expires, the request fails and returns an error. Server default: 30s.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-mapping.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-mapping
         #
         def get_mapping(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.get_mapping" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.get_mapping' }
 
-          defined_params = [:index].inject({}) do |set_variables, variable|
+          defined_params = [:index].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
@@ -63,7 +61,7 @@ module ElasticsearchServerless
           path   = if _index
                      "#{Utils.listify(_index)}/_mapping"
                    else
-                     "_mapping"
+                     '_mapping'
                    end
           params = Utils.process_params(arguments)
 

data/lib/elasticsearch-serverless/api/indices/get_settings.rb

@@ -23,8 +23,8 @@ module ElasticsearchServerless
     module Indices
       module Actions
         # Get index settings.
-        # Returns setting information for one or more indices. For data streams,
-        # returns setting information for the stream’s backing indices.
+        # Get setting information for one or more indices.
+        # For data streams, it returns setting information for 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
@@ -48,14 +48,13 @@ module ElasticsearchServerless
         #  error. Server default: 30s.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-settings.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-settings
         #
         def get_settings(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.get_settings" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.get_settings' }
 
-          defined_params = [:index, :name].inject({}) do |set_variables, variable|
+          defined_params = [:index, :name].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
@@ -76,7 +75,7 @@ module ElasticsearchServerless
                    elsif _name
                      "_settings/#{Utils.listify(_name)}"
                    else
-                     "_settings"
+                     '_settings'
                    end
           params = Utils.process_params(arguments)
 

data/lib/elasticsearch-serverless/api/indices/migrate_to_data_stream.rb

@@ -39,14 +39,13 @@ module ElasticsearchServerless
         # @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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/data-streams.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-migrate-to-data-stream
         #
         def migrate_to_data_stream(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.migrate_to_data_stream" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.migrate_to_data_stream' }
 
-          defined_params = [:name].inject({}) do |set_variables, variable|
+          defined_params = [:name].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/indices/modify_data_stream.rb

@@ -28,10 +28,10 @@ module ElasticsearchServerless
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/data-streams.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-modify-data-stream
         #
         def modify_data_stream(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.modify_data_stream" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.modify_data_stream' }
 
           raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
 
@@ -41,7 +41,7 @@ module ElasticsearchServerless
           body = arguments.delete(:body)
 
           method = ElasticsearchServerless::API::HTTP_POST
-          path   = "_data_stream/_modify"
+          path   = '_data_stream/_modify'
           params = {}
 
           ElasticsearchServerless::API::Response.new(

data/lib/elasticsearch-serverless/api/indices/put_alias.rb

@@ -38,14 +38,13 @@ module ElasticsearchServerless
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-aliases.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-alias
         #
         def put_alias(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.put_alias" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.put_alias' }
 
-          defined_params = [:index, :name].inject({}) do |set_variables, variable|
+          defined_params = [:index, :name].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
@@ -62,9 +61,7 @@ module ElasticsearchServerless
           _name = arguments.delete(:name)
 
           method = ElasticsearchServerless::API::HTTP_PUT
-          path   = if _index && _name
-                     "#{Utils.listify(_index)}/_aliases/#{Utils.listify(_name)}"
-                   end
+          path   = ("#{Utils.listify(_index)}/_aliases/#{Utils.listify(_name)}" if _index && _name)
           params = Utils.process_params(arguments)
 
           ElasticsearchServerless::API::Response.new(

data/lib/elasticsearch-serverless/api/indices/put_data_lifecycle.rb

@@ -37,20 +37,18 @@ module ElasticsearchServerless
         # @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 [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body lifecycle
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/data-streams-put-lifecycle.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-data-lifecycle
         #
         def put_data_lifecycle(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.put_data_lifecycle" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.put_data_lifecycle' }
 
-          defined_params = [:name].inject({}) do |set_variables, variable|
+          defined_params = [:name].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           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

data/lib/elasticsearch-serverless/api/indices/put_index_template.rb

@@ -24,6 +24,25 @@ module ElasticsearchServerless
       module Actions
         # Create or update an 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 wildcard pattern that matches the index name.
+        # Index templates are applied during data stream or index creation.
+        # For data streams, these settings and mappings are applied when the stream's backing indices are created.
+        # Settings and mappings specified in a create index API request override any settings or mappings specified in an index template.
+        # Changes to index templates do not affect existing indices, including the existing backing indices of a data stream.
+        # 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.
+        # **Multiple matching templates**
+        # If multiple index templates match the name of a new index or data stream, the template with the highest priority is used.
+        # Multiple templates with overlapping index patterns at the same priority are not allowed and an error will be thrown when attempting to create a template matching an existing index template at identical priorities.
+        # **Composing aliases, mappings, and settings**
+        # When multiple component templates are specified in the +composed_of+ field for an index template, they are merged in the order specified, meaning that later component templates override earlier component templates.
+        # Any mappings, settings, or aliases from the parent index template are merged in next.
+        # Finally, any configuration on the index request itself is merged.
+        # Mapping definitions are merged recursively, which means that later mapping components can introduce new field mappings and update the mapping configuration.
+        # If a field mapping is already contained in an earlier component, its definition will be completely overwritten by the later one.
+        # This recursive merging strategy applies not only to field mappings, but also root options like +dynamic_templates+ and +meta+.
+        # If an earlier component contains a +dynamic_templates+ block, then by default new +dynamic_templates+ entries are appended onto the end.
+        # If an entry already exists with the same key, then it is overwritten by the new definition.
         #
         # @option arguments [String] :name Index or template name (*Required*)
         # @option arguments [Boolean] :create If +true+, this request cannot replace or update existing index templates.
@@ -33,14 +52,13 @@ module ElasticsearchServerless
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-put-template.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-index-template
         #
         def put_index_template(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.put_index_template" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.put_index_template' }
 
-          defined_params = [:name].inject({}) do |set_variables, variable|
+          defined_params = [:name].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/indices/put_mapping.rb

@@ -23,9 +23,25 @@ module ElasticsearchServerless
     module Indices
       module Actions
         # Update field mappings.
-        # Adds new fields to an existing data stream or index.
-        # You can also use this API to change the search settings of existing fields.
+        # Add new fields to an existing data stream or index.
+        # You can also use this API to change the search settings of existing fields and add new properties to existing object fields.
         # For data streams, these changes are applied to all backing indices by default.
+        # **Add multi-fields to an existing field**
+        # Multi-fields let you index the same field in different ways.
+        # You can use this API to update the fields mapping parameter and enable multi-fields for an existing field.
+        # WARNING: If an index (or data stream) contains documents when you add a multi-field, those documents will not have values for the new multi-field.
+        # You can populate the new multi-field with the update by query API.
+        # **Change supported mapping parameters for an existing field**
+        # The documentation for each mapping parameter indicates whether you can update it for an existing field using this API.
+        # For example, you can use the update mapping API to update the +ignore_above+ parameter.
+        # **Change the mapping of an existing field**
+        # Except for supported mapping parameters, you can't change the mapping or field type of an existing field.
+        # Changing an existing field could invalidate data that's already indexed.
+        # If you need to change the mapping of a field in a data stream's backing indices, refer to documentation about modifying data streams.
+        # If you need to change the mapping of a field in other indices, create a new index with the correct mapping and reindex your data into that index.
+        # **Rename a field**
+        # Renaming a field would invalidate data already indexed under the old field name.
+        # Instead, add an alias field to create an alternate field name.
         #
         # @option arguments [String, Array] :index A comma-separated list of index names the mapping should be added to (supports wildcards); use +_all+ or omit to add the mapping on all indices. (*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.
@@ -43,14 +59,13 @@ module ElasticsearchServerless
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-put-mapping.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-mapping
         #
         def put_mapping(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.put_mapping" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.put_mapping' }
 
-          defined_params = [:index].inject({}) do |set_variables, variable|
+          defined_params = [:index].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/indices/put_settings.rb

@@ -23,8 +23,19 @@ module ElasticsearchServerless
     module Indices
       module Actions
         # Update index settings.
-        # Changes dynamic index settings in real time. For data streams, index setting
-        # changes are applied to all backing indices by default.
+        # Changes dynamic index settings in real time.
+        # For data streams, index setting changes are applied to all backing indices by default.
+        # To revert a setting to the default value, use a null value.
+        # The list of per-index settings that can be updated dynamically on live indices can be found in index module documentation.
+        # To preserve existing settings from being updated, set the +preserve_existing+ parameter to +true+.
+        # NOTE: You can only define new analyzers on closed indices.
+        # To add an analyzer, you must close the index, define the analyzer, and reopen the index.
+        # You cannot close the write index of a data stream.
+        # To update the analyzer for a data stream's write index and future backing indices, update the analyzer in the index template used by the stream.
+        # Then roll over the data stream to apply the new analyzer to the stream's write index and future backing indices.
+        # This affects searches and any new data added to the stream after the rollover.
+        # However, it does not affect the data stream's backing indices or their existing data.
+        # To change the analyzer for existing backing indices, you must create a new data stream and reindex your data into it.
         #
         # @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
@@ -49,14 +60,13 @@ module ElasticsearchServerless
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body settings
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-update-settings.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-settings
         #
         def put_settings(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.put_settings" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.put_settings' }
 
-          defined_params = [:index].inject({}) do |set_variables, variable|
+          defined_params = [:index].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
@@ -73,7 +83,7 @@ module ElasticsearchServerless
           path   = if _index
                      "#{Utils.listify(_index)}/_settings"
                    else
-                     "_settings"
+                     '_settings'
                    end
           params = Utils.process_params(arguments)
 

data/lib/elasticsearch-serverless/api/indices/refresh.rb

@@ -25,6 +25,13 @@ module ElasticsearchServerless
         # Refresh an index.
         # 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.
+        # 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.
+        # 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 (+*+).
@@ -38,14 +45,13 @@ module ElasticsearchServerless
         # @option arguments [Boolean] :ignore_unavailable If +false+, the request returns an error if it targets a missing or closed index.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-refresh.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-refresh
         #
         def refresh(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.refresh" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.refresh' }
 
-          defined_params = [:index].inject({}) do |set_variables, variable|
+          defined_params = [:index].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 
@@ -60,7 +66,7 @@ module ElasticsearchServerless
           path   = if _index
                      "#{Utils.listify(_index)}/_refresh"
                    else
-                     "_refresh"
+                     '_refresh'
                    end
           params = Utils.process_params(arguments)
 

data/lib/elasticsearch-serverless/api/indices/resolve_index.rb

@@ -22,7 +22,8 @@ module ElasticsearchServerless
   module API
     module Indices
       module Actions
-        # Resolves the specified name(s) and/or index patterns for indices, aliases, and data streams.
+        # Resolve indices.
+        # Resolve the names and/or index patterns for indices, aliases, and data streams.
         # 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.
@@ -37,14 +38,13 @@ module ElasticsearchServerless
         #  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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-resolve-index-api.html
+        # @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" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.resolve_index' }
 
-          defined_params = [:name].inject({}) do |set_variables, variable|
+          defined_params = [:name].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
 

data/lib/elasticsearch-serverless/api/indices/rollover.rb

@@ -23,7 +23,31 @@ module ElasticsearchServerless
     module Indices
       module Actions
         # Roll over to a new index.
-        # Creates a new index for a data stream or index alias.
+        # TIP: It is recommended to use the index lifecycle rollover action to automate rollovers.
+        # The rollover API creates a new index for a data stream or index alias.
+        # The API behavior depends on the rollover target.
+        # **Roll over a data stream**
+        # If you roll over a data stream, the API creates a new write index for the stream.
+        # The stream's previous write index becomes a regular backing index.
+        # A rollover also increments the data stream's generation.
+        # **Roll over an index alias with a write index**
+        # 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.
+        # **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.
+        # **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+.
+        # 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+.
         #
         # @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.
@@ -39,14 +63,13 @@ module ElasticsearchServerless
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-rollover-index.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-rollover
         #
         def rollover(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || "indices.rollover" }
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.rollover' }
 
-          defined_params = [:alias, :new_index].inject({}) do |set_variables, variable|
+          defined_params = [:alias, :new_index].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
-            set_variables
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?