Edit whitespace; regenerate output

lcawl · lcawl · commit 304227bbd6cc · 2024-10-22T14:39:07.000-07:00
diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json
diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json
diff --git a/output/schema/schema.json b/output/schema/schema.json
diff --git a/specification/security/get_user_profile/Request.ts b/specification/security/get_user_profile/Request.ts
@@ -22,6 +22,7 @@ import { RequestBase } from '@_types/Base'
 
 /**
  * Get a user profile.
+ *
  * Get a user's profile using the unique profile ID.
  * @rest_spec_name security.get_user_profile
  * @availability stack since=8.2.0 stability=stable
diff --git a/specification/security/grant_api_key/SecurityGrantApiKeyRequest.ts b/specification/security/grant_api_key/SecurityGrantApiKeyRequest.ts
@@ -23,6 +23,7 @@ import { ApiKeyGrantType, GrantApiKey } from './types'
 
 /**
  * Grant an API key.
+ *
  * Create an API key on behalf of another user.
  * This API is similar to the create API keys API, however it creates the API key for a user that is different than the user that runs the API.
  * The caller must have authentication credentials (either an access token, or a username and password) for the user on whose behalf the API key will be created.
diff --git a/specification/security/has_privileges/SecurityHasPrivilegesRequest.ts b/specification/security/has_privileges/SecurityHasPrivilegesRequest.ts
@@ -24,6 +24,7 @@ import { ApplicationPrivilegesCheck, IndexPrivilegesCheck } from './types'
 
 /**
  * Check user privileges.
+ *
  * Determine whether the specified user has a specified list of privileges.
  * @rest_spec_name security.has_privileges
  * @availability stack since=6.4.0 stability=stable
diff --git a/specification/security/has_privileges_user_profile/Request.ts b/specification/security/has_privileges_user_profile/Request.ts
@@ -23,6 +23,7 @@ import { PrivilegesCheck } from './types'
 
 /**
  * Check user profile privileges.
+ *
  * Determine whether the users associated with the specified user profile IDs have all the requested privileges.
  * @rest_spec_name security.has_privileges_user_profile
  * @availability stack since=8.3.0 stability=stable
diff --git a/specification/security/invalidate_api_key/SecurityInvalidateApiKeyRequest.ts b/specification/security/invalidate_api_key/SecurityInvalidateApiKeyRequest.ts
@@ -22,6 +22,7 @@ import { Id, Name, Username } from '@_types/common'
 
 /**
  * Invalidate API keys.
+ *
  * This API invalidates API keys created by the create API key or grant API key APIs.
  * Invalidated API keys fail authentication, but they can still be viewed using the get API key information and query API key information APIs, for at least the configured retention period, until they are automatically deleted.
  * The `manage_api_key` privilege allows deleting any API keys.
diff --git a/specification/security/invalidate_token/SecurityInvalidateTokenRequest.ts b/specification/security/invalidate_token/SecurityInvalidateTokenRequest.ts
@@ -22,6 +22,7 @@ import { Name, Username } from '@_types/common'
 
 /**
  * Invalidate a token.
+ *
  * The access tokens returned by the get token API have a finite period of time for which they are valid.
  * After that time period, they can no longer be used.
  * The time period is defined by the `xpack.security.authc.token.timeout` setting.
diff --git a/specification/security/put_role/SecurityPutRoleRequest.ts b/specification/security/put_role/SecurityPutRoleRequest.ts
@@ -30,8 +30,10 @@ import { Metadata, Name, Refresh } from '@_types/common'
 
 /**
  * Create or update roles.
+ *
  * The role management APIs are generally the preferred way to manage roles in the native realm, rather than using file-based role management.
  * The create or update roles API cannot update roles that are defined in roles files.
+ * File-based role management is not available in Elastic Serverless.
  * @rest_spec_name security.put_role
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
diff --git a/specification/security/put_role_mapping/SecurityPutRoleMappingRequest.ts b/specification/security/put_role_mapping/SecurityPutRoleMappingRequest.ts
@@ -24,6 +24,7 @@ import { Metadata, Name, Refresh } from '@_types/common'
 
 /**
  * Create or update role mappings.
+ *
  * Role mappings define which roles are assigned to each user.
  * Each mapping has rules that identify users and a list of roles that are granted to those users.
  * The role mapping APIs are generally the preferred way to manage role mappings rather than using role mapping files. The create or update role mappings API cannot update role mappings that are defined in role mapping files.
diff --git a/specification/security/put_user/SecurityPutUserRequest.ts b/specification/security/put_user/SecurityPutUserRequest.ts
@@ -22,6 +22,7 @@ import { Metadata, Password, Refresh, Username } from '@_types/common'
 
 /**
  * Create or update users.
+ *
  * A password is required for adding a new user but is optional when updating an existing user.
  * To change a user’s password without updating any other fields, use the change password API.
  * @rest_spec_name security.put_user
diff --git a/specification/security/query_api_keys/QueryApiKeysRequest.ts b/specification/security/query_api_keys/QueryApiKeysRequest.ts
@@ -25,6 +25,7 @@ import { ApiKeyAggregationContainer, ApiKeyQueryContainer } from './types'
 
 /**
  * Find API keys with a query.
+ *
  * Get a paginated list of API keys and their information. You can optionally filter the results with a query.
  * @rest_spec_name security.query_api_keys
  * @availability stack since=7.15.0 stability=stable
diff --git a/specification/security/query_role/QueryRolesRequest.ts b/specification/security/query_role/QueryRolesRequest.ts
@@ -24,6 +24,7 @@ import { RoleQueryContainer } from './types'
 
 /**
  * Find roles with a query.
+ *
  * Get roles in a paginated manner. You can optionally filter the results with a query.
  * @rest_spec_name security.query_role
  * @availability stack since=8.15.0 stability=stable
diff --git a/specification/security/query_user/SecurityQueryUserRequest.ts b/specification/security/query_user/SecurityQueryUserRequest.ts
@@ -24,6 +24,7 @@ import { UserQueryContainer } from './types'
 
 /**
  * Find users with a query.
+ *
  * Get information for users in a paginated manner.
  * You can optionally filter the results with a query.
  * @rest_spec_name security.query_user
diff --git a/specification/security/saml_authenticate/Request.ts b/specification/security/saml_authenticate/Request.ts
@@ -22,6 +22,7 @@ import { Ids } from '@_types/common'
 
 /**
  * Authenticate SAML.
+ *
  * Submits a SAML response message to Elasticsearch for consumption.
  * @rest_spec_name security.saml_authenticate
  * @availability stack since=7.5.0 stability=stable
diff --git a/specification/security/saml_complete_logout/Request.ts b/specification/security/saml_complete_logout/Request.ts
@@ -22,6 +22,7 @@ import { Ids } from '@_types/common'
 
 /**
  * Logout of SAML completely.
+ *
  * Verifies the logout response sent from the SAML IdP.
  * @rest_spec_name security.saml_complete_logout
  * @availability stack since=7.14.0 stability=stable
diff --git a/specification/security/saml_invalidate/Request.ts b/specification/security/saml_invalidate/Request.ts
@@ -21,6 +21,7 @@ import { RequestBase } from '@_types/Base'
 
 /**
  * Invalidate SAML.
+ *
  * Submits a SAML LogoutRequest message to Elasticsearch for consumption.
  * @rest_spec_name security.saml_invalidate
  * @availability stack since=7.5.0 stability=stable
diff --git a/specification/security/saml_logout/Request.ts b/specification/security/saml_logout/Request.ts
@@ -21,6 +21,7 @@ import { RequestBase } from '@_types/Base'
 
 /**
  * Logout of SAML.
+ *
  * Submits a request to invalidate an access token and refresh token.
  * @rest_spec_name security.saml_logout
  * @availability stack since=7.5.0 stability=stable
diff --git a/specification/security/saml_prepare_authentication/Request.ts b/specification/security/saml_prepare_authentication/Request.ts
@@ -21,6 +21,7 @@ import { RequestBase } from '@_types/Base'
 
 /**
  * Prepare SAML authentication.
+ *
  * Creates a SAML authentication request (`<AuthnRequest>`) as a URL string, based on the configuration of the respective SAML realm in Elasticsearch.
  * @rest_spec_name security.saml_prepare_authentication
  * @availability stack since=7.5.0 stability=stable
diff --git a/specification/security/saml_service_provider_metadata/Request.ts b/specification/security/saml_service_provider_metadata/Request.ts
@@ -22,6 +22,7 @@ import { Name } from '@_types/common'
 
 /**
  * Create SAML service provider metadata.
+ *
  * Generate SAML metadata for a SAML 2.0 Service Provider.
  * @rest_spec_name security.saml_service_provider_metadata
  * @availability stack since=7.11.0 stability=stable
diff --git a/specification/security/suggest_user_profiles/Request.ts b/specification/security/suggest_user_profiles/Request.ts
@@ -23,6 +23,7 @@ import { Hint } from './types'
 
 /**
  * Suggest a user profile.
+ *
  * Get suggestions for user profiles that match specified search criteria.
  * @rest_spec_name security.suggest_user_profiles
  * @availability stack since=8.2.0 stability=stable
diff --git a/specification/security/update_api_key/Request.ts b/specification/security/update_api_key/Request.ts
@@ -25,6 +25,7 @@ import { Duration } from '@_types/Time'
 
 /**
  * Update an API key.
+ *
  * Updates attributes of an existing API key.
  * Users can only update API keys that they created or that were granted to them.
  * Use this API to update API keys created by the create API Key or grant API Key APIs.
diff --git a/specification/security/update_user_profile_data/Request.ts b/specification/security/update_user_profile_data/Request.ts
@@ -26,6 +26,7 @@ import { long } from '@_types/Numeric'
 
 /**
  * Update user profile data.
+ *
  * Update specific data for the user profile that is associated with a unique ID.
  * @rest_spec_name security.update_user_profile_data
  * @availability stack since=8.2.0 stability=stable
