你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
重置技能 （预览版 REST API）
适用于：2023-07-01-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 参数
| 参数 | 描述 |
|---|---|
| 服务名称 | 必填。 将此设置为搜索服务的唯一用户定义的名称。 |
| 技能集名称 | 必填。 请求 URI 指定要重置的技能集的名称。 |
| api-version | 必填。 有关更多版本，请参阅 API 版本。 |
请求标头
下表描述了必需的和可选的请求标头。
| 领域 | 描述 |
|---|---|
| Content-Type | 必填。 将此设置为 application/json |
| api-key | 如果使用 Azure 角色，并且请求中提供了持有者令牌，则为可选，否则需要密钥。 api-key 是唯一的系统生成的字符串，用于对搜索服务的请求进行身份验证。 重置请求必须包含设置为管理密钥的 api-key 标头（而不是查询密钥）。 有关详细信息，请参阅 使用密钥身份验证 连接到 Azure AI 搜索。 |
请求正文
请求的正文是技能名称的数组。
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
响应
状态代码：204 没有成功响应的内容。