Release search azure.search preview: 2024-11-01-preview (#30485)

* Copy over old spec into new folder

* Update version to 11-01

* Initial feature spec changes

* Additional Feature Changes and Examples

* Swagger Prettier Check

* Swagger Lint

* Fix order of semanticQuery Parameter

* Apply feedback

* Add back defaultoversampling and rerankWithOriginalVectors

* Semantic query order

* Spellcheck CI

* swagger prettier CI

* Make the QueryRewrites List of List of strings into a List of objects which contain a list of string

---------

Co-authored-by: Jonathan Serbent <jserbent@microsoft.com>

Author: jonathanserbent

cSpell.json

@@ -1239,7 +1239,12 @@
                 "vectorizing",
                 "onelake",
                 "tiktoken",
-                "Matryoshka"
+                "Matryoshka",
+                "rescore",
+                "rescoring",
+                "rescored",
+                "maxcharlength",
+                "submode"
             ]
         },
         {

specification/search/data-plane/Azure.Search/preview/2024-11-01-preview/examples/SearchIndexAutocompleteDocumentsGet.json

@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "endpoint": "https://myservice.search.windows.net",
+    "indexName": "myindex",
+    "api-version": "2024-11-01-preview",
+    "autocompleteMode": "oneTerm",
+    "search": "washington medic",
+    "suggesterName": "sg",
+    "filter": "search.in(docId,'101,102,105')",
+    "fuzzy": false,
+    "highlightPostTag": "</em>",
+    "highlightPreTag": "<em>",
+    "minimumCoverage": 80,
+    "searchFields": [
+      "title",
+      "description"
+    ],
+    "top": 10
+  },
+  "responses": {
+    "200": {
+      "body": [
+        {
+          "text": "medicaid",
+          "queryPlusText": "washington medicaid"
+        },
+        {
+          "text": "medicare",
+          "queryPlusText": "washington medicare"
+        },
+        {
+          "text": "medicine",
+          "queryPlusText": "washington medicine"
+        }
+      ]
+    }
+  }
+}

specification/search/data-plane/Azure.Search/preview/2024-11-01-preview/examples/SearchIndexAutocompleteDocumentsPost.json

@@ -0,0 +1,38 @@
+{
+  "operationId": "Documents_AutocompletePost",
+  "title": "SearchIndexAutocompleteDocumentsPost",
+  "parameters": {
+    "endpoint": "https://previewexampleservice.search.windows.net",
+    "indexName": "preview-test",
+    "api-version": "2024-11-01-preview",
+    "x-ms-client-request-id": "00000000-0000-0000-0000-000000000000",
+    "autocompleteRequest": {
+      "search": "p",
+      "autocompleteMode": "oneTerm",
+      "filter": "ownerId ne '1'",
+      "highlightPostTag": "</em>",
+      "highlightPreTag": "<em>",
+      "minimumCoverage": 80,
+      "searchFields": "category, ownerId",
+      "suggesterName": "sg",
+      "top": 10
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "@search.coverage": 100.0,
+        "value": [
+          {
+            "text": "purple",
+            "queryPlusText": "<em>purple</em>"
+          },
+          {
+            "text": "pink",
+            "queryPlusText": "<em>pink</em>"
+          }
+        ]
+      }
+    }
+  }
+}

specification/search/data-plane/Azure.Search/preview/2024-11-01-preview/examples/SearchIndexCountDocuments.json

@@ -0,0 +1,15 @@
+{
+  "operationId": "Documents_Count",
+  "title": "SearchIndexCountDocuments",
+  "parameters": {
+    "endpoint": "https://previewexampleservice.search.windows.net",
+    "indexName": "preview-test",
+    "api-version": "2024-11-01-preview",
+    "x-ms-client-request-id": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "200": {
+      "body": 50
+    }
+  }
+}

specification/search/data-plane/Azure.Search/preview/2024-11-01-preview/examples/SearchIndexGetDocument.json

@@ -0,0 +1,29 @@
+{
+  "operationId": "Documents_Get",
+  "title": "SearchIndexGetDocument",
+  "parameters": {
+    "endpoint": "https://previewexampleservice.search.windows.net",
+    "indexName": "preview-test",
+    "key": "1",
+    "$select": [
+      "id",
+      "description",
+      "name",
+      "category",
+      "ownerId"
+    ],
+    "api-version": "2024-11-01-preview",
+    "x-ms-client-request-id": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "1",
+        "name": "test",
+        "description": "test1 hello",
+        "category": "purple",
+        "ownerId": "sam"
+      }
+    }
+  }
+}