elasticsearch-api 8.17.2 → 9.0.0

data/lib/elasticsearch/api/actions/cluster/put_settings.rb

@@ -15,22 +15,35 @@
 # 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 Cluster
       module Actions
-        # Updates the cluster settings.
+        # Update the cluster settings.
+        # Configure and update dynamic settings on a running cluster.
+        # You can also configure dynamic settings locally on an unstarted or shut down node in +elasticsearch.yml+.
+        # Updates made with this API can be persistent, which apply across cluster restarts, or transient, which reset after a cluster restart.
+        # You can also reset transient or persistent settings by assigning them a null value.
+        # If you configure the same setting using multiple methods, Elasticsearch applies the settings in following order of precedence: 1) Transient setting; 2) Persistent setting; 3) +elasticsearch.yml+ setting; 4) Default setting value.
+        # For example, you can apply a transient setting to override a persistent setting or +elasticsearch.yml+ setting.
+        # However, a change to an +elasticsearch.yml+ setting will not override a defined transient or persistent setting.
+        # TIP: In Elastic Cloud, use the user settings feature to configure all cluster settings. This method automatically rejects unsafe settings that could break your cluster.
+        # If you run Elasticsearch on your own hardware, use this API to configure dynamic cluster settings.
+        # Only use +elasticsearch.yml+ for static cluster settings and node settings.
+        # The API doesn’t require a restart and ensures a setting’s value is the same on all nodes.
+        # WARNING: Transient cluster settings are no longer recommended. Use persistent cluster settings instead.
+        # If a cluster becomes unstable, transient settings can clear unexpectedly, resulting in a potentially undesired cluster configuration.
         #
         # @option arguments [Boolean] :flat_settings Return settings in flat format (default: false)
