[DOCS] Add overlays for examples inapplicable to serverless (#3635) (#3638)

(cherry picked from commit 38fde2b)

Co-authored-by: Lisa Cawley <[email protected]>
Co-authored-by: Quentin Pradet <[email protected]>

Author: 3 people

docs/overlays/elasticsearch-openapi-overlays.yaml

@@ -199,6 +199,15 @@ actions:
               examples:
                 resumeFollowIndexResponseExample1:
                   $ref: "../../specification/ccr/resume_follow/examples/response/ResumeFollowIndexResponseExample1.yaml"
+## Examples for cluster
+  - target: "$.components['requestBodies']['cluster.allocation_explain']"
+    description: "Add example for cluster allocation exaplain request"
+    update:
+      content:
+        application/json:
+          examples:
+            clusterAllocationExplainRequestExample1:
+              $ref: "../../specification/cluster/allocation_explain/examples/request/ClusterAllocationExplainRequestExample1.yaml"
   - target: "$.paths['/{index}/_ccr/unfollow']['post']"
     description: "Add examples for unfollow an index"
     update: 
@@ -315,6 +324,8 @@ actions:
             examples: 
               clusterPutSettingsRequestExample1: 
                 $ref: "../../specification/cluster/put_settings/examples/request/ClusterPutSettingsRequestExample1.yaml"
+              clusterPutSettingsRequestExample2: 
+                $ref: "../../specification/cluster/put_settings/examples/request/ClusterPutSettingsRequestExample2.yaml"
   - target: "$.paths['/_cluster/reroute']['post']"
     description: "Add examples for cluster reroute operation"
     update: 

output/schema/schema.json

@@ -32,6 +32,7 @@ import { Duration } from '@_types/Time'
  * @availability stack since=5.0.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @doc_id cluster-allocation-explain
+ * @doc_tag cluster
  */
 export interface Request extends RequestBase {
   urls: [

specification/cluster/allocation_explain/ClusterAllocationExplainRequest.ts

@@ -31,6 +31,7 @@ import { Duration } from '@_types/Time'
 
 /**
  * Get the cluster health status.
+ *
  * You can also use the API to get the health status of only specified data streams and indices.
  * For data streams, the API retrieves the health status of the stream’s backing indices.
  *

specification/cluster/health/ClusterHealthRequest.ts

@@ -24,6 +24,7 @@ import { Duration } from '@_types/Time'
 
 /**
  * Update the cluster settings.
+ *
  * Configure and update dynamic settings on a running cluster.
  * You can also configure dynamic settings locally on an unstarted or shut down node in `elasticsearch.yml`.
  *