Azure AI 搜索会定期发布功能更新。 这些更新有时（但并非总是）需要发布 API 的新版本，以保持后向兼容性。 发布新版本使你可以控制何时以及如何在代码中集成搜索服务更新。
作为一种规则，REST API 和Azure SDK客户端库仅在必要时进行版本控制，因为它可能涉及升级代码以使用新的 API 版本。 仅在 API 的某些方面以破坏后向兼容性的方式发生更改时，才需要新版本。 此类更改可能由于修复现有功能或新增功能改变现有 API 表面区域而发生。
有关弃用路径的详细信息，请参阅 Azure SDK 生命周期和支持策略。
已弃用的版本
2024 年 4 月 8 日弃用 2023-07-01-preview，自 2024 年 7 月 8 日起不再受支持。 此版本是第一个提供矢量搜索支持的 REST API。 较新的 API 版本具有不同的矢量配置。 尽快迁移到较新的 API 版本或较新的 SDK 版本。
已停用的版本
自 2020 年 10 月 15 日起，以下 API 版本已停用，不再记录或支持：
- 2015-02-28
- 2015-02-28-Preview
- 2014-07-31-Preview
- 2014-10-20-Preview
所有 SDK 都基于REST API 版本。 如果 REST API 版本已停止，则基于它的 SDK 包也会停止使用。 低于 3.0.0-rc 的所有 Azure AI 搜索 .NET SDK 现已过时。
如果有使用已停用版本的代码， 请迁移到较新的 API 版本 或较新的 SDK 版本。
REST API
| REST API | 链接 |
|---|---|
| 搜索服务（数据平面） | 请参阅 REST API 参考中的 API 版本 。 |
| 搜索管理（控制平面） | 请参阅 REST API 参考中的 API 版本 。 |
用于 .NET 的 Azure SDK
| SDK 版本 | 状态 | Changelog | 描述 |
|---|---|---|---|
| Azure。Search.Documents 12 | 活跃 | Changelog | 服务上用于数据平面操作的 API，例如对内容和对象的读写操作。 |
| Azure.ResourceManager.Search | 活跃 | Changelog | 用于控制平面操作的搜索服务 API。 |
用于 Java 的 Azure SDK
| SDK 版本 | 状态 | Changelog | 描述 |
|---|---|---|---|
| azure-search-documents 12 | 活跃 | Changelog | 使用 azure-search-documents 客户端库执行数据平面操作。 |
| azure-resourcemanager-search 2 | 活跃 | Changelog | 使用 azure-resourcemanager-search 客户端库执行控制平面操作。 |
用于 JavaScript 的 Azure SDK
| SDK 版本 | 状态 | Changelog | 描述 |
|---|---|---|---|
| @azure/search-documents 13 | 活跃 | Changelog | 使用 @azure/search-documents 客户端库执行数据平面操作。 |
| @azure/arm-search 4 | 活跃 | Changelog | 将 @azure/arm-search 包用于控制平面操作。 |
用于 Python 的 Azure SDK
| SDK 版本 | 状态 | Changelog | 描述 |
|---|---|---|---|
| azure-search-documents 12 | 活跃 | Changelog | 使用 azure-search-documents 客户端库执行数据平面操作。 |
| azure-mgmt-search 9 | 活跃 | Changelog | 使用 azure-mgmt-search 客户端库执行控制平面操作。 |
所有 Azure SDK
如果你正在寻找 Beta 客户端库和文档，此页面包含指向所有 Azure SDK 库包、代码和文档的链接。