-        # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
-        # @option arguments [Time] :timeout Explicit operation timeout
+        # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node Server default: 30s.
+        # @option arguments [Time] :timeout Explicit operation timeout Server default: 30s.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The settings to be updated. Can be either `transient` or `persistent` (survives cluster restart). (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/cluster-update-settings.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-put-settings
         #
         def put_settings(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.put_settings' }
@@ -40,7 +53,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body = arguments.delete(:body) || {}
+          body = arguments.delete(:body)
 
           method = Elasticsearch::API::HTTP_PUT
           path   = '_cluster/settings'

data/lib/elasticsearch/api/actions/cluster/remote_info.rb

@@ -15,18 +15,20 @@
 # 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 Cluster
       module Actions
-        # Returns the information about configured remote clusters.
+        # Get remote cluster information.
+        # Get information about configured remote clusters.
+        # The API returns connection and endpoint information keyed by the configured remote cluster alias.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/cluster-remote-info.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-remote-info
         #
         def remote_info(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.remote_info' }
@@ -34,7 +36,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_remote/info'

data/lib/elasticsearch/api/actions/cluster/reroute.rb

@@ -15,25 +15,35 @@
 # 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 Cluster
       module Actions
-        # Allows to manually change the allocation of individual shards in the cluster.
+        # Reroute the cluster.
+        # Manually change the allocation of individual shards in the cluster.
+        # For example, a shard can be moved from one node to another explicitly, an allocation can be canceled, and an unassigned shard can be explicitly allocated to a specific node.
+        # It is important to note that after processing any reroute commands Elasticsearch will perform rebalancing as normal (respecting the values of settings such as +cluster.routing.rebalance.enable+) in order to remain in a balanced state.
+        # For example, if the requested allocation includes moving a shard from node1 to node2 then this may cause a shard to be moved from node2 back to node1 to even things out.
+        # The cluster can be set to disable allocations using the +cluster.routing.allocation.enable+ setting.
+        # If allocations are disabled then the only allocations that will be performed are explicit ones given using the reroute command, and consequent allocations due to rebalancing.
+        # The cluster will attempt to allocate a shard a maximum of +index.allocation.max_retries+ times in a row (defaults to +5+), before giving up and leaving the shard unallocated.
+        # This scenario can be caused by structural problems such as having an analyzer which refers to a stopwords file which doesn’t exist on all nodes.
+        # Once the problem has been corrected, allocation can be manually retried by calling the reroute API with the +?retry_failed+ URI query parameter, which will attempt a single retry round for these shards.
         #
-        # @option arguments [Boolean] :dry_run Simulate the operation only and return the resulting state
-        # @option arguments [Boolean] :explain Return an explanation of why the commands can or cannot be executed
-        # @option arguments [Boolean] :retry_failed Retries allocation of shards that are blocked due to too many subsequent allocation failures
-        # @option arguments [List] :metric Limit the information returned to the specified metrics. Defaults to all but metadata (options: _all, blocks, metadata, nodes, none, routing_table, master_node, version)
-        # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
-        # @option arguments [Time] :timeout Explicit operation timeout
+        # @option arguments [Boolean] :dry_run If true, then the request simulates the operation.
+        #  It will calculate the result of applying the commands to the current cluster state and return the resulting cluster state after the commands (and rebalancing) have been applied; it will not actually perform the requested changes.
+        # @option arguments [Boolean] :explain If true, then the response contains an explanation of why the commands can or cannot run.
+        # @option arguments [String, Array<String>] :metric Limits the information returned to the specified metrics. Server default: all.
+        # @option arguments [Boolean] :retry_failed If true, then retries allocation of shards that are blocked due to too many subsequent allocation failures.
+        # @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
-        # @option arguments [Hash] :body The definition of `commands` to perform (`move`, `cancel`, `allocate`)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/cluster-reroute.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-reroute
         #
         def reroute(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.reroute' }
@@ -41,7 +51,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body = arguments.delete(:body) || {}
+          body = arguments.delete(:body)
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_cluster/reroute'

data/lib/elasticsearch/api/actions/cluster/state.rb

@@ -15,33 +15,46 @@
 # 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 Cluster
       module Actions
-        # Returns a comprehensive information about the state of the cluster.
+        # Get the cluster state.
+        # Get comprehensive information about the state of the cluster.
+        # The cluster state is an internal data structure which keeps track of a variety of information needed by every node, including the identity and attributes of the other nodes in the cluster; cluster-wide settings; index metadata, including the mapping and settings for each index; the location and status of every shard copy in the cluster.
+        # The elected master node ensures that every node in the cluster has a copy of the same cluster state.
+        # This API lets you retrieve a representation of this internal state for debugging or diagnostic purposes.
+        # You may need to consult the Elasticsearch source code to determine the precise meaning of the response.
+        # By default the API will route requests to the elected master node since this node is the authoritative source of cluster states.
+        # You can also retrieve the cluster state held on the node handling the API request by adding the +?local=true+ query parameter.
+        # Elasticsearch may need to expend significant effort to compute a response to this API in larger clusters, and the response may comprise a very large quantity of data.
+        # If you use this API repeatedly, your cluster may become unstable.
+        # WARNING: The response is a representation of an internal data structure.
+        # Its format is not subject to the same compatibility guarantees as other more stable APIs and may change from version to version.
+        # Do not query this API using external monitoring tools.
+        # Instead, obtain the information you require using other more stable cluster APIs.
         #
-        # @option arguments [List] :metric Limit the information returned to the specified metrics (options: _all, blocks, metadata, nodes, routing_table, routing_nodes, master_node, version)
-        # @option arguments [List] :index A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices
-        # @option arguments [Boolean] :local Return local information, do not retrieve the state from master node (default: false)
-        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [String, Array<String>] :metric Limit the information returned to the specified metrics
+        # @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) Server default: true.
+        # @option arguments [String, Array<String>] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both.
         # @option arguments [Boolean] :flat_settings Return settings in flat format (default: false)
-        # @option arguments [Number] :wait_for_metadata_version Wait for the metadata version to be equal or greater than the specified metadata version
-        # @option arguments [Time] :wait_for_timeout The maximum time to wait for wait_for_metadata_version before timing out
         # @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] :local Return local information, do not retrieve the state from master node (default: false)
+        # @option arguments [Time] :master_timeout Specify timeout for connection to master Server default: 30s.
+        # @option arguments [Integer] :wait_for_metadata_version Wait for the metadata version to be equal or greater than the specified metadata version
+        # @option arguments [Time] :wait_for_timeout The maximum time to wait for wait_for_metadata_version before timing out
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/cluster-state.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-state
         #
         def state(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.state' }
 
-          defined_params = %i[metric index].each_with_object({}) do |variable, set_variables|
+          defined_params = [:metric, :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?
@@ -57,9 +70,9 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _metric && _index
-                     "_cluster/state/#{Utils.__listify(_metric)}/#{Utils.__listify(_index)}"
+                     "_cluster/state/#{Utils.listify(_metric)}/#{Utils.listify(_index)}"
                    elsif _metric
-                     "_cluster/state/#{Utils.__listify(_metric)}"
+                     "_cluster/state/#{Utils.listify(_metric)}"
                    else
                      '_cluster/state'
                    end

data/lib/elasticsearch/api/actions/cluster/stats.rb

@@ -15,21 +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 Cluster
       module Actions
-        # Returns high-level overview of cluster statistics.
+        # Get cluster statistics.
+        # Get basic index metrics (shard numbers, store size, memory usage) and information about the current nodes that form the cluster (number, roles, os, jvm versions, memory usage, cpu and installed plugins).
         #
-        # @option arguments [List] :node_id A comma-separated list of node IDs or names to limit the returned information; use `_local` to return information from the node you're connecting to, leave empty to get information from all nodes
-        # @option arguments [Boolean] :include_remotes Include remote cluster data into the response (default: false)
-        # @option arguments [Time] :timeout Explicit operation timeout
+        # @option arguments [String, Array] :node_id Comma-separated list of node filters used to limit returned information. Defaults to all nodes in the cluster.
+        # @option arguments [Boolean] :include_remotes Include remote cluster data into the response
+        # @option arguments [Time] :timeout Period to wait for each node to respond.
+        #  If a node does not respond before its timeout expires, the response does not include its stats.
+        #  However, timed out nodes are included in the response’s +_nodes.failed+ property. Defaults to no timeout.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/cluster-stats.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-stats
         #
         def stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'cluster.stats' }
@@ -48,7 +51,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _node_id
-                     "_cluster/stats/nodes/#{Utils.__listify(_node_id)}"
+                     "_cluster/stats/nodes/#{Utils.listify(_node_id)}"
                    else
                      '_cluster/stats'
                    end

data/lib/elasticsearch/api/actions/connector/check_in.rb

@@ -15,23 +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 Connector
       module Actions
-        # Updates the last_seen timestamp in the connector document.
+        # Check in a connector.
+        # Update the +last_seen+ field in the connector and set it to the current timestamp.
         # 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] :connector_id The unique identifier of the connector to be updated.
+        # @option arguments [String] :connector_id The unique identifier of the connector to be checked in (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/check-in-connector-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-connector-check-in
         #
         def check_in(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'connector.check_in' }
@@ -51,7 +52,7 @@ module Elasticsearch
           _connector_id = arguments.delete(:connector_id)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "_connector/#{Utils.__listify(_connector_id)}/_check_in"
+          path   = "_connector/#{Utils.listify(_connector_id)}/_check_in"
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,24 +15,29 @@
 # 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 Connector
       module Actions
-        # Deletes a connector.
-        # 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.
+        # Delete a connector.
+        # Removes a connector and associated sync jobs.
+        # This is a destructive action that is not recoverable.
+        # NOTE: This action doesn’t delete any API keys, ingest pipelines, or data indices associated with the connector.
+        # These need to be removed manually.
+        # This functionality is in Beta and is subject to change. The design and
+        # code is less mature than official GA features and is being provided
+        # as-is with no warranties. Beta features are not subject to the support
+        # SLA of official GA features.
         #
-        # @option arguments [String] :connector_id The unique identifier of the connector to be deleted.
-        # @option arguments [Boolean] :delete_sync_jobs Determines whether associated sync jobs are also deleted.
+        # @option arguments [String] :connector_id The unique identifier of the connector to be deleted (*Required*)
+        # @option arguments [Boolean] :delete_sync_jobs A flag indicating if associated sync jobs should be also removed. Defaults to false.
+        # @option arguments [Boolean] :hard A flag indicating if the connector should be hard deleted.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/delete-connector-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-connector-delete
         #
         def delete(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'connector.delete' }
@@ -52,7 +57,7 @@ module Elasticsearch
           _connector_id = arguments.delete(:connector_id)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = "_connector/#{Utils.__listify(_connector_id)}"
+          path   = "_connector/#{Utils.listify(_connector_id)}"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,23 +15,25 @@
 # 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 Connector
       module Actions
-        # Returns the details about a connector.
-        # 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.
+        # Get a connector.
+        # Get the details about a connector.
+        # This functionality is in Beta and is subject to change. The design and
+        # code is less mature than official GA features and is being provided
+        # as-is with no warranties. Beta features are not subject to the support
+        # SLA of official GA features.
         #
-        # @option arguments [String] :connector_id The unique identifier of the connector to be returned.
+        # @option arguments [String] :connector_id The unique identifier of the connector (*Required*)
+        # @option arguments [Boolean] :include_deleted A flag to indicate if the desired connector should be fetched, even if it was soft-deleted.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-connector-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-connector-get
         #
         def get(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'connector.get' }
@@ -51,8 +53,8 @@ module Elasticsearch
           _connector_id = arguments.delete(:connector_id)
 
           method = Elasticsearch::API::HTTP_GET
-          path   = "_connector/#{Utils.__listify(_connector_id)}"
-          params = {}
+          path   = "_connector/#{Utils.listify(_connector_id)}"
+          params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(
             perform_request(method, path, params, body, headers, request_opts)

data/lib/elasticsearch/api/actions/connector/list.rb

@@ -15,28 +15,30 @@
 # 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 Connector
       module Actions
-        # Lists all connectors.
-        # 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.
+        # Get all connectors.
+        # Get information about all connectors.
+        # This functionality is in Beta and is subject to change. The design and
+        # code is less mature than official GA features and is being provided
+        # as-is with no warranties. Beta features are not subject to the support
+        # SLA of official GA features.
         #
         # @option arguments [Integer] :from Starting offset (default: 0)
-        # @option arguments [Integer] :size Specifies a max number of results to get (default: 100)
-        # @option arguments [List] :index_name A comma-separated list of connector index names to fetch connector documents for
-        # @option arguments [List] :connector_name A comma-separated list of connector names to fetch connector documents for
-        # @option arguments [List] :service_type A comma-separated list of connector service types to fetch connector documents for
-        # @option arguments [String] :query A search string for querying connectors, filtering results by matching against connector names, descriptions, and index names
+        # @option arguments [Integer] :size Specifies a max number of results to get
+        # @option arguments [String, Array] :index_name A comma-separated list of connector index names to fetch connector documents for
+        # @option arguments [String, Array<String>] :connector_name A comma-separated list of connector names to fetch connector documents for
+        # @option arguments [String, Array<String>] :service_type A comma-separated list of connector service types to fetch connector documents for
+        # @option arguments [Boolean] :include_deleted A flag to indicate if the desired connector should be fetched, even if it was soft-deleted.
+        # @option arguments [String] :query A wildcard query string that filters connectors with matching name, description or index name
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/list-connector-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-connector-list
         #
         def list(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'connector.list' }
@@ -44,7 +46,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_connector'

data/lib/elasticsearch/api/actions/connector/post.rb

@@ -15,23 +15,26 @@
 # 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 Connector
       module Actions
-        # Creates a connector.
-        # 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.
+        # Create a connector.
+        # Connectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.
+        # Elastic managed connectors (Native connectors) are a managed service on Elastic Cloud.
+        # Self-managed connectors (Connector clients) are self-managed on your infrastructure.
+        # This functionality is in Beta and is subject to change. The design and
+        # code is less mature than official GA features and is being provided
+        # as-is with no warranties. Beta features are not subject to the support
+        # SLA of official GA features.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The connector configuration.
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/create-connector-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-connector-put
         #
         def post(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'connector.post' }
@@ -39,7 +42,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_connector'

data/lib/elasticsearch/api/actions/connector/put.rb

@@ -15,24 +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 Connector
       module Actions
-        # Creates or updates a connector.
-        # 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.
+        # Create or update a connector.
+        # This functionality is in Beta and is subject to change. The design and
+        # code is less mature than official GA features and is being provided
+        # as-is with no warranties. Beta features are not subject to the support
+        # SLA of official GA features.
         #
-        # @option arguments [String] :connector_id The unique identifier of the connector to be created or updated.
+        # @option arguments [String] :connector_id The unique identifier of the connector to be created or updated. ID is auto-generated if not provided.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The connector configuration.
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/create-connector-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-connector-put
         #
         def put(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'connector.put' }
@@ -51,7 +51,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_PUT
           path   = if _connector_id
-                     "_connector/#{Utils.__listify(_connector_id)}"
+                     "_connector/#{Utils.listify(_connector_id)}"
                    else
                      '_connector'
                    end

data/lib/elasticsearch/api/actions/connector/sync_job_cancel.rb

@@ -15,23 +15,25 @@
 # 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 Connector
       module Actions
-        # Cancels a connector sync job.
-        # 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.
+        # Cancel a connector sync job.
+        # Cancel a connector sync job, which sets the status to cancelling and updates +cancellation_requested_at+ to the current time.
+        # The connector service is then responsible for setting the status of connector sync jobs to cancelled.
+        # This functionality is in Beta and is subject to change. The design and
+        # code is less mature than official GA features and is being provided
+        # as-is with no warranties. Beta features are not subject to the support
+        # SLA of official GA features.
         #
-        # @option arguments [String] :connector_sync_job_id The unique identifier of the connector sync job to be canceled
+        # @option arguments [String] :connector_sync_job_id The unique identifier of the connector sync job (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/cancel-connector-sync-job-api.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-connector-sync-job-cancel
         #
         def sync_job_cancel(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'connector.sync_job_cancel' }
@@ -54,7 +56,7 @@ module Elasticsearch
           _connector_sync_job_id = arguments.delete(:connector_sync_job_id)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "_connector/_sync_job/#{Utils.__listify(_connector_sync_job_id)}/_cancel"
+          path   = "_connector/_sync_job/#{Utils.listify(_connector_sync_job_id)}/_cancel"
           params = {}
 
           Elasticsearch::API::Response.new(