[DOCS] Edit the snapshot lifecycle management summaries

Author: lcawl

specification/slm/delete_lifecycle/DeleteSnapshotLifecycleRequest.ts

@@ -21,9 +21,13 @@ import { RequestBase } from '@_types/Base'
 import { Name } from '@_types/common'
 
 /**
+ * Delete a policy.
+ * Delete a snapshot lifecycle policy definition.
+ * This operation prevents any future snapshots from being taken but does not cancel in-progress snapshots or remove previously-taken snapshots.
  * @rest_spec_name slm.delete_lifecycle
  * @availability stack since=7.4.0 stability=stable
  * @availability serverless stability=stable visibility=private
+ * @cluster_privileges manage_slm
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/slm/execute_lifecycle/ExecuteSnapshotLifecycleRequest.ts

@@ -21,9 +21,13 @@ import { RequestBase } from '@_types/Base'
 import { Name } from '@_types/common'
 
 /**
+ * Run a policy.
+ * Immediately create a snapshot according to the snapshot lifecycle policy without waiting for the scheduled time.
+ * The snapshot policy is normally applied according to its schedule, but you might want to manually run a policy before performing an upgrade or other maintenance.
  * @rest_spec_name slm.execute_lifecycle
  * @availability stack since=7.4.0 stability=stable
  * @availability serverless stability=stable visibility=private
+ * @cluster_privileges manage_slm
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/slm/execute_retention/ExecuteRetentionRequest.ts

@@ -20,8 +20,12 @@
 import { RequestBase } from '@_types/Base'
 
 /**
+ * Run retention policy.
+ * Manually apply the retention policy to force immediate removal of snapshots that are expired according to the snapshot lifecycle policy retention rules.
+ * The retention policy is normally applied according to its schedule.
  * @rest_spec_name slm.execute_retention
  * @availability stack since=7.5.0 stability=stable
  * @availability serverless stability=stable visibility=private
+ * @cluster_privileges manage_slm
  */
 export interface Request extends RequestBase {}

specification/slm/get_lifecycle/GetSnapshotLifecycleRequest.ts

@@ -21,12 +21,18 @@ import { RequestBase } from '@_types/Base'
 import { Names } from '@_types/common'
 
 /**
+ * Get snapshot lifecycle policy information.
+ * Get snapshot lifecycle policy definitions and information about the latest snapshot attempts.
  * @rest_spec_name slm.get_lifecycle
  * @availability stack since=7.4.0 stability=stable
  * @availability serverless stability=stable visibility=private
+ * @cluster_privileges manage_slm
  */
 export interface Request extends RequestBase {
   path_parts: {
+    /*
+    A comma-separate list of snapshot lifecycle policy identifiers.
+    */
     policy_id?: Names
   }
 }

specification/slm/get_stats/GetSnapshotLifecycleStatsRequest.ts

@@ -20,8 +20,11 @@
 import { RequestBase } from '@_types/Base'
 
 /**
+ * Get snapshot lifecycle statistics.
+ * Get global and policy-level statistics about actions taken by snapshot lifecycle management.
  * @rest_spec_name slm.get_stats
  * @availability stack since=7.5.0 stability=stable
  * @availability serverless stability=stable visibility=private
+ * @cluster_privileges manage_slm
  */
 export interface Request extends RequestBase {}

specification/slm/get_status/GetSnapshotLifecycleManagementStatusRequest.ts

@@ -20,8 +20,10 @@
 import { RequestBase } from '@_types/Base'
 
 /**
+ * Get the snapshot lifecycle management status.
  * @rest_spec_name slm.get_status
  * @availability stack since=7.6.0 stability=stable
  * @availability serverless stability=stable visibility=private
+ * @cluster_privileges read_slm
  */
 export interface Request extends RequestBase {}

specification/slm/put_lifecycle/PutSnapshotLifecycleRequest.ts

@@ -24,14 +24,20 @@ import { Name } from '@_types/common'
 import { Duration } from '@_types/Time'
 
 /**
+ * Create or update a policy.
+ * Create or update a snapshot lifecycle policy.
+ * If the policy already exists, this request increments the policy version.
+ * Only the latest version of a policy is stored.
  * @rest_spec_name slm.put_lifecycle
  * @availability stack since=7.4.0 stability=stable
  * @availability serverless stability=stable visibility=private
+ * @cluster_privileges manage_slm
+ * @index_privileges manage
  */
 export interface Request extends RequestBase {
   path_parts: {
     /**
-     * ID for the snapshot lifecycle policy you want to create or update.
+     * The identifier for the snapshot lifecycle policy you want to create or update.
      */
     policy_id: Name
   }

specification/slm/start/StartSnapshotLifecycleManagementRequest.ts

@@ -20,8 +20,12 @@
 import { RequestBase } from '@_types/Base'
 
 /**
+ * Start snapshot lifecycle management.
+ * Snapshot lifecycle management (SLM) starts automatically when a cluster is formed.
+ * Manually starting SLM is necessary only if it has been stopped using the stop SLM API.
  * @rest_spec_name slm.start
  * @availability stack since=7.6.0 stability=stable
  * @availability serverless stability=stable visibility=private
+ * @cluster_privileges manage_slm
  */
 export interface Request extends RequestBase {}

specification/slm/stop/StopSnapshotLifecycleManagementRequest.ts

@@ -20,6 +20,14 @@
 import { RequestBase } from '@_types/Base'
 
 /**
+ * Stop snapshot lifecycle management.
+ * Stop all snapshot lifecycle management (SLM) operations and the SLM plugin.
+ * This API is useful when you are performing maintenance on a cluster and need to prevent SLM from performing any actions on your data streams or indices.
+ * Stopping SLM does not stop any snapshots that are in progress.
+ * You can manually trigger snapshots with the run snapshot lifecycle policy API even if SLM is stopped.
+ *
+ * The API returns a response as soon as the request is acknowledged, but the plugin might continue to run until in-progress operations complete and it can be safely stopped.
+ * Use the get snapshot lifecycle management status API to see if SLM is running.
  * @rest_spec_name slm.stop
  * @availability stack since=7.6.0 stability=stable
  * @availability serverless stability=stable visibility=private