Add query to TermsLookup to support terms lookup by query feature (#1095)

* Add query to TermsLookup to support terms lookup by query feature

Signed-off-by: Kieran Pringle <contact@kieranpringle.com>

* address MR feedback

Signed-off-by: Kieran Pringle <contact@kieranpringle.com>

---------

Signed-off-by: Kieran Pringle <contact@kieranpringle.com>

Author: kieran-pringle

CHANGELOG.md

@@ -41,6 +41,7 @@ Inspired from [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 - Add title to `ml.predict_model_stream` and `ml.execute_agent_stream` requestBody ([#1072](https://github.com/opensearch-project/opensearch-api-specification/pull/1072))
 - Added `agentic` query type, `agentic_query_translator` request processor, and `agentic_context` response processor ([#1073](https://github.com/opensearch-project/opensearch-api-specification/pull/1073))
 - Added `allow_no_indices`, `ignore_unavailable`, and `ignore_throttled` query parameters to `create_pit` ([#1141](https://github.com/opensearch-project/opensearch-api-specification/pull/1141))
+- Added `query` to TermsLookup to support terms lookup by query
 
 ### Deprecated
 - Marked the plural `_aliases` URL forms of `put_alias` and `delete_alias` as deprecated; the singular `_alias` form is the canonical path ([#1131](https://github.com/opensearch-project/opensearch-api-specification/pull/1131))

spec/schemas/_common.query_dsl.yaml

@@ -2166,12 +2166,29 @@ components:
           $ref: '_common.yaml#/components/schemas/Field'
         routing:
           $ref: '_common.yaml#/components/schemas/Routing'
+        query:
+          $ref: '#/components/schemas/QueryContainer'
+          x-version-added: 3.2.0
         store:
           type: boolean
       required:
-        - id
         - index
         - path
+      allOf:
+        - oneOf:
+            - type: object
+              properties:
+                id:
+                  $ref: '_common.yaml#/components/schemas/Id'
+              required:
+                - id
+            - type: object
+              properties:
+                query:
+                  $ref: '#/components/schemas/QueryContainer'
+              required:
+                - query
+              x-version-added: 3.2.0
     TermsSetQuery:
       allOf:
         - $ref: '#/components/schemas/QueryBase'