elasticsearch-api 8.18.0 → 9.0.1

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

@@ -15,20 +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 Security
       module Actions
-        # Enables a user profile so it's visible in user profile searches.
+        # Enable a user profile.
+        # Enable user profiles to make them visible in user profile searches.
+        # 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.
+        # Elastic reserves the right to change or remove this feature in future releases without prior notice.
+        # When you activate a user profile, it's automatically enabled and visible in user profile searches.
+        # If you later disable the user profile, you can use the enable user profile API to make the profile visible in these searches again.
         #
-        # @option arguments [String] :uid An unique identifier of the user profile
-        # @option arguments [String] :refresh If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` (the default) 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] :uid A unique identifier for the user profile. (*Required*)
+        # @option arguments [String] :refresh If 'true', Elasticsearch refreshes the affected shards to make this operation
+        #  visible to search.
+        #  If 'wait_for', it waits for a refresh to make this operation visible to search.
+        #  If 'false', nothing is done with refreshes. Server default: false.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-enable-user-profile.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-enable-user-profile
         #
         def enable_user_profile(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.enable_user_profile' }
@@ -43,12 +52,12 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           _uid = arguments.delete(:uid)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = "_security/profile/#{Utils.__listify(_uid)}/_enable"
+          path   = "_security/profile/#{Utils.listify(_uid)}/_enable"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

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

@@ -15,18 +15,21 @@
 # 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
-        # Allows a kibana instance to configure itself to communicate with a secured elasticsearch cluster.
+        # Enroll Kibana.
+        # Enable a Kibana instance to configure itself for communication with a secured Elasticsearch cluster.
+        # NOTE: This API is currently intended for internal use only by Kibana.
+        # Kibana uses this API internally to configure itself for communications with an Elasticsearch cluster that already has security features enabled.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-kibana-enrollment.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-enroll-kibana
         #
         def enroll_kibana(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.enroll_kibana' }
@@ -34,7 +37,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_security/enroll/kibana'

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

@@ -15,18 +15,21 @@
 # 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
-        # Allows a new node to enroll to an existing cluster with security enabled.
+        # Enroll a node.
+        # Enroll a new node to allow it to join an existing cluster with security features enabled.
+        # The response contains all the necessary information for the joining node to bootstrap discovery and security related settings so that it can successfully join the cluster.
+        # The response contains key and certificate material that allows the caller to generate valid signed certificates for the HTTP layer of all nodes in the cluster.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-node-enrollment.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-enroll-node
         #
         def enroll_node(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.enroll_node' }
@@ -34,7 +37,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_security/enroll/node'

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

@@ -15,26 +15,38 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
-# @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
-#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
 module Elasticsearch
   module API
     module Security
       module Actions
+        # Get API key information.
         # Retrieves information for one or more API keys.
+        # NOTE: If you have only the +manage_own_api_key+ privilege, this API returns only the API keys that you own.
+        # If you have +read_security+, +manage_api_key+ or greater privileges (including +manage_security+), this API returns all API keys regardless of ownership.
         #
-        # @option arguments [String] :id API key id of the API key to be retrieved
-        # @option arguments [String] :name API key name of the API key to be retrieved
-        # @option arguments [String] :username user name of the user who created this API key to be retrieved
-        # @option arguments [String] :realm_name realm name of the user who created this API key to be retrieved
-        # @option arguments [Boolean] :owner flag to query API keys owned by the currently authenticated user
-        # @option arguments [Boolean] :with_limited_by flag to show the limited-by role descriptors of API Keys
-        # @option arguments [Boolean] :with_profile_uid flag to also retrieve the API Key's owner profile uid, if it exists
-        # @option arguments [Boolean] :active_only flag to limit response to only active (not invalidated or expired) API keys
+        # @option arguments [String] :id An API key id.
+        #  This parameter cannot be used with any of +name+, +realm_name+ or +username+.
+        # @option arguments [String] :name An API key name.
+        #  This parameter cannot be used with any of +id+, +realm_name+ or +username+.
+        #  It supports prefix search with wildcard.
+        # @option arguments [Boolean] :owner A boolean flag that can be used to query API keys owned by the currently authenticated user.
+        #  The +realm_name+ or +username+ parameters cannot be specified when this parameter is set to +true+ as they are assumed to be the currently authenticated ones.
+        # @option arguments [String] :realm_name The name of an authentication realm.
+        #  This parameter cannot be used with either +id+ or +name+ or when +owner+ flag is set to +true+.
+        # @option arguments [String] :username The username of a user.
+        #  This parameter cannot be used with either +id+ or +name+ or when +owner+ flag is set to +true+.
+        # @option arguments [Boolean] :with_limited_by Return the snapshot of the owner user's role descriptors
+        #  associated with the API key. An API key's actual
+        #  permission is the intersection of its assigned role
+        #  descriptors and the owner user's role descriptors.
+        # @option arguments [Boolean] :active_only A boolean flag that can be used to query API keys that are currently active. An API key is considered active if it is neither invalidated, nor expired at query time. You can specify this together with other parameters such as +owner+ or +name+. If +active_only+ is false, the response will include both active and inactive (expired or invalidated) keys.
+        # @option arguments [Boolean] :with_profile_uid Determines whether to also retrieve the profile uid, for the API key owner principal, if it exists.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-get-api-key.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-get-api-key
         #
         def get_api_key(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.get_api_key' }
@@ -42,7 +54,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_security/api_key'

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

@@ -15,18 +15,19 @@
 # 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
-        # Retrieves the list of cluster privileges and index privileges that are available in this version of Elasticsearch.
+        # Get builtin privileges.
+        # Get the list of cluster privileges and index privileges that are available in this version of Elasticsearch.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-get-builtin-privileges.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-get-builtin-privileges
         #
         def get_builtin_privileges(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.get_builtin_privileges' }
@@ -34,7 +35,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_security/privilege/_builtin'

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

@@ -15,25 +15,31 @@
 # 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
-        # Retrieves application privileges.
+        # Get application privileges.
+        # To use this API, you must have one of the following privileges:
+        # * The +read_security+ cluster privilege (or a greater privilege such as +manage_security+ or +all+).
+        # * The "Manage Application Privileges" global privilege for the application being referenced in the request.
         #
-        # @option arguments [String] :application Application name
-        # @option arguments [String] :name Privilege name
+        # @option arguments [String] :application The name of the application.
+        #  Application privileges are always associated with exactly one application.
+        #  If you do not specify this parameter, the API returns information about all privileges for all applications.
+        # @option arguments [String, Array<String>] :name The name of the privilege.
+        #  If you do not specify this parameter, the API returns information about all privileges for the requested application.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-get-privileges.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-get-privileges
         #
         def get_privileges(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.get_privileges' }
 
-          defined_params = %i[application name].each_with_object({}) do |variable, set_variables|
+          defined_params = [:application, :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?
@@ -49,9 +55,9 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _application && _name
-                     "_security/privilege/#{Utils.__listify(_application)}/#{Utils.__listify(_name)}"
+                     "_security/privilege/#{Utils.listify(_application)}/#{Utils.listify(_name)}"
                    elsif _application
-                     "_security/privilege/#{Utils.__listify(_application)}"
+                     "_security/privilege/#{Utils.listify(_application)}"
                    else
                      '_security/privilege'
                    end

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

@@ -15,19 +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 Security
       module Actions
-        # Retrieves roles in the native realm.
+        # Get roles.
+        # Get roles in the native realm.
+        # The role management APIs are generally the preferred way to manage roles, rather than using file-based role management.
+        # The get roles API cannot retrieve roles that are defined in roles files.
         #
-        # @option arguments [List] :name A comma-separated list of role names
+        # @option arguments [String, Array<String>] :name The name of the role.
+        #  You can specify multiple roles as a comma-separated list.
+        #  If you do not specify this parameter, the API returns information about all roles.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-get-role.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-get-role
         #
         def get_role(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.get_role' }
@@ -46,14 +51,14 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _name
-                     "_security/role/#{Utils.__listify(_name)}"
+                     "_security/role/#{Utils.listify(_name)}"
                    else
                      '_security/role'
                    end
           params = Utils.process_params(arguments)
 
           if Array(arguments[:ignore]).include?(404)
-            Utils.__rescue_from_not_found do
+            Utils.rescue_from_not_found do
               Elasticsearch::API::Response.new(
                 perform_request(method, path, params, body, headers, request_opts)
               )

data/lib/elasticsearch/api/actions/security/get_role_mapping.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
-        # Retrieves role mappings.
+        # Get role mappings.
+        # Role mappings define which roles are assigned to each user.
+        # The role mapping APIs are generally the preferred way to manage role mappings rather than using role mapping files.
+        # The get role mappings API cannot retrieve role mappings that are defined in role mapping files.
         #
-        # @option arguments [List] :name A comma-separated list of role-mapping names
+        # @option arguments [String, Array<String>] :name The distinct name that identifies the role mapping. The name is used solely as an identifier to facilitate interaction via the API; it does not affect the behavior of the mapping in any way. You can specify multiple mapping names as a comma-separated list. If you do not specify this parameter, the API returns information about all role mappings.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-get-role-mapping.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-get-role-mapping
         #
         def get_role_mapping(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.get_role_mapping' }
@@ -46,7 +49,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _name
-                     "_security/role_mapping/#{Utils.__listify(_name)}"
+                     "_security/role_mapping/#{Utils.listify(_name)}"
                    else
                      '_security/role_mapping'
                    end

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

@@ -15,25 +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 Security
       module Actions
-        # Retrieves information about service accounts.
+        # Get service accounts.
+        # Get a list of service accounts that match the provided path parameters.
+        # NOTE: Currently, only the +elastic/fleet-server+ service account is available.
         #
-        # @option arguments [String] :namespace An identifier for the namespace
-        # @option arguments [String] :service An identifier for the service name
+        # @option arguments [String] :namespace The name of the namespace.
+        #  Omit this parameter to retrieve information about all service accounts.
+        #  If you omit this parameter, you must also omit the +service+ parameter.
+        # @option arguments [String] :service The service name.
+        #  Omit this parameter to retrieve information about all service accounts that belong to the specified +namespace+.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-get-service-accounts.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-get-service-accounts
         #
         def get_service_accounts(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.get_service_accounts' }
 
-          defined_params = %i[namespace service].each_with_object({}) do |variable, set_variables|
+          defined_params = [:namespace, :service].each_with_object({}) do |variable, set_variables|
             set_variables[variable] = arguments[variable] if arguments.key?(variable)
           end
           request_opts[:defined_params] = defined_params unless defined_params.empty?
@@ -49,9 +54,9 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _namespace && _service
-                     "_security/service/#{Utils.__listify(_namespace)}/#{Utils.__listify(_service)}"
+                     "_security/service/#{Utils.listify(_namespace)}/#{Utils.listify(_service)}"
                    elsif _namespace
-                     "_security/service/#{Utils.__listify(_namespace)}"
+                     "_security/service/#{Utils.listify(_namespace)}"
                    else
                      '_security/service'
                    end

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

@@ -15,25 +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 Security
       module Actions
-        # Retrieves information of all service credentials for a service account.
+        # Get service account credentials.
+        # To use this API, you must have at least the +read_security+ cluster privilege (or a greater privilege such as +manage_service_account+ or +manage_security+).
+        # The response includes service account tokens that were created with the create service account tokens API as well as file-backed tokens from all nodes of the cluster.
+        # NOTE: For tokens backed by the +service_tokens+ file, the API collects them from all nodes of the cluster.
+        # Tokens with the same name from different nodes are assumed to be the same token and are only counted once towards the total number of service tokens.
         #
-        # @option arguments [String] :namespace An identifier for the namespace
-        # @option arguments [String] :service An identifier for the service name
+        # @option arguments [String] :namespace The name of the namespace. (*Required*)
+        # @option arguments [String] :service The service name. (*Required*)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-get-service-credentials.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-get-service-credentials
         #
         def get_service_credentials(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.get_service_credentials' }
 
-          defined_params = %i[namespace service].each_with_object({}) do |variable, set_variables|
+          defined_params = [:namespace, :service].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?
@@ -51,7 +55,7 @@ module Elasticsearch
           _service = arguments.delete(:service)
 
           method = Elasticsearch::API::HTTP_GET
-          path   = "_security/service/#{Utils.__listify(_namespace)}/#{Utils.__listify(_service)}/credential"
+          path   = "_security/service/#{Utils.listify(_namespace)}/#{Utils.listify(_service)}/credential"
           params = {}
 
           Elasticsearch::API::Response.new(

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

@@ -15,19 +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 Security
       module Actions
-        # Retrieve settings for the security system indices
+        # Get security index settings.
+        # Get the user-configurable settings for the security internal index (+.security+ and associated indices).
+        # Only a subset of the index settings — those that are user-configurable—will be shown.
+        # This includes:
+        # * +index.auto_expand_replicas+
+        # * +index.number_of_replicas+
         #
-        # @option arguments [Time] :master_timeout Timeout for connection to master
+        # @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.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-get-settings.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-get-settings
         #
         def get_settings(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.get_settings' }
@@ -35,7 +41,7 @@ module Elasticsearch
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
-          body   = nil
+          body = nil
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_security/settings'

data/lib/elasticsearch/api/actions/security/get_token.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 a bearer token for access without requiring basic authentication.
+        # Get a token.
+        # Create a bearer token for access without requiring basic authentication.
+        # The tokens are created by the Elasticsearch Token Service, which is automatically enabled when you configure TLS on the HTTP interface.
+        # Alternatively, you can explicitly enable the +xpack.security.authc.token.enabled+ setting.
+        # When you are running in production mode, a bootstrap check prevents you from enabling the token service unless you also enable TLS on the HTTP interface.
+        # The get token API takes the same parameters as a typical OAuth 2.0 token API except for the use of a JSON request body.
+        # A successful get token API call returns a JSON structure that contains the access token, the amount of time (seconds) that the token expires in, the type, and the scope if available.
+        # The tokens returned by the get token API have a finite period of time for which they are valid and after that time period, they can no longer be used.
+        # That time period is defined by the +xpack.security.authc.token.timeout+ setting.
+        # If you want to invalidate a token immediately, you can do so by using the invalidate token API.
         #
         # @option arguments [Hash] :headers Custom HTTP headers
-        # @option arguments [Hash] :body The token request to get (*Required*)
+        # @option arguments [Hash] :body request body
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-get-token.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-get-token
         #
         def get_token(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.get_token' }
@@ -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/oauth2/token'

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

@@ -15,20 +15,21 @@
 # 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
-        # Retrieves information about users in the native realm and built-in users.
+        # Get users.
+        # Get information about users in the native realm and built-in users.
         #
-        # @option arguments [List] :username A comma-separated list of usernames
-        # @option arguments [Boolean] :with_profile_uid flag to retrieve profile uid (if exists) associated to the user
+        # @option arguments [Username] :username An identifier for the user. You can specify multiple usernames as a comma-separated list. If you omit this parameter, the API retrieves information about all users.
+        # @option arguments [Boolean] :with_profile_uid Determines whether to retrieve the user profile UID, if it exists, for the users.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-get-user.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-security-get-user
         #
         def get_user(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'security.get_user' }
@@ -47,14 +48,14 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = if _username
-                     "_security/user/#{Utils.__listify(_username)}"
+                     "_security/user/#{Utils.listify(_username)}"
                    else
                      '_security/user'
                    end
           params = Utils.process_params(arguments)
 
           if Array(arguments[:ignore]).include?(404)
-            Utils.__rescue_from_not_found do
+            Utils.rescue_from_not_found do
               Elasticsearch::API::Response.new(
                 perform_request(method, path, params, body, headers, request_opts)
               )