Add aggregations external docs link and remove additionalProperties

Author: lcawl

docs/overlays/elasticsearch-shared-overlays.yaml

@@ -1067,10 +1067,13 @@ actions:
       externalDocs:
         url: https://www.elastic.co/docs/reference/elasticsearch/rest-apis/collapse-search-results
   - target: "$.components['schemas']['_global.search._types.SearchRequestBody'].properties"
-    description: Add x-model
+    description: Add x-model to SearchRequestBody aggregations property
     update:
       aggregations:
         x-model: true
+  - target: "$.components['schemas']['_global.search._types.SearchRequestBody'].properties.aggregations.additionalProperties"
+    description: Remove additionalProperties from SearchRequestBody aggregations
+    remove: true
 # Examples
 ## xCodeSamples
   - target: "$.paths['/{index}/_doc/{id}']['head']"

output/openapi/elasticsearch-openapi.json

@@ -387,7 +387,9 @@ export interface Request extends RequestBase {
   body: {
     /**
      * Defines the aggregations that are run as part of the search request.
-     * @aliases aggs */ // ES uses "aggregations" in serialization
+     * @aliases aggs
+     * @ext_doc_id search-aggregations
+     */ // ES uses "aggregations" in serialization
     aggregations?: Dictionary<string, AggregationContainer>
     /**
      * Collapses search results the values of the specified field.

output/openapi/elasticsearch-serverless-openapi.json

@@ -42,7 +42,9 @@ import { Sort, SortResults } from '@_types/sort'
 export class SearchRequestBody {
   /**
    * Defines the aggregations that are run as part of the search request.
-   * @aliases aggs */ // ES uses "aggregations" in serialization
+   * @aliases aggs
+   * @ext_doc_id search-aggregations
+   */ // ES uses "aggregations" in serialization
   aggregations?: Dictionary<string, AggregationContainer>
   /**
    * Collapses search results the values of the specified field.