Add simulate.ingest specification (#3400) (#3485)

(cherry picked from commit 46b99ee)

Author: lcawl

docs/overlays/elasticsearch-openapi-overlays.yaml

@@ -394,7 +394,6 @@ actions:
           examples:
             indicesLegacyPutTemplateRequestExample1:
               $ref: "../../specification/indices/put_template/indicesPutTemplateRequestExample1.yaml"
-
 ## Examples for behavioral analytics
   - target: "$.paths['/_application/analytics/{collection_name}/event/{event_type}']['post']"
     description: "Add examples for post analytics collection event operation"
@@ -416,6 +415,33 @@ actions:
               examples:
                 dataStreamLifecycleStatsResponseExample1:
                   $ref: "../../specification/indices/get_data_lifecycle_stats/examples/response/IndicesGetDataLifecycleStatsResponseExample1.yaml"
+## Examples for ingest
+  - target: "$.components['requestBodies']['simulate.ingest']"
+    description: "Add example for simulate ingest request"
+    update: 
+      content:
+        application/json:
+          examples:
+            simulateIngestRequestExample1:
+              $ref: "../../specification/simulate/ingest/examples/request/SimulateIngestRequestExample1.yaml"
+            simulateIngestRequestExample2:
+              $ref: "../../specification/simulate/ingest/examples/request/SimulateIngestRequestExample2.yaml"
+            simulateIngestRequestExample3:
+              $ref: "../../specification/simulate/ingest/examples/request/SimulateIngestRequestExample3.yaml"
+            simulateIngestRequestExample4:
+              $ref: "../../specification/simulate/ingest/examples/request/SimulateIngestRequestExample4.yaml"
+  - target: "$.components['responses']['simulate.ingest#200']"
+    description: "Add example for simulate ingest response"
+    update: 
+      content:
+        application/json:
+          examples:
+            simulateIngestResponseExample1:
+              $ref: "../../specification/simulate/ingest/examples/response/SimulateIngestResponseExample1.yaml"
+            simulateIngestResponseExample2:
+              $ref: "../../specification/simulate/ingest/examples/response/SimulateIngestResponseExample2.yaml"
+            simulateIngestResponseExample3:
+              $ref: "../../specification/simulate/ingest/examples/response/SimulateIngestResponseExample3.yaml"
 ## Examples for licensing
   - target: "$.paths['/_license/basic_status']['get']"
     description: "Add example for get basic status response"
@@ -485,7 +511,7 @@ actions:
                 $ref: "../../specification/search_application/render_query/SearchApplicationsRenderQueryRequestExample1.yaml"
                 renderSearchApplicationQueryResponseExample1:
                   $ref: "../../specification/search_application/render_query/SearchApplicationsRenderQueryResponseExample1.yaml"
-
+# Examples for security
   - target: "$.paths['/_security/api_key/_bulk_update']['post']"
     description: "Add examples for bulk update API keys operation"
     update:
@@ -540,4 +566,4 @@ actions:
               examples:
                 updateWatcherSettingsRequestExample1: 
                   $ref: "../../specification/watcher/get_settings/examples/200_response/WatcherGetSettingsResponseExample1.yaml"
-              
+              

docs/overlays/elasticsearch-shared-overlays.yaml

@@ -1292,15 +1292,15 @@ actions:
         application/json:
           examples:
             simulatePipelineRequestExample1:
-              $ref: "../../specification/ingest/simulate/SimulatePipelineRequestExample1.yaml"
+              $ref: "../../specification/ingest/simulate/examples/request/SimulatePipelineRequestExample1.yaml"
   - target: "$.components['responses']['ingest.simulate#200']"
     description: "Add example for simulate pipeline response"
     update: 
       content:
         application/json:
           examples:
             simulatePipelineResponseExample1:
-              $ref: "../../specification/ingest/simulate/SimulatePipelineResponseExample1.yaml"
+              $ref: "../../specification/ingest/simulate/examples/response/SimulatePipelineResponseExample1.yaml"
   - target: "$.components['requestBodies']['indices.put_index_template']"
     description: "Add example for create index template request"
     update: