From f63e93df6b594aa2fc0e4b82436fe609d7e15553 Mon Sep 17 00:00:00 2001
From: Shuyang Zhang <62564394+shuyangmsft@users.noreply.github.com>
Date: Mon, 13 Sep 2021 10:57:49 -0700
Subject: [PATCH] Add ResetSkills To SDK (#15902)

* Add ResetSkills To SDK

* Add custom words

* Address comments and fix schema

* Address comments and fix ModelValidation check

* make url aka.ms

* fix url
---
 custom-words.txt                              |  1 +
 .../examples/SearchServiceResetSkills.json    | 14 +++++
 .../2021-04-30-Preview/searchservice.json     | 63 ++++++++++++++++++-
 3 files changed, 77 insertions(+), 1 deletion(-)
 create mode 100644 specification/search/data-plane/Azure.Search/preview/2021-04-30-Preview/examples/SearchServiceResetSkills.json

diff --git a/custom-words.txt b/custom-words.txt
index 21f47057170d..222fc5a88f65 100644
--- a/custom-words.txt
+++ b/custom-words.txt
@@ -1651,6 +1651,7 @@ reservationorders
 resetapikey
 resetconnection
 resetdocs
+resetskills
 resetvpnclientsharedkey
 Resolvability
 resourcegraph
diff --git a/specification/search/data-plane/Azure.Search/preview/2021-04-30-Preview/examples/SearchServiceResetSkills.json b/specification/search/data-plane/Azure.Search/preview/2021-04-30-Preview/examples/SearchServiceResetSkills.json
new file mode 100644
index 000000000000..b301274e722b
--- /dev/null
+++ b/specification/search/data-plane/Azure.Search/preview/2021-04-30-Preview/examples/SearchServiceResetSkills.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "endpoint": "https://myservice.search.windows.net",
+    "skillsetName": "mySkillset",
+    "api-version": "2021-04-30-preview",
+    "skillNames": [
+      "skillName1",
+      "skillName2"
+    ]
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/search/data-plane/Azure.Search/preview/2021-04-30-Preview/searchservice.json b/specification/search/data-plane/Azure.Search/preview/2021-04-30-Preview/searchservice.json
index 3bad9eb9b454..25a7050aa4a9 100644
--- a/specification/search/data-plane/Azure.Search/preview/2021-04-30-Preview/searchservice.json
+++ b/specification/search/data-plane/Azure.Search/preview/2021-04-30-Preview/searchservice.json
@@ -345,7 +345,7 @@
         },
         "description": "Resets specific documents in the datasource to be selectively re-ingested by the indexer.",
         "externalDocs": {
-          "url": "N/A"
+          "url": "https://aka.ms/reset-documents"
         },
         "parameters": [
           {
@@ -1033,6 +1033,67 @@
         }
       }
     },
+    "/skillsets('{skillsetName}')/search.resetskills": {
+      "post": {
+        "tags": [
+          "Skillsets"
+        ],
+        "operationId": "Skillsets_ResetSkills",
+        "x-ms-examples": {
+          "SearchServiceResetSkills": {
+            "$ref": "./examples/SearchServiceResetSkills.json"
+          }
+        },
+        "description": "Reset an existing skillset in a search service.",
+        "externalDocs": {
+          "url": "https://aka.ms/reset-skills"
+        },
+        "parameters": [
+          {
+            "name": "skillsetName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the skillset to reset."
+          },
+          {
+            "name": "skillNames",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "properties": {
+                "skillNames": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "the names of skills to be reset."
+                }
+              }
+            },
+            "description": "The names of skills to reset."
+          },
+          {
+            "$ref": "#/parameters/ClientRequestIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "x-ms-request-id": "request-id",
+        "responses": {
+          "204": {
+            "description": "The skills in the skillset are successfully reset."
+          },
+          "default": {
+            "description": "Error response.",
+            "schema": {
+              "$ref": "#/definitions/SearchError"
+            }
+          }
+        }
+      }
+    },
     "/synonymmaps('{synonymMapName}')": {
       "put": {
         "tags": [