使用英语阅读

通过


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

Azure AI 搜索中的 API 版本

Azure AI 搜索会定期发布功能更新。 这些更新有时(但并非总是)需要发布 API 的新版本,以保持后向兼容性。 发布新版本使你可以控制何时以及如何在代码中集成搜索服务更新。

通常,REST API 和库只有在必要时才发布新版本,因为升级代码以使用新版 API 并非轻而易举的事情。 仅在 API 的某些方面以破坏后向兼容性的方式发生更改时,才需要新版本。 此类更改可能会因以下情况而发生:现有功能修复,或更改现有 API 外围功能的新功能。

有关弃用路径的详细信息,请参阅 Azure SDK 生命周期和支持策略

已弃用的版本

2023-07-01-preview 已于 2024 年 4 月 8 日弃用,在 2024 年 7 月 8 日之后将不受支持。

这是提供了矢量搜索支持的第一个 REST API。 较新的 API 版本具有不同的矢量配置。 应尽快迁移到较新版本

已停用的版本

某些 API 版本已停用,会被搜索服务拒绝:

  • 2015-02-28
  • 2015-02-28-Preview
  • 2014-07-31-Preview
  • 2014-10-20-Preview

所有 SDK 都基于REST API 版本。 如果 REST 版本已停用,则基于该版本的 SDK 包也会停用。 低于 3.0.0-rc 的所有 Azure AI 搜索 .NET SDK 现已过时。

已于 2020 年 10 月 15 日停止支持上述版本。 如果代码使用已终止的版本,可以将现有代码迁移到较新的 REST API 版本或较新的 Azure SDK。

REST API

REST API 链接
搜索服务(数据平面) 请参阅 REST API 参考中的 API 版本
管理(控制平面) 请参阅 REST API 参考中的 API 版本

用于 .NET 的 Azure SDK

下表提供了最新 SDK 版本的链接。

SDK 版本 状态 描述
Azure.Search.Documents 11 活动 Azure .NET SDK 团队中的新客户端库,最初于 2020 年 7 月发布。 有关次要版本的信息,请参阅更改日志
Microsoft.Azure.Search 10 已停用 2019 年 5 月发布。 这是 Microsoft.Azure.Search 包的最后一版,现已弃用。 它由 Azure.Search.Documents 继承。
Microsoft.Azure.Management.Search 4.0.0 活动 针对管理 REST api-version=2020-08-01。
Microsoft.Azure.Management.Search 3.0.0 已停用 针对管理 REST api-version=2015-08-19。

用于 Java 的 Azure SDK

SDK 版本 状态 描述
Java azure-search-documents 11 活动 使用 azure-search-documents 客户端库执行数据平面操作。
Java 管理客户端 1.35.0 活动 使用 azure-mgmt-search 客户端库执行控制平面操作。

用于 JavaScript 的 Azure SDK

SDK 版本 状态 说明
JavaScript @azure/search-documents 11.0 活动 使用 @azure/search-documents 客户端库执行数据平面操作。
JavaScript @azure/arm-search 活动 使用 @azure/arm-search 客户端库执行控制平面操作。

用于 Python 的 Azure SDK

SDK 版本 状态 描述
Python azure-search-documents 11.0 活动 使用 azure-search-documents 客户端库执行数据平面操作。
Python azure-mgmt-search 8.0 活动 使用 azure-mgmt-search 客户端库执行控制平面操作。

所有 Azure SDK

如果你正在寻找 Beta 客户端库和文档,此页面包含指向所有 Azure SDK 库包、代码和文档的链接。