重設技能 (預覽 REST API)
適用于：2023-07-01-Preview、2021-04-30-Preview、2020-06-30-Preview
重要
2023-07-01-Preview (沒有變更) 。
2021-04-30-Preview (沒有變更) 。
重 設技能 要求會選擇性地處理下一個索引子執行的一或多個技能。 對於已啟用快取的索引子，您可以明確要求處理索引子無法偵測到的技能更新。 例如，如果您進行外部變更，例如自訂技能的修訂，您可以使用此 API 來重新執行技能。 輸出，例如知識存放區或搜尋索引，會使用快取中可重複使用的資料和每個更新技能的新內容來重新整理。
您可以使用 HTTP POST 重設現有的 技能集 ，並指定要在要求 URI 上更新的技能集名稱。
POST https://[servicename].search.windows.net/skillsets/[skillset name]/resetskills?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
URI 參數
| 參數 | Description |
|---|---|
| 服務名稱 | 必要。 將此設定為搜尋服務的唯一使用者定義名稱。 |
| 技能集名稱 | 必要。 要求 URI 指定要重設的技能集名稱。 |
| api-version | 必要。 目前的預覽版本為 2023-07-01-Preview 。 如需更多版本，請參閱 API 版本 。 |
要求標頭
下表說明必要及選用的要求標頭。
| 欄位 | Description |
|---|---|
| Content-Type | 必要。 請設為 application/json |
| api-key | 如果您使用 Azure 角色 ，並在要求上提供持有人權杖，則為選擇性，否則需要金鑰。 API 金鑰是唯一的系統產生字串，可驗證對搜尋服務的要求。 重設要求必須包含 api-key 設定為系統管理員金鑰的標頭 (，而不是查詢金鑰) 。 如需詳細資訊，請參閱 使用金鑰驗證連線到 Azure AI 搜尋 服務。 |
要求本文
要求的本文是技能名稱的陣列。
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
回應
狀態碼：回應成功時會傳回「204 沒有內容」。