你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

重置技能 (预览版 REST API)

  • 项目

适用于：2023-07-01-Preview、2021-04-30-Preview、2020-06-30-Preview

重要

2023-07-01-Preview () 没有更改。

2021-04-30-Preview () 没有更改。

2020-06-30-Preview 添加了 API。 它支持 缓存扩充 和 重置方案。

“重置技能”请求有选择地在下次运行索引器时处理一个或多个技能。 对于启用了缓存的索引器，可以显式请求处理索引器无法检测到的技能更新。 例如，如果进行外部更改（例如对自定义技能的修订），则可以使用此 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 必需。 当前预览版本为 2023-07-01-Preview。 有关更多 版本，请参阅 API 版本。

请求标头

下表介绍必需和可选的请求标头。

字段 说明
Content-Type 必需。 将其设置为 application/json
api-key 如果使用 Azure 角色 并且请求中提供了持有者令牌，则为可选，否则需要密钥。 api-key 是系统生成的唯一字符串，用于对搜索服务的请求进行身份验证。 重置请求必须包含 api-key 设置为管理密钥 (而不是查询密钥) 的标头。 有关详细信息 ，请参阅使用密钥身份验证连接到 Azure AI 搜索 。

请求正文

请求的正文是技能名称数组。

{   
    "skillNames" : ["<SKILL-1>", "SKILL-n"]
}

响应

对于成功的响应，返回“状态代码：204 无内容”。

另请参阅