elasticsearch-api 8.18.0 → 9.0.1

data/lib/elasticsearch/api/actions/searchable_snapshots/cache_stats.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 SearchableSnapshots
       module Actions
-        # Retrieve node-level cache statistics about searchable snapshots.
+        # Get cache statistics.
+        # Get statistics about the shared cache for partially mounted indices.
         # 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 [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 [String, Array] :node_id The names of the nodes in the cluster to target.
+        # @option arguments [Time] :master_timeout [TODO]
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/searchable-snapshots-apis.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-searchable-snapshots-cache-stats
         #
         def cache_stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'searchable_snapshots.cache_stats' }
@@ -50,11 +52,11 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _node_id
-                     "_searchable_snapshots/#{Utils.__listify(_node_id)}/cache/stats"
+                     "_searchable_snapshots/#{Utils.listify(_node_id)}/cache/stats"
                    else
                      '_searchable_snapshots/cache/stats'
                    end
-          params = {}
+          params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(
             perform_request(method, path, params, body, headers, request_opts)

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

@@ -15,26 +15,28 @@
 # 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 SearchableSnapshots
       module Actions
-        # Clear the cache of searchable snapshots.
+        # Clear the cache.
+        # Clear indices and data streams from the shared cache for partially mounted indices.
         # 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 [List] :index A comma-separated list of index names
+        # @option arguments [String, Array] :index A comma-separated list of data streams, indices, and aliases to clear from the cache.
+        #  It supports wildcards (+*+).
+        # @option arguments [String, Array<String>] :expand_wildcards Whether to expand wildcard expression to concrete indices that are open, closed or both.
+        # @option arguments [Boolean] :allow_no_indices Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes +_all+ string or when no indices have been specified)
         # @option arguments [Boolean] :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, none, all)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/searchable-snapshots-apis.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-searchable-snapshots-clear-cache
         #
         def clear_cache(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'searchable_snapshots.clear_cache' }
@@ -47,13 +49,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)}/_searchable_snapshots/cache/clear"
+                     "#{Utils.listify(_index)}/_searchable_snapshots/cache/clear"
                    else
                      '_searchable_snapshots/cache/clear'
                    end

data/lib/elasticsearch/api/actions/searchable_snapshots/mount.rb

@@ -15,29 +15,34 @@
 # 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 SearchableSnapshots
       module Actions
-        # Mount a snapshot as a searchable index.
+        # Mount a snapshot.
+        # Mount a snapshot as a searchable snapshot index.
+        # Do not use this API for snapshots managed by index lifecycle management (ILM).
+        # Manually mounting ILM-managed snapshots can interfere with ILM processes.
         #
-        # @option arguments [String] :repository The name of the repository containing the snapshot of the index to mount
-        # @option arguments [String] :snapshot The name of the snapshot of the index to mount
-        # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
-        # @option arguments [Boolean] :wait_for_completion Should this request wait until the operation has completed before returning
-        # @option arguments [String] :storage Selects the kind of local storage used to accelerate searches. Experimental, and defaults to `full_copy`
+        # @option arguments [String] :repository The name of the repository containing the snapshot of the index to mount. (*Required*)
+        # @option arguments [String] :snapshot The name of the snapshot of the index to mount. (*Required*)
+        # @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.
+        #  To indicate that the request should never timeout, set it to +-1+. Server default: 30s.
+        # @option arguments [Boolean] :wait_for_completion If true, the request blocks until the operation is complete.
+        # @option arguments [String] :storage The mount option for the searchable snapshot index. Server default: full_copy.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The restore configuration for mounting the snapshot as searchable (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/searchable-snapshots-api-mount-snapshot.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-searchable-snapshots-mount
         #
         def mount(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'searchable_snapshots.mount' }
 
-          defined_params = %i[repository snapshot].each_with_object({}) do |variable, set_variables|
+          defined_params = [:repository, :snapshot].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?
@@ -56,7 +61,7 @@ module Elasticsearch
           _snapshot = arguments.delete(:snapshot)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_snapshot/#{Utils.__listify(_repository)}/#{Utils.__listify(_snapshot)}/_mount"
+          path   = "_snapshot/#{Utils.listify(_repository)}/#{Utils.listify(_snapshot)}/_mount"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,20 +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 SearchableSnapshots
       module Actions
-        # Retrieve shard-level statistics about searchable snapshots.
+        # Get searchable snapshot statistics.
         #
-        # @option arguments [List] :index A comma-separated list of index names
-        # @option arguments [String] :level Return stats aggregated at cluster, index or shard level (options: cluster, indices, shards)
+        # @option arguments [String, Array] :index A comma-separated list of data streams and indices to retrieve statistics for.
+        # @option arguments [String] :level Return stats aggregated at cluster, index or shard level
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/searchable-snapshots-apis.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-searchable-snapshots-stats
         #
         def stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'searchable_snapshots.stats' }
@@ -41,13 +41,13 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           _index = arguments.delete(:index)
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _index
-                     "#{Utils.__listify(_index)}/_searchable_snapshots/stats"
+                     "#{Utils.listify(_index)}/_searchable_snapshots/stats"
                    else
                      '_searchable_snapshots/stats'
                    end

data/lib/elasticsearch/api/actions/security/activate_user_profile.rb

@@ -15,19 +15,28 @@
 # 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 Security
       module Actions
-        # Creates or updates the user profile on behalf of another user.
+        # Activate a user profile.
+        # Create or update a user profile on behalf of another user.
+        # NOTE: The user profile feature is designed only for use by Kibana and Elastic's Observability, Enterprise Search, and Elastic Security solutions.
+        # Individual users and external applications should not call this API directly.
+        # The calling application must have either an +access_token+ or a combination of +username+ and +password+ for the user that the profile document is intended for.
+        # Elastic reserves the right to change or remove this feature in future releases without prior notice.
+        # This API creates or updates a profile document for end users with information that is extracted from the user's authentication object including +username+, +full_name,+ +roles+, and the authentication realm.
+        # For example, in the JWT +access_token+ case, the profile user's +username+ is extracted from the JWT token claim pointed to by the +claims.principal+ setting of the JWT realm that authenticated the token.
+        # When updating a profile document, the API enables the document if it was disabled.
+        # Any updates do not change existing content for either the +labels+ or +data+ fields.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The grant type and user's credential (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-activate-user-profile.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-activate-user-profile
         #
         def activate_user_profile(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.activate_user_profile' }
@@ -37,7 +46,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_security/profile/_activate'

data/lib/elasticsearch/api/actions/security/authenticate.rb

@@ -15,18 +15,22 @@
 # 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 Security
       module Actions
-        # Enables authentication as a user and retrieve information about the authenticated user.
+        # Authenticate a user.
+        # Authenticates a user and returns information about the authenticated user.
+        # Include the user information in a {https://en.wikipedia.org/wiki/Basic_access_authentication basic auth header}.
+        # A successful call returns a JSON structure that shows user information such as their username, the roles that are assigned to the user, any assigned metadata, and information about the realms that authenticated and authorized the user.
+        # If the user cannot be authenticated, this API returns a 401 status code.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-authenticate.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-authenticate
         #
         def authenticate(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.authenticate' }
@@ -34,7 +38,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_security/_authenticate'

data/lib/elasticsearch/api/actions/security/bulk_delete_role.rb

@@ -15,20 +15,22 @@
 # 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 Security
       module Actions
-        # Bulk delete roles in the native realm.
+        # Bulk delete roles.
+        # The role management APIs are generally the preferred way to manage roles, rather than using file-based role management.
+        # The bulk delete roles API cannot delete roles that are defined in roles files.
         #
-        # @option arguments [String] :refresh If `true` (the default) then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` then do nothing with refreshes. (options: true, false, wait_for)
+        # @option arguments [String] :refresh If +true+ (the default) then refresh the affected shards to make this operation visible to search, if +wait_for+ then wait for a refresh to make this operation visible to search, if +false+ then do nothing with refreshes.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The roles to delete (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-bulk-delete-role.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-bulk-delete-role
         #
         def bulk_delete_role(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.bulk_delete_role' }
@@ -38,7 +40,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           method = Elasticsearch::API::HTTP_DELETE
           path   = '_security/role'

data/lib/elasticsearch/api/actions/security/bulk_put_role.rb

@@ -15,20 +15,22 @@
 # 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 Security
       module Actions
-        # Bulk adds and updates roles in the native realm.
+        # Bulk create or update roles.
+        # The role management APIs are generally the preferred way to manage roles, rather than using file-based role management.
+        # The bulk create or update roles API cannot update roles that are defined in roles files.
         #
-        # @option arguments [String] :refresh If `true` (the default) then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` then do nothing with refreshes. (options: true, false, wait_for)
+        # @option arguments [String] :refresh If +true+ (the default) then refresh the affected shards to make this operation visible to search, if +wait_for+ then wait for a refresh to make this operation visible to search, if +false+ then do nothing with refreshes.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The roles to add (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-bulk-put-role.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-bulk-put-role
         #
         def bulk_put_role(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.bulk_put_role' }
@@ -38,7 +40,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_security/role'

data/lib/elasticsearch/api/actions/security/bulk_update_api_keys.rb

@@ -15,19 +15,28 @@
 # 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 Security
       module Actions
-        # Updates the attributes of multiple existing API keys.
+        # Bulk update API keys.
+        # Update the attributes for multiple API keys.
+        # IMPORTANT: It is not possible to use an API key as the authentication credential for this API. To update API keys, the owner user's credentials are required.
+        # This API is similar to the update API key API but enables you to apply the same update to multiple API keys in one API call. This operation can greatly improve performance over making individual updates.
+        # It is not possible to update expired or invalidated API keys.
+        # This API supports updates to API key access scope, metadata and expiration.
+        # The access scope of each API key is derived from the +role_descriptors+ you specify in the request and a snapshot of the owner user's permissions at the time of the request.
+        # The snapshot of the owner's permissions is updated automatically on every call.
+        # IMPORTANT: If you don't specify +role_descriptors+ in the request, a call to this API might still change an API key's access scope. This change can occur if the owner user's permissions have changed since the API key was created or last modified.
+        # A successful request returns a JSON structure that contains the IDs of all updated API keys, the IDs of API keys that already had the requested changes and did not require an update, and error details for any failed update.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The API key request to update the attributes of multiple API keys. (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-bulk-update-api-keys.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-bulk-update-api-keys
         #
         def bulk_update_api_keys(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.bulk_update_api_keys' }
@@ -37,7 +46,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           method = Elasticsearch::API::HTTP_POST
           path   = '_security/api_key/_bulk_update'

data/lib/elasticsearch/api/actions/security/change_password.rb

@@ -15,21 +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 Security
       module Actions
-        # Changes the passwords of users in the native realm and built-in users.
+        # Change passwords.
+        # Change the passwords of users in the native realm and built-in users.
         #
-        # @option arguments [String] :username The username of the user to change the password for
-        # @option arguments [String] :refresh If `true` (the default) then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` then do nothing with refreshes. (options: true, false, wait_for)
+        # @option arguments [String] :username The user whose password you want to change. If you do not specify this
+        #  parameter, the password is changed for the current user.
+        # @option arguments [String] :refresh If +true+ (the default) then refresh the affected shards to make this operation visible to search, if +wait_for+ then wait for a refresh to make this operation visible to search, if +false+ then do nothing with refreshes.
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body the new password for the user (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-change-password.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-change-password
         #
         def change_password(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.change_password' }
@@ -50,7 +52,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_PUT
           path   = if _username
-                     "_security/user/#{Utils.__listify(_username)}/_password"
+                     "_security/user/#{Utils.listify(_username)}/_password"
                    else
                      '_security/user/_password'
                    end

data/lib/elasticsearch/api/actions/security/clear_api_key_cache.rb

@@ -15,19 +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 Security
       module Actions
-        # Clear a subset or all entries from the API key cache.
+        # Clear the API key cache.
+        # Evict a subset of all entries from the API key cache.
+        # The cache is also automatically cleared on state changes of the security index.
         #
-        # @option arguments [List] :ids A comma-separated list of IDs of API keys to clear from the cache
+        # @option arguments [String, Array] :ids Comma-separated list of API key IDs to evict from the API key cache.
+        #  To evict all API keys, use +*+.
+        #  Does not support other wildcard patterns. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-clear-api-key-cache.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-clear-api-key-cache
         #
         def clear_api_key_cache(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.clear_api_key_cache' }
@@ -42,12 +46,12 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           _ids = arguments.delete(:ids)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_security/api_key/#{Utils.__listify(_ids)}/_clear_cache"
+          path   = "_security/api_key/#{Utils.listify(_ids)}/_clear_cache"
           params = {}
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/security/clear_cached_privileges.rb

@@ -15,19 +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 Security
       module Actions
-        # Evicts application privileges from the native application privileges cache.
+        # Clear the privileges cache.
+        # Evict privileges from the native application privilege cache.
+        # The cache is also automatically cleared for applications that have their privileges updated.
         #
-        # @option arguments [List] :application A comma-separated list of application names
+        # @option arguments [String] :application A comma-separated list of applications.
+        #  To clear all applications, use an asterism (+*+).
+        #  It does not support other wildcard patterns. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-clear-privilege-cache.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-clear-cached-privileges
         #
         def clear_cached_privileges(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.clear_cached_privileges' }
@@ -47,7 +51,7 @@ module Elasticsearch
           _application = arguments.delete(:application)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_security/privilege/#{Utils.__listify(_application)}/_clear_cache"
+          path   = "_security/privilege/#{Utils.listify(_application)}/_clear_cache"
           params = {}
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/security/clear_cached_realms.rb

@@ -15,20 +15,28 @@
 # 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 Security
       module Actions
-        # Evicts users from the user cache. Can completely clear the cache or evict specific users.
+        # Clear the user cache.
+        # Evict users from the user cache.
+        # You can completely clear the cache or evict specific users.
+        # User credentials are cached in memory on each node to avoid connecting to a remote authentication service or hitting the disk for every incoming request.
+        # There are realm settings that you can use to configure the user cache.
+        # For more information, refer to the documentation about controlling the user cache.
         #
-        # @option arguments [List] :realms Comma-separated list of realms to clear
-        # @option arguments [List] :usernames Comma-separated list of usernames to clear from the cache
+        # @option arguments [String, Array<String>] :realms A comma-separated list of realms.
+        #  To clear all realms, use an asterisk (+*+).
+        #  It does not support other wildcard patterns. (*Required*)
+        # @option arguments [Array<String>] :usernames A comma-separated list of the users to clear from the cache.
+        #  If you do not specify this parameter, the API evicts all users from the user cache.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-clear-cache.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-clear-cached-realms
         #
         def clear_cached_realms(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.clear_cached_realms' }
@@ -48,7 +56,7 @@ module Elasticsearch
           _realms = arguments.delete(:realms)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_security/realm/#{Utils.__listify(_realms)}/_clear_cache"
+          path   = "_security/realm/#{Utils.listify(_realms)}/_clear_cache"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/security/clear_cached_roles.rb

@@ -15,19 +15,22 @@
 # 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 Security
       module Actions
-        # Evicts roles from the native role cache.
+        # Clear the roles cache.
+        # Evict roles from the native role cache.
         #
-        # @option arguments [List] :name Role name
+        # @option arguments [String, Array<String>] :name A comma-separated list of roles to evict from the role cache.
+        #  To evict all roles, use an asterisk (+*+).
+        #  It does not support other wildcard patterns. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-clear-role-cache.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-clear-cached-roles
         #
         def clear_cached_roles(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.clear_cached_roles' }
@@ -47,7 +50,7 @@ module Elasticsearch
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_security/role/#{Utils.__listify(_name)}/_clear_cache"
+          path   = "_security/role/#{Utils.listify(_name)}/_clear_cache"
           params = {}
 
           Elasticsearch::API::Response.new(