elasticsearch-api 8.18.0 → 9.0.1

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

@@ -15,18 +15,23 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# 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 IndexLifecycleManagement
       module Actions
-        # Start the index lifecycle management (ILM) plugin.
+        # Start the ILM plugin.
+        # Start the index lifecycle management plugin if it is currently stopped.
+        # ILM is started automatically when the cluster is formed.
+        # Restarting ILM is necessary only when it has been stopped using the stop ILM API.
         #
+        # @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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ilm-start.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ilm-start
         #
         def start(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ilm.start' }
@@ -34,11 +39,11 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_ilm/start'
-          params = {}
+          params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(
             perform_request(method, path, params, body, headers, request_opts)

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

@@ -15,18 +15,24 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# 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 IndexLifecycleManagement
       module Actions
-        # Halts all lifecycle management operations and stops the index lifecycle management (ILM) plugin
+        # Stop the ILM plugin.
+        # Halt all lifecycle management operations and stop the index lifecycle management plugin.
+        # This is useful when you are performing maintenance on the cluster and need to prevent ILM from performing any actions on your indices.
+        # The API returns as soon as the stop request has been acknowledged, but the plugin might continue to run until in-progress operations complete and the plugin can be safely stopped.
+        # Use the get ILM status API to check whether ILM is running.
         #
+        # @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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ilm-stop.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ilm-stop
         #
         def stop(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'ilm.stop' }
@@ -34,11 +40,11 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_ilm/stop'
-          params = {}
+          params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(
             perform_request(method, path, params, body, headers, request_opts)

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

@@ -15,30 +15,43 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# 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
-        # Adds a block to an index.
+        # Add an index block.
+        # Add an index block to an index.
+        # Index blocks limit the operations allowed on an index by blocking specific operation types.
         #
-        # @option arguments [List] :index A comma separated list of indices to add a block to
-        # @option arguments [String] :block The block to add (one of read, write, read_only or metadata)
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
-        # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when unavailable (missing or closed)
-        # @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] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. (options: open, closed, hidden, none, all)
+        # @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 adding blocks to.
+        #  To allow the adding of blocks to 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 add to 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 [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/index-modules-blocks.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-add-block
         #
         def add_block(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.add_block' }
 
-          defined_params = %i[index block].each_with_object({}) do |variable, set_variables|
+          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?
@@ -49,14 +62,14 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           _index = arguments.delete(:index)
 
           _block = arguments.delete(:block)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "#{Utils.__listify(_index)}/_block/#{Utils.__listify(_block)}"
+          path   = "#{Utils.listify(_index)}/_block/#{Utils.listify(_block)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,20 +15,27 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# 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
-        # Performs the analysis process on a text and return the tokens breakdown of the text.
+        # Get tokens from text analysis.
+        # The analyze API performs analysis on a text string and returns the resulting tokens.
+        # Generating excessive amount of tokens may cause a node to run out of memory.
+        # The +index.analyze.max_token_count+ setting enables you to limit the number of tokens that can be produced.
+        # If more than this limit of tokens gets generated, an error occurs.
+        # The +_analyze+ endpoint without a specified index will always use +10000+ as its limit.
         #
-        # @option arguments [String] :index The name of the index to scope the operation
+        # @option arguments [String] :index Index used to derive the analyzer.
+        #  If specified, the +analyzer+ or field parameter overrides this value.
+        #  If no index is specified or the index does not have a default analyzer, the analyze API uses the standard analyzer.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body Define analyzer/tokenizer parameters and the text on which the analysis should be performed
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-analyze.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-analyze
         #
         def analyze(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.analyze' }
@@ -51,11 +58,11 @@ module Elasticsearch
                      Elasticsearch::API::HTTP_GET
                    end
 
-          path = if _index
-                   "#{Utils.__listify(_index)}/_analyze"
-                 else
-                   '_analyze'
-                 end
+          path   = if _index
+                     "#{Utils.listify(_index)}/_analyze"
+                   else
+                     '_analyze'
+                   end
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/{rollup/start_job.rb → indices/cancel_migrate_reindex.rb}

@@ -15,43 +15,44 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# 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 Rollup
+    module Indices
       module Actions
-        # Starts an existing, stopped rollup job.
+        # 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] :id The ID of the job to start
+        # @option arguments [String, Array] :index The index or data stream name (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/rollup-start-job.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-cancel-migrate-reindex
         #
-        def start_job(arguments = {})
-          request_opts = { endpoint: arguments[:endpoint] || 'rollup.start_job' }
+        def cancel_migrate_reindex(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'indices.cancel_migrate_reindex' }
 
-          defined_params = [:id].each_with_object({}) do |variable, set_variables|
+          defined_params = [:index].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 'id' missing" unless arguments[:id]
+          raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
 
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
           body = nil
 
-          _id = arguments.delete(:id)
+          _index = arguments.delete(:index)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_rollup/job/#{Utils.__listify(_id)}/_start"
+          path   = "_migration/reindex/#{Utils.listify(_index)}/_cancel"
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,26 +15,38 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# 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
-        # Clears all or specific caches for one or more indices.
+        # Clear the cache.
+        # Clear the cache of one or more indices.
+        # For data streams, the API clears the caches of the stream's backing indices.
+        # By default, the clear cache API clears all caches.
+        # To clear only specific caches, use the +fielddata+, +query+, or +request+ parameters.
+        # To clear the cache only of specific fields, use the +fields+ parameter.
         #
-        # @option arguments [List] :index A comma-separated list of index name to limit the operation
-        # @option arguments [Boolean] :fielddata Clear field data
-        # @option arguments [List] :fields A comma-separated list of fields to clear when using the `fielddata` parameter (default: all)
-        # @option arguments [Boolean] :query Clear query caches
-        # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when unavailable (missing or closed)
-        # @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] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. (options: open, closed, hidden, none, all)
-        # @option arguments [Boolean] :request Clear request cache
+        # @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.
+        #  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] :fielddata If +true+, clears the fields cache.
+        #  Use the +fields+ parameter to clear the cache of specific fields only.
+        # @option arguments [String, Array<String>] :fields Comma-separated list of field names used to limit the +fielddata+ parameter.
+        # @option arguments [Boolean] :ignore_unavailable If +false+, the request returns an error if it targets a missing or closed index.
+        # @option arguments [Boolean] :query If +true+, clears the query cache.
+        # @option arguments [Boolean] :request If +true+, clears the request cache.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-clearcache.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-clear-cache
         #
         def clear_cache(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.clear_cache' }
@@ -47,13 +59,13 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           _index = arguments.delete(:index)
 
           method = Elasticsearch::API::HTTP_POST
           path   = if _index
-                     "#{Utils.__listify(_index)}/_cache/clear"
+                     "#{Utils.listify(_index)}/_cache/clear"
                    else
                      '_cache/clear'
                    end

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

@@ -15,29 +15,62 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# 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
-        # Clones an index
+        # Clone an index.
+        # Clone an existing index into a new index.
+        # Each original primary shard is cloned into a new primary shard in the new index.
+        # IMPORTANT: Elasticsearch does not apply index templates to the resulting index.
+        # The API also does not copy index metadata from the original index.
+        # Index metadata includes aliases, index lifecycle management phase definitions, and cross-cluster replication (CCR) follower information.
+        # For example, if you clone a CCR follower index, the resulting clone will not be a follower index.
+        # The clone API copies most index settings from the source index to the resulting index, with the exception of +index.number_of_replicas+ and +index.auto_expand_replicas+.
+        # To set the number of replicas in the resulting index, configure these settings in the clone request.
+        # Cloning works as follows:
+        # * First, it creates a new target index with the same definition as the source index.
+        # * Then it hard-links segments from the source index into the target index. If the file system does not support hard-linking, all segments are copied into the new index, which is a much more time consuming process.
+        # * Finally, it recovers the target index as though it were a closed index which had just been re-opened.
+        # IMPORTANT: Indices can only be cloned if they meet the following requirements:
+        # * The index must be marked as read-only and have a cluster health status of green.
+        # * The target index must not exist.
+        # * The source index must have the same number of primary shards as the target index.
+        # * The node handling the clone process must have sufficient free disk space to accommodate a second copy of the existing index.
+        # The current write index on a data stream cannot be cloned.
+        # In order to clone the current write index, the data stream must first be rolled over so that a new write index is created and then the previous write index can be cloned.
+        # NOTE: Mappings cannot be specified in the +_clone+ request. The mappings of the source index will be used for the target index.
+        # **Monitor the cloning process**
+        # The cloning process can be monitored with the cat recovery API or the cluster health API can be used to wait until all primary shards have been allocated by setting the +wait_for_status+ parameter to +yellow+.
+        # The +_clone+ API returns as soon as the target index has been added to the cluster state, before any shards have been allocated.
+        # At this point, all shards are in the state unassigned.
+        # If, for any reason, the target index can't be allocated, its primary shard will remain unassigned until it can be allocated on that node.
+        # Once the primary shard is allocated, it moves to state initializing, and the clone process begins.
+        # When the clone operation completes, the shard will become active.
+        # At that point, Elasticsearch will try to allocate any replicas and may decide to relocate the primary shard to another node.
+        # **Wait for active shards**
+        # Because the clone operation creates a new index to clone the shards to, the wait for active shards setting on index creation applies to the clone index action as well.
         #
-        # @option arguments [String] :index The name of the source index to clone
-        # @option arguments [String] :target The name of the target index to clone into
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
-        # @option arguments [String] :wait_for_active_shards Set the number of active shards to wait for on the cloned index before the operation returns.
+        # @option arguments [String] :index Name of the source index to clone. (*Required*)
+        # @option arguments [String] :target Name of the target index to create. (*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 [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.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The configuration for the target index (`settings` and `aliases`)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-clone-index.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-clone
         #
         def clone(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.clone' }
 
-          defined_params = %i[index target].each_with_object({}) do |variable, set_variables|
+          defined_params = [:index, :target].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?
@@ -48,14 +81,14 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           _index = arguments.delete(:index)
 
           _target = arguments.delete(:target)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "#{Utils.__listify(_index)}/_clone/#{Utils.__listify(_target)}"
+          path   = "#{Utils.listify(_index)}/_clone/#{Utils.listify(_target)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,25 +15,45 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# 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
-        # Closes an index.
+        # Close an index.
+        # A closed index is blocked for read or write operations and does not allow all operations that opened indices allow.
+        # It is not possible to index documents or to search for documents in a closed index.
+        # Closed indices do not have to maintain internal data structures for indexing or searching documents, which results in a smaller overhead on the cluster.
+        # When opening or closing an index, the master node is responsible for restarting the index shards to reflect the new state of the index.
+        # The shards will then go through the normal recovery process.
+        # The data of opened and closed indices is automatically replicated by the cluster to ensure that enough shard copies are safely kept around at all times.
+        # You can open and close multiple indices.
+        # An error is thrown if the request explicitly refers to a missing index.
+        # This behaviour can be turned off using the +ignore_unavailable=true+ parameter.
+        # By default, you must explicitly name the indices you are opening or closing.
+        # To open or close indices with +_all+, +*+, or other wildcard expressions, change the+action.destructive_requires_name+ setting to +false+. This setting can also be changed with the cluster update settings API.
+        # Closed indices consume a significant amount of disk-space which can cause problems in managed environments.
+        # Closing indices can be turned off with the cluster settings API by setting +cluster.indices.close.enable+ to +false+.
         #
-        # @option arguments [List] :index A comma separated list of indices to close
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
-        # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when unavailable (missing or closed)
-        # @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] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. (options: open, closed, hidden, none, all)
-        # @option arguments [String] :wait_for_active_shards Sets the number of active shards to wait for before the operation returns.
+        # @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.
+        #  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.
+        # @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.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-open-close.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-close
         #
         def close(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.close' }
@@ -48,12 +68,12 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           _index = arguments.delete(:index)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "#{Utils.__listify(_index)}/_close"
+          path   = "#{Utils.listify(_index)}/_close"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,23 +15,41 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# 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
-        # Creates an index with optional settings and mappings.
+        # Create an index.
+        # You can use the create index API to add a new index to an Elasticsearch cluster.
+        # When creating an index, you can specify the following:
+        # * Settings for the index.
+        # * Mappings for fields in the index.
+        # * Index aliases
+        # **Wait for active shards**
+        # By default, index creation will only return a response to the client when the primary copies of each shard have been started, or the request times out.
+        # The index creation response will indicate what happened.
+        # For example, +acknowledged+ indicates whether the index was successfully created in the cluster, +while shards_acknowledged+ indicates whether the requisite number of shard copies were started for each shard in the index before timing out.
+        # Note that it is still possible for either +acknowledged+ or +shards_acknowledged+ to be +false+, but for the index creation to be successful.
+        # These values simply indicate whether the operation completed before the timeout.
+        # If +acknowledged+ is false, the request timed out before the cluster state was updated with the newly created index, but it probably will be created sometime soon.
+        # If +shards_acknowledged+ is false, then the request timed out before the requisite number of shards were started (by default just the primaries), even if the cluster state was successfully updated to reflect the newly created index (that is to say, +acknowledged+ is +true+).
+        # You can change the default of only waiting for the primary shards to start through the index setting +index.write.wait_for_active_shards+.
+        # Note that changing this setting will also affect the +wait_for_active_shards+ value on all subsequent write operations.
         #
-        # @option arguments [String] :index The name of the index
-        # @option arguments [String] :wait_for_active_shards Set the number of active shards to wait for before the operation returns.
-        # @option arguments [Time] :timeout Explicit operation timeout
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [String] :index Name of the index you wish to create. (*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 [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.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The configuration for the index (`settings` and `mappings`)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/indices-create-index.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-create
         #
         def create(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'indices.create' }
@@ -46,12 +64,12 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           _index = arguments.delete(:index)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "#{Utils.__listify(_index)}"
+          path   = Utils.listify(_index).to_s
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(