anchor.diff:  --------------------------------------------------
   // TEST[skip:we can't easily handle snapshots from docs tests]
   
  -This API will immediately return with the generated snapshot name
  +This API returns the following response with the generated snapshot name:
   
   [source,console-result]
   --------------------------------------------------
  
positive.code: --------------------------------------------------
  // TEST[continued]
  
  [[slm-api-execute-retention]]
  === Execute Snapshot Lifecycle Retention API
  
  While Snapshot Lifecycle Management retention is usually invoked through the global cluster settings
  for its schedule, it can sometimes be useful to invoke a retention run to expunge expired snapshots
  immediately. This API allows you to run a one-off retention run.
  
  ==== Example
  
  To immediately start snapshot retention, use the following
  
  [source,console]
  --------------------------------------------------
  POST /_slm/_execute_retention
  --------------------------------------------------
  
  This API will immediately return, as retention will be run asynchronously in the background:
  
  [source,console-result]
  --------------------------------------------------
  
negative.code: 
  
  [[slm-api-execute]]
  === Execute snapshot lifecycle policy API
  ++++
  <titleabbrev>Execute snapshot lifecycle policy</titleabbrev>
  ++++
  
  Executes a snapshot lifecycle policy, immediately creating a snapshot
  without waiting for the scheduled creation time.
  
  
  [[slm-api-execute-request]]
  ==== {api-request-title}
  
  `PUT /_slm/policy/<snapshot-lifecycle-policy-id>/_execute`
  
  
  [[slm-api-execute-desc]]
  ==== {api-description-title}
  
  Sometimes it can be useful to immediately execute a snapshot based on policy,
  perhaps before an upgrade or before performing other maintenance on indices. The
  execute snapshot policy API allows you to perform a snapshot immediately without
  waiting for a policy's scheduled invocation.
  
  
  [[slm-api-execute-path-params]]
  ==== {api-path-parms-title}
  
  `<snapshot-lifecycle-policy-id>`::
  (Required, string)
  ID of the snapshot lifecycle policy to execute.
  
  
  [[slm-api-execute-example]]
  ==== {api-examples-title}
  
  To take an immediate snapshot using a policy, use the following request:
  
  [source,console]
  --------------------------------------------------
  