通过

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

管理 REST API 版本 （Azure AI 搜索）

  • 项目

本文列出了 Azure AI 搜索管理 REST API 的当前版本和过去版本。

版本控制 API 文档

REST API 文档现已进行版本控制。 打开 API 参考页时，请从下拉列表筛选器中选择 API 版本。

版本选择器的屏幕截图。

稳定版本

API 版本 规范 API 更新
2023-11-01（最新） Swagger 规范 发行说明
2022-09-01 Swagger 规范 发行说明
2020-08-01 Swagger 规范 发行说明
2020-03-13 Swagger 规范 发行说明
2015-08-19 Swagger 规范 发行说明

预览版本

预览版已发布，用于测试新功能、收集反馈以及发现和修复问题。 预览版 API 在 补充使用条款下提供，不建议用于生产工作负荷。

API 版本 规范 API 更新
2024-06-01-Preview（最新） Swagger 规范 发行说明
2024-03-01-Preview Swagger 规范 发行说明
2021-04-01-Preview Swagger 规范 发行说明
2020-08-01-Preview Swagger 规范 发行说明
2019-10-01-Preview Swagger 规范 发行说明

发行说明

2024-06-01-Preview

此预览版添加了对以下项的支持：

2024-03-01-Preview

此预览版添加了 网络安全外围的 API，尚不可用。

2023-11-01

此正式版增加了在创建或更新服务 和 更新服务中 启用或禁用语义排名 的功能。

2022-09-01

此正式版将身份验证属性添加到 创建或更新服务 和 更新服务。

此版本中正式提供启用或禁用 基于角色的访问控制 的功能。

2021-04-01-Preview

此预览 API 具有以前的预览 API 的所有功能，并添加以下功能：

  • 预览对 基于角色的访问控制的支持。 尽管此任务的支持已在 2022-09-01中正式发布，但也可以使用此预览 API 版本启用或禁用它。

  • 启用或禁用 语义搜索。 语义搜索是在标准层服务上运行的高级功能。 在此预览版管理 REST API 中，使用 创建或更新服务 禁用服务级别的语义搜索，以禁止调用语义排名的任何查询。 还可以在免费层上的搜索服务上启用此功能，以便进行少量的免费查询。

  • 通过 客户托管密钥（CMK）强制加密数据平面资源。 使用 创建或更新服务 配置此选项。 不符合此要求的现有搜索服务被标记为不符合。

  • 禁用将数据从 Azure AI 搜索推送到外部资源的工作负荷。 使用 创建或更新服务 将 properties.disabledDataExfiltrationOptions 设置为“全部”或 null（默认值）。 禁用所有工作负荷会关闭以下功能：

2020-08-01-Preview

此预览 API 等效于正式版 2020-08-01，并添加以下功能：

  • 添加了对两个新资源类型的 sharedPrivateLinkResources 支持。 新的 groupId 值包括 mysqlServer（Azure database for MySQL）和 sites（Azure Functions/应用服务）。

2020-08-01

此正式版添加了 共享专用链接资源 支持所有出站访问的资源，但预览版中指出的资源除外。

2020-03-13

此正式版添加了对通过 Azure 专用链接 专用终结点连接的支持，以及新服务的网络 IP 规则。

2019-10-01-Preview

这是第一个预览版。 此列表中没有引入预览功能。 此预览功能等效于 2020-03-13。 它仍然可用。 调用该版本的任何脚本或代码都将正常工作，但我们建议客户更新为使用较新的 API 版本（正式版或预览版 API 版本）来获取相同的结果。

2015-08-19

这是管理 REST API 的初始版本。 它提供了用于服务创建和删除、预配副本和分区以及管理 API 密钥的 API。

另请参阅