Azure AI 搜索中的 API 版本

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

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

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

已弃用的版本

2024 年 4 月 8 日弃用 2023-07-01-preview，自 2024 年 7 月 8 日起不再受支持。

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

某些 API 版本已停用，不再记录或受支持：

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

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

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

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

SDK 版本	状态	更改日志	描述
Azure.Search.Documents 11	活跃	更改日志	服务上用于数据平面操作的 API，例如对内容和对象的读写操作。
Azure.ResourceManager.Search	活跃	更改日志	用于控制平面操作的搜索服务 API。

SDK 版本	状态	更改日志	描述
azure-search-documents 11	活跃	更改日志使用 `azure-search-documents` 客户端库执行数据平面操作。
azure-resourcemanager-search 2	活跃	更改日志	使用 `azure-resourcemanager-search` 客户端库执行控制平面操作。

SDK 版本	状态	更改日志	描述
@azure/search-documents 12	活跃	更改日志	使用 `@azure/search-documents` 客户端库执行数据平面操作。
@azure/arm-search 4	活跃	更改日志	将 `@azure/arm-search` 包用于控制平面操作。

SDK 版本	状态	更改日志	描述
azure-search-documents 11	活跃	更改日志	使用 `azure-search-documents` 客户端库执行数据平面操作。
azure-mgmt-search 9	活跃	更改日志	使用 `azure-mgmt-search` 客户端库执行控制平面操作。

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