elasticsearch-api 8.19.1 → 8.19.2

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Determines whether the specified user has a specified list of privileges.
+        # Check user privileges
         #
         # @option arguments [String] :user Username
         # @option arguments [Hash] :headers Custom HTTP headers

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Determines whether the users associated with the specified profile IDs have all the requested privileges.
+        # Check user profile privileges
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The privileges to check and the list of profile IDs (*Required*)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Invalidates one or more API keys.
+        # Invalidate API keys
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The api key request to invalidate API key(s) (*Required*)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Invalidates one or more access tokens or refresh tokens.
+        # Invalidate a token
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The token to invalidate (*Required*)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Exchanges an OpenID Connection authentication response message for an Elasticsearch access token and refresh token pair
+        # Authenticate OpenID Connect
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The OpenID Connect response to authenticate (*Required*)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Invalidates a refresh token and access token that was generated from the OpenID Connect Authenticate API
+        # Logout of OpenID Connect
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body Access token and refresh token to invalidate (*Required*)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Creates an OAuth 2.0 authentication request as a URL string
+        # Prepare OpenID connect authentication
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The OpenID Connect authentication realm configuration (*Required*)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Adds or updates application privileges.
+        # Create or update application privileges
         #
         # @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 [Hash] :headers Custom HTTP headers

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Adds and updates roles in the native realm.
+        # Create or update roles
         #
         # @option arguments [String] :name Role name
         # @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)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Creates and updates role mappings.
+        # Create or update role mappings
         #
         # @option arguments [String] :name Role-mapping name
         # @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)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Adds and updates users in the native realm. These users are commonly referred to as native users.
+        # Create or update users
         #
         # @option arguments [String] :username The username of the 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. (options: true, false, wait_for)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Retrieves information for API keys using a subset of query DSL
+        # Find API keys with a query
         #
         # @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

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Retrieves information for Roles using a subset of query DSL
+        # Find roles with a query
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body From, size, query, sort and search_after

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Retrieves information for Users using a subset of query DSL
+        # Find users with a query
         #
         # @option arguments [Boolean] :with_profile_uid flag to retrieve profile uid (if exists) associated with the user
         # @option arguments [Hash] :headers Custom HTTP headers

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Exchanges a SAML Response message for an Elasticsearch access token and refresh token pair
+        # Authenticate SAML
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The SAML response to authenticate (*Required*)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Verifies the logout response sent from the SAML IdP
+        # Logout of SAML completely
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The logout response to verify (*Required*)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Consumes a SAML LogoutRequest
+        # Invalidate SAML
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The LogoutRequest message (*Required*)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Invalidates an access token and a refresh token that were generated via the SAML Authenticate API
+        # Logout of SAML
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The tokens to invalidate (*Required*)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Creates a SAML authentication request
+        # Prepare SAML authentication
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The realm for which to create the authentication request, identified by either its name or the ACS URL (*Required*)

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Generates SAML metadata for the Elastic stack SAML 2.0 Service Provider
+        # Create SAML service provider metadata
         #
         # @option arguments [String] :realm_name The name of the SAML realm to get the metadata for
         # @option arguments [Hash] :headers Custom HTTP headers

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Get suggestions for user profiles that match specified search criteria.
+        # Suggest a user profile
         #
         # @option arguments [List] :data A comma-separated list of keys for which the corresponding application data are retrieved.
         # @option arguments [Hash] :headers Custom HTTP headers

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Updates attributes of an existing API key.
+        # Update an API key
         #
         # @option arguments [String] :id The ID of the API key to update
         # @option arguments [Hash] :headers Custom HTTP headers

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Updates attributes of an existing cross-cluster API key.
+        # Update a cross-cluster API key
         #
         # @option arguments [String] :id The ID of the cross-cluster API key to update
         # @option arguments [Hash] :headers Custom HTTP headers

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Update settings for the security system index
+        # Update security index settings
         #
         # @option arguments [Time] :master_timeout Timeout for connection to master
         # @option arguments [Time] :timeout Timeout for acknowledgements from all nodes

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

@@ -22,11 +22,11 @@ module Elasticsearch
   module API
     module Security
       module Actions
-        # Update application specific data for the user profile of the given unique ID.
+        # Update user profile data
         #
         # @option arguments [String] :uid An unique identifier of the user profile
-        # @option arguments [Number] :if_seq_no only perform the update operation if the last operation that has changed the document has the specified sequence number
-        # @option arguments [Number] :if_primary_term only perform the update operation if the last operation that has changed the document has the specified primary term
+        # @option arguments [Long] :if_seq_no only perform the update operation if the last operation that has changed the document has the specified sequence number
+        # @option arguments [Long] :if_primary_term only perform the update operation if the last operation that has changed the document has the specified primary term
         # @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 [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The application data to update (*Required*)

data/lib/elasticsearch/api/actions/shutdown/delete_node.rb

@@ -22,14 +22,14 @@ module Elasticsearch
   module API
     module Shutdown
       module Actions
-        # Removes a node from the shutdown list. Designed for indirect use by ECE/ESS and ECK. Direct use is not supported.
+        # Cancel node shutdown preparations
         #
         # @option arguments [String] :node_id The node id of node to be removed from the shutdown state
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
         # @option arguments [Time] :timeout Explicit operation timeout
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/delete-shutdown.html
         #
         def delete_node(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'shutdown.delete_node' }

data/lib/elasticsearch/api/actions/shutdown/get_node.rb

@@ -22,13 +22,13 @@ module Elasticsearch
   module API
     module Shutdown
       module Actions
-        # Retrieve status of a node or nodes that are currently marked as shutting down. Designed for indirect use by ECE/ESS and ECK. Direct use is not supported.
+        # Get the shutdown status
         #
         # @option arguments [String] :node_id Which node for which to retrieve the shutdown status
         # @option arguments [Time] :master_timeout Timeout for processing on master node
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/get-shutdown.html
         #
         def get_node(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'shutdown.get_node' }

data/lib/elasticsearch/api/actions/shutdown/put_node.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Shutdown
       module Actions
-        # Adds a node to be shut down. Designed for indirect use by ECE/ESS and ECK. Direct use is not supported.
+        # Prepare a node to be shut down
         #
         # @option arguments [String] :node_id The node id of node to be shut down
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
@@ -30,7 +30,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The shutdown type definition to register (*Required*)
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/put-shutdown.html
         #
         def put_node(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'shutdown.put_node' }

data/lib/elasticsearch/api/actions/simulate/ingest.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Simulate
       module Actions
-        # Simulates running ingest with example documents.
+        # Simulate data ingestion
         # 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

data/lib/elasticsearch/api/actions/snapshot/cleanup_repository.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Snapshot
       module Actions
-        # Removes stale data from repository.
+        # Clean up the snapshot repository
         #
         # @option arguments [String] :repository A repository name
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node

data/lib/elasticsearch/api/actions/snapshot/clone.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Snapshot
       module Actions
-        # Clones indices from one snapshot into another snapshot in the same repository.
+        # Clone a snapshot
         #
         # @option arguments [String] :repository A repository name
         # @option arguments [String] :snapshot The name of the snapshot to clone from
@@ -31,7 +31,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The snapshot clone definition (*Required*)
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/modules-snapshots.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/clone-snapshot-api.html
         #
         def clone(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.clone' }

data/lib/elasticsearch/api/actions/snapshot/create.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Snapshot
       module Actions
-        # Creates a snapshot in a repository.
+        # Create a snapshot
         #
         # @option arguments [String] :repository A repository name
         # @option arguments [String] :snapshot A snapshot name
@@ -31,7 +31,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The snapshot definition
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/modules-snapshots.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/create-snapshot-api.html
         #
         def create(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.create' }

data/lib/elasticsearch/api/actions/snapshot/create_repository.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Snapshot
       module Actions
-        # Creates a repository.
+        # Create or update a snapshot repository
         #
         # @option arguments [String] :repository A repository name
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
@@ -31,7 +31,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The repository definition (*Required*)
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/modules-snapshots.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/put-snapshot-repo-api.html
         #
         def create_repository(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.create_repository' }

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Snapshot
       module Actions
-        # Deletes one or more snapshots.
+        # Delete snapshots
         #
         # @option arguments [String] :repository A repository name
         # @option arguments [List] :snapshot A comma-separated list of snapshot names
@@ -30,7 +30,7 @@ module Elasticsearch
         # @option arguments [Boolean] :wait_for_completion Should this request wait until the operation has completed before returning
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/modules-snapshots.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/delete-snapshot-api.html
         #
         def delete(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.delete' }

data/lib/elasticsearch/api/actions/snapshot/delete_repository.rb

@@ -22,14 +22,14 @@ module Elasticsearch
   module API
     module Snapshot
       module Actions
-        # Deletes a repository.
+        # Delete snapshot repositories
         #
         # @option arguments [List] :repository Name of the snapshot repository to unregister. Wildcard (`*`) patterns are supported.
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
         # @option arguments [Time] :timeout Explicit operation timeout
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/modules-snapshots.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/delete-snapshot-repo-api.html
         #
         def delete_repository(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.delete_repository' }

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

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Snapshot
       module Actions
-        # Returns information about a snapshot.
+        # Get snapshot information
         #
         # @option arguments [String] :repository A repository name
         # @option arguments [List] :snapshot A comma-separated list of snapshot names
@@ -41,7 +41,7 @@ module Elasticsearch
         # @option arguments [Boolean] :verbose Whether to show verbose snapshot info or only show the basic info found in the repository index blob
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/modules-snapshots.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/get-snapshot-api.html
         #
         def get(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.get' }

data/lib/elasticsearch/api/actions/snapshot/get_repository.rb

@@ -22,14 +22,14 @@ module Elasticsearch
   module API
     module Snapshot
       module Actions
-        # Returns information about a repository.
+        # Get snapshot repository information
         #
         # @option arguments [List] :repository A comma-separated list of repository names
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
         # @option arguments [Boolean] :local Return local information, do not retrieve the state from master node (default: false)
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/modules-snapshots.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/get-snapshot-repo-api.html
         #
         def get_repository(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.get_repository' }

data/lib/elasticsearch/api/actions/snapshot/repository_analyze.rb

@@ -22,16 +22,16 @@ module Elasticsearch
   module API
     module Snapshot
       module Actions
-        # Analyzes a repository for correctness and performance
+        # Analyze a snapshot repository
         #
         # @option arguments [String] :repository A repository name
-        # @option arguments [Number] :blob_count Number of blobs to create during the test. Defaults to 100.
-        # @option arguments [Number] :concurrency Number of operations to run concurrently during the test. Defaults to 10.
-        # @option arguments [Number] :register_operation_count The minimum number of linearizable register operations to perform in total. Defaults to 10.
-        # @option arguments [Number] :read_node_count Number of nodes on which to read a blob after writing. Defaults to 10.
-        # @option arguments [Number] :early_read_node_count Number of nodes on which to perform an early read on a blob, i.e. before writing has completed. Early reads are rare actions so the 'rare_action_probability' parameter is also relevant. Defaults to 2.
-        # @option arguments [Number] :seed Seed for the random number generator used to create the test workload. Defaults to a random value.
-        # @option arguments [Number] :rare_action_probability Probability of taking a rare action such as an early read or an overwrite. Defaults to 0.02.
+        # @option arguments [Integer] :blob_count Number of blobs to create during the test. Defaults to 100.
+        # @option arguments [Integer] :concurrency Number of operations to run concurrently during the test. Defaults to 10.
+        # @option arguments [Integer] :register_operation_count The minimum number of linearizable register operations to perform in total. Defaults to 10.
+        # @option arguments [Integer] :read_node_count Number of nodes on which to read a blob after writing. Defaults to 10.
+        # @option arguments [Integer] :early_read_node_count Number of nodes on which to perform an early read on a blob, i.e. before writing has completed. Early reads are rare actions so the 'rare_action_probability' parameter is also relevant. Defaults to 2.
+        # @option arguments [Integer] :seed Seed for the random number generator used to create the test workload. Defaults to a random value.
+        # @option arguments [Double] :rare_action_probability Probability of taking a rare action such as an early read or an overwrite. Defaults to 0.02.
         # @option arguments [String] :max_blob_size Maximum size of a blob to create during the test, e.g '1gb' or '100mb'. Defaults to '10mb'.
         # @option arguments [String] :max_total_data_size Maximum total size of all blobs to create during the test, e.g '1tb' or '100gb'. Defaults to '1gb'.
         # @option arguments [Time] :timeout Explicit operation timeout. Defaults to '30s'.
@@ -39,7 +39,7 @@ module Elasticsearch
         # @option arguments [Boolean] :rarely_abort_writes Whether to rarely abort writes before they complete. Defaults to 'true'.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/modules-snapshots.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/repo-analysis-api.html
         #
         def repository_analyze(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.repository_analyze' }

data/lib/elasticsearch/api/actions/snapshot/restore.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Snapshot
       module Actions
-        # Restores a snapshot.
+        # Restore a snapshot
         #
         # @option arguments [String] :repository A repository name
         # @option arguments [String] :snapshot A snapshot name
@@ -31,7 +31,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body Details of what to restore
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/modules-snapshots.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/restore-snapshot-api.html
         #
         def restore(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.restore' }

data/lib/elasticsearch/api/actions/snapshot/status.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module Snapshot
       module Actions
-        # Returns information about the status of a snapshot.
+        # Get the snapshot status
         #
         # @option arguments [String] :repository A repository name
         # @option arguments [List] :snapshot A comma-separated list of snapshot names
@@ -30,7 +30,7 @@ module Elasticsearch
         # @option arguments [Boolean] :ignore_unavailable Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/modules-snapshots.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/get-snapshot-status-api.html
         #
         def status(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.status' }

data/lib/elasticsearch/api/actions/snapshot/verify_repository.rb

@@ -22,14 +22,14 @@ module Elasticsearch
   module API
     module Snapshot
       module Actions
-        # Verifies a repository.
+        # Verify a snapshot repository
         #
         # @option arguments [String] :repository A repository name
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
         # @option arguments [Time] :timeout Explicit operation timeout
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/modules-snapshots.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.19/verify-snapshot-repo-api.html
         #
         def verify_repository(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'snapshot.verify_repository' }

data/lib/elasticsearch/api/actions/snapshot_lifecycle_management/delete_lifecycle.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module SnapshotLifecycleManagement
       module Actions
-        # Deletes an existing snapshot lifecycle policy.
+        # Delete a policy
         #
         # @option arguments [String] :policy_id The id of the snapshot lifecycle policy to remove
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node

data/lib/elasticsearch/api/actions/snapshot_lifecycle_management/execute_lifecycle.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module SnapshotLifecycleManagement
       module Actions
-        # Immediately creates a snapshot according to the lifecycle policy, without waiting for the scheduled time.
+        # Run a policy
         #
         # @option arguments [String] :policy_id The id of the snapshot lifecycle policy to be executed
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node

data/lib/elasticsearch/api/actions/snapshot_lifecycle_management/execute_retention.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module SnapshotLifecycleManagement
       module Actions
-        # Deletes any snapshots that are expired according to the policy's retention rules.
+        # Run a retention policy
         #
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
         # @option arguments [Time] :timeout Explicit operation timeout

data/lib/elasticsearch/api/actions/snapshot_lifecycle_management/get_lifecycle.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module SnapshotLifecycleManagement
       module Actions
-        # Retrieves one or more snapshot lifecycle policy definitions and information about the latest snapshot attempts.
+        # Get policy information
         #
         # @option arguments [List] :policy_id Comma-separated list of snapshot lifecycle policies to retrieve
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node

data/lib/elasticsearch/api/actions/snapshot_lifecycle_management/get_stats.rb

@@ -22,7 +22,7 @@ module Elasticsearch
   module API
     module SnapshotLifecycleManagement
       module Actions
-        # Returns global and policy-level statistics about actions taken by snapshot lifecycle management.
+        # Get snapshot lifecycle management statistics
         #
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
         # @option arguments [Time] :timeout Explicit operation timeout