Update ilm examples

Author: lcawl

docs/overlays/elasticsearch-openapi-overlays.yaml

@@ -168,14 +168,14 @@ actions:
           application/json: 
             examples:
               putLifecycleRequestExample1: 
-                $ref: "../../specification/ilm/put_lifecycle/PutLifecycleRequestExample1.json"
+                $ref: "../../specification/ilm/put_lifecycle/examples/request/PutLifecycleRequestExample1.yaml"
       responses:
         200:
           content:
             application/json:
               examples:
                 putLifecycleResponseExample1:
-                  $ref: "../../specification/ilm/put_lifecycle/PutLifecycleResponseExample1.json"  
+                  $ref: "../../specification/ilm/put_lifecycle/examples/response/PutLifecycleResponseExample1.yaml"  
   - target: "$.components['responses']['ilm.get_lifecycle#200']"
     description: "Add examples for get lifecycle policy operation"
     update: 
@@ -192,14 +192,14 @@ actions:
           application/json: 
             examples: 
               migrateToDataTiersRequestExample1: 
-                $ref: "../../specification/ilm/migrate_to_data_tiers/MigrateToDataTiersRequestExample1.json"
+                $ref: "../../specification/ilm/migrate_to_data_tiers/examples/request/RequestExample1.yaml"
       responses:
         200:
           content:
             application/json:
               examples:
                 migrateToDataTiersResponseExample1:
-                  $ref: "../../specification/ilm/migrate_to_data_tiers/MigrateToDataTiersResponseExample1.json"
+                  $ref: "../../specification/ilm/migrate_to_data_tiers/examples/response/ResponseExample1.yaml"
   - target: "$.paths['/_ilm/move/{index}']['post']"
     description: "Add examples for move to lifecycle step operation"
     update:
@@ -208,14 +208,16 @@ actions:
           application/json: 
             examples:
               moveToStepRequestExample1: 
-                $ref: "../../specification/ilm/move_to_step/MoveToStepRequestExample1.json"
+                $ref: "../../specification/ilm/move_to_step/examples/request/MoveToStepRequestExample1.yaml"
+              moveToStepRequestExample2: 
+                $ref: "../../specification/ilm/move_to_step/examples/request/MoveToStepRequestExample2.yaml"
       responses:
         200:
           content:
             application/json:
               examples:
                 moveToStepResponseExample1:
-                  $ref: "../../specification/ilm/move_to_step/MoveToStepResponseExample1.json"
+                  $ref: "../../specification/ilm/move_to_step/examples/response/MoveToStepResponseExample1.yaml"
   - target: "$.paths['/_ilm/start']['post']"
     description: "Add examples for start index lifecycle management operation"
     update:

docs/overlays/elasticsearch-shared-overlays.yaml

@@ -1172,15 +1172,15 @@ actions:
           application/json: 
             examples: 
               esqlQueryRequestExample1: 
-                $ref: "../../specification/esql/query/EsqlQueryApiRequestExample1.json"
+                $ref: "../../specification/esql/query/examples/request/QueryRequestExample1.yaml"
   - target: "$.components['requestBodies']['graph.explore']"
     description: "Add example for graph explore request"
     update: 
       content:
         application/json:
           examples:
             graphExploreRequestExample1:
-              $ref: "../../specification/graph/explore/graphExploreRequestExample1.json"
+              $ref: "../../specification/graph/explore/examples/request/GraphExploreRequestExample1.yaml"
   - target: "$.paths['/{index}/_block/{block}']['put']"
     description: "Add examples for add index block operation"
     update: 

output/openapi/elasticsearch-openapi.json

@@ -0,0 +1,14 @@
+# summary:
+# method_request: POST /_query
+description: Run `POST /_query` to get results for an ES|QL query.
+# type: request
+value: |-
+  {
+    "query": """
+      FROM library
+      | EVAL year = DATE_TRUNC(1 YEARS, release_date)
+      | STATS MAX(page_count) BY year
+      | SORT year
+      | LIMIT 5
+    """
+  }

output/schema/schema.json

@@ -0,0 +1,28 @@
+# summary:
+# method_request: POST clicklogs/_graph/explore
+description: >
+  Run `POST clicklogs/_graph/explore` for a basic exploration
+  An initial graph explore query typically begins with a query to identify strongly related terms.
+  Seed the exploration with a query. This example is searching `clicklogs` for people who searched for the term `midi`.Identify the vertices to include in the graph. This example is looking for product codes that are significantly associated with searches for `midi`.
+  Find the connections. This example is looking for other search terms that led people to click on the products that are associated with searches for `midi`.
+# type: request
+value: |-
+  {
+    "query": {
+      "match": {
+        "query.raw": "midi"
+      }
+    },
+    "vertices": [
+      {
+        "field": "product"
+      }
+    ],
+    "connections": {
+      "vertices": [
+        {
+          "field": "query.raw"
+        }
+      ]
+    }
+  }

specification/esql/query/EsqlQueryApiRequestExample1.json

@@ -22,5 +22,8 @@ import { Phases } from './Phase'
 
 export class Policy {
   phases: Phases
+  /**
+   * Arbitrary metadata that is not automatically generated or used by Elasticsearch.
+   */
   _meta?: Metadata
 }