Add examples

Author: lcawl

docs/overlays/elasticsearch-shared-overlays.yaml

@@ -1358,9 +1358,19 @@ actions:
       content:
         application/json:
           examples:
-            searchApplicationsListResponseExample1:
-              $ref: "../../specification/search_application/list/SearchApplicationsListResponseExample1.yaml"
+            getBehavioralAnalyticsCollectionsResponseExample1:
+              $ref: "../../specification/search_application/get_behavioral_analytics/BehavioralAnalyticsGetResponseExample1.yaml"
 ## Examples for search applications
+  - target: "$.paths['/_application/search_application']['get']"
+    description: "Add examples for get search applications operation"
+    update: 
+      responses:
+        200: 
+          content: 
+            application/json: 
+              examples: 
+                getSearchApplicationsResponseExample1: 
+                  $ref: "../../specification/search_application/list/SearchApplicationsListResponseExample1.yaml"
   - target: "$.paths['/_application/search_application/{name}']['get']"
     description: "Add examples for get search application details operation"
     update: 
@@ -1369,7 +1379,7 @@ actions:
           content: 
             application/json: 
               examples: 
-                getSearchApplicationRequestExample1: 
+                getSearchApplicationResponseExample1: 
                   $ref: "../../specification/search_application/get/SearchApplicationGetResponseExample1.yaml"
   - target: "$.paths['/_application/search_application/{name}']['put']"
     description: "Add examples for create search application operation"
@@ -1380,3 +1390,11 @@ actions:
             examples: 
               putSearchApplicationRequestExample1: 
                 $ref: "../../specification/search_application/put/SearchApplicationPutRequestExample1.yaml"
+  - target: "$.components['requestBodies']['search_application.search']"
+    description: "Add example for search application search request"
+    update: 
+      content:
+        application/json:
+          examples:
+            searchApplicationSearchRequestExample1:
+              $ref: "../../specification/search_application/search/SearchApplicationsSearchRequestExample1.yaml"

specification/search_application/get_behavioral_analytics/BehavioralAnalyticsGetResponseExample1.yaml

@@ -0,0 +1,10 @@
+# summary: behavioral-analytics/apis/list-analytics-collection.asciidoc:112
+description: A successful response from `GET _application/analytics/my*`
+# type: response
+# response_code: ''
+value:
+  "{\n  \"my_analytics_collection\": {\n      \"event_data_stream\": {\n    \
+  \      \"name\": \"behavioral_analytics-events-my_analytics_collection\"\n     \
+  \ }\n  },\n  \"my_analytics_collection2\": {\n      \"event_data_stream\": {\n \
+  \         \"name\": \"behavioral_analytics-events-my_analytics_collection2\"\n \
+  \     }\n  }\n}"

specification/search_application/list/SearchApplicationsListResponseExample1.yaml

@@ -1,10 +1,8 @@
-# summary: behavioral-analytics/apis/list-analytics-collection.asciidoc:112
-description: A successful response from `GET _application/analytics/my*`
+# summary: search-application/apis/list-search-applications.asciidoc:108
+description: A succesful response from `GET _application/search_application?from=0&size=3&q=app*` returns the first three search applications whose names start with `app`.
 # type: response
 # response_code: ''
 value:
-  "{\n  \"my_analytics_collection\": {\n      \"event_data_stream\": {\n    \
-  \      \"name\": \"behavioral_analytics-events-my_analytics_collection\"\n     \
-  \ }\n  },\n  \"my_analytics_collection2\": {\n      \"event_data_stream\": {\n \
-  \         \"name\": \"behavioral_analytics-events-my_analytics_collection2\"\n \
-  \     }\n  }\n}"
+  "{\n  \"count\": 2,\n  \"results\": [\n    {\n      \"name\": \"app-1\",\n\
+  \      \"updated_at_millis\": 1690981129366\n    },\n    {\n      \"name\": \"app-2\"\
+  ,\n      \"updated_at_millis\": 1691501823939\n    }\n  ]\n}"

specification/search_application/list/SearchApplicationsListResponseExample2.yaml

@@ -1,7 +1,7 @@
-summary: search-application/apis/search-application-search.asciidoc:125
-method_request: POST _application/search_application/my-app/_search
-description: ''
-type: request
+# summary: search-application/apis/search-application-search.asciidoc:125
+# method_request: POST _application/search_application/my-app/_search
+description: Use `POST _application/search_application/my-app/_search` to run a search against a search application called `my-app` that uses a search template.
+# type: request
 value:
   "{\n  \"params\": {\n    \"query_string\": \"my first query\",\n    \"text_fields\"\
   : [\n      {\"name\": \"title\", \"boost\": 5},\n      {\"name\": \"description\"\