elasticsearch-api 8.17.2 → 9.0.0

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(

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

@@ -15,26 +15,33 @@
 # 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 tokens from the service account token caches.
+        # Clear service account token caches.
+        # Evict a subset of all entries from the service account token caches.
+        # Two separate caches exist for service account tokens: one cache for tokens backed by the +service_tokens+ file, and another for tokens backed by the +.security+ index.
+        # This API clears matching entries from both caches.
+        # The cache for service account tokens backed by the +.security+ index is cleared automatically on state changes of the security index.
+        # The cache for tokens backed by the +service_tokens+ file is cleared automatically on file changes.
         #
-        # @option arguments [String] :namespace An identifier for the namespace
-        # @option arguments [String] :service An identifier for the service name
-        # @option arguments [List] :name A comma-separated list of service token names
+        # @option arguments [String] :namespace The namespace, which is a top-level grouping of service accounts. (*Required*)
+        # @option arguments [String] :service The name of the service, which must be unique within its namespace. (*Required*)
+        # @option arguments [String, Array<String>] :name A comma-separated list of token names to evict from the service account token caches.
+        #  Use a wildcard (+*+) to evict all tokens that belong to a service account.
+        #  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-service-token-caches.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-clear-cached-service-tokens
         #
         def clear_cached_service_tokens(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.clear_cached_service_tokens' }
 
-          defined_params = %i[namespace service name].each_with_object({}) do |variable, set_variables|
+          defined_params = [:namespace, :service, :name].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
@@ -55,7 +62,7 @@ module Elasticsearch
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_POST
-          path   = "_security/service/#{Utils.__listify(_namespace)}/#{Utils.__listify(_service)}/credential/token/#{Utils.__listify(_name)}/_clear_cache"
+          path   = "_security/service/#{Utils.listify(_namespace)}/#{Utils.listify(_service)}/credential/token/#{Utils.listify(_name)}/_clear_cache"
           params = {}
 
           Elasticsearch::API::Response.new(

data/lib/elasticsearch/api/actions/security/create_api_key.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
-        # Creates an API key for access without requiring basic authentication.
+        # Create an API key.
+        # Create an API key for access without requiring basic authentication.
+        # IMPORTANT: If the credential that is used to authenticate this request is an API key, the derived API key cannot have any privileges.
+        # If you specify privileges, the API returns an error.
+        # A successful request returns a JSON structure that contains the API key, its unique id, and its name.
+        # If applicable, it also returns expiration information for the API key in milliseconds.
+        # NOTE: By default, API keys never expire. You can specify expiration information when you create the API keys.
+        # The API keys are created by the Elasticsearch API key service, which is automatically enabled.
+        # To configure or turn off the API key service, refer to API key service setting documentation.
         #
-        # @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 api key request to create an API key (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-create-api-key.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-create-api-key
         #
         def create_api_key(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.create_api_key' }
@@ -38,7 +46,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = arguments.delete(:body)
+          body = arguments.delete(:body)
 
           method = Elasticsearch::API::HTTP_PUT
           path   = '_security/api_key'