Add SLM API examples

Author: lcawl

output/schema/schema.json

@@ -33,6 +33,7 @@ import { Duration } from '@_types/Time'
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges manage_slm
  * @index_privileges manage
+ * @doc_id slm-api-put-policy
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/slm/put_lifecycle/PutSnapshotLifecycleRequest.ts

@@ -0,0 +1,13 @@
+summary: Create a policy
+# method_request: PUT /_slm/policy/daily-snapshots
+description: >
+  Run `PUT /_slm/policy/daily-snapshots` to create a lifecycle policy.
+  The `schedule` is when the snapshot should be taken, in this case, 1:30am daily.
+  The `retention` details specify to: keep snapshots for 30 days; always keep at least 5 successful snapshots, even if they're more than 30 days old; keep no more than 50 successful snapshots, even if they're less than 30 days old.
+# type: request
+value:
+  "{\n  \"schedule\": \"0 30 1 * * ?\",\n  \"name\": \"<daily-snap-{now/d}>\"\
+  ,\n  \"repository\": \"my_repository\",\n  \"config\": {\n    \"indices\": [\"data-*\"\
+  , \"important\"],\n    \"ignore_unavailable\": false,\n    \"include_global_state\"\
+  : false\n  },\n  \"retention\": {\n    \"expire_after\": \"30d\",\n    \"min_count\"\
+  : 5,\n    \"max_count\": 50\n  }\n}"

specification/slm/put_lifecycle/examples/request/PutSnapshotLifecycleRequestExample1 copy.yaml

@@ -0,0 +1,16 @@
+summary: Create a policy with intevals
+# method_request: PUT /_slm/policy/hourly-snapshots
+description: >
+  Run `PUT /_slm/policy/hourly-snapshots` to create a lifecycle policy that uses interval scheduling.
+  It creates a snapshot once every hour.
+  The first snapshot will be created one hour after the policy is modified, with subsequent snapshots being created every hour afterward.
+# type: request
+value: |-
+  {
+    "schedule": "1h",
+    "name": "<hourly-snap-{now/d}>",
+    "repository": "my_repository",
+    "config": {
+      "indices": ["data-*", "important"]
+    }
+  }