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

Azure AI 搜索中的 API 版本

注释

Azure AI 搜索可通过Azure门户、REST API 和Azure SDK获取。它也是 Foundry IQ 的基础；Foundry IQ 是一个托管式知识层，可将企业内容转化为供 Microsoft Foundry 门户中的智能体使用的、可复用且具备权限感知能力的知识库。

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 版本已停用，不再记录或支持：

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

如果有使用已停用版本的代码，请迁移到较新的 API 版本或较新的 SDK 版本。

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

SDK 版本	状态	Changelog	说明
Azure。Search.Documents 12	活动	Changelog	用于对服务执行数据平面操作（例如对内容和对象执行读写操作）的 API。
Azure。ResourceManager.Search	活动	Changelog	用于对搜索服务执行控制平面操作的 API。

SDK 版本	状态	Changelog	说明
azure-search-documents 12	活动	Changelog	使用 `azure-search-documents` 客户端库执行数据平面操作。
azure-resourcemanager-search 2	活动	Changelog	使用 `azure-resourcemanager-search` 客户端库执行控制平面操作。

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

SDK 版本	状态	Changelog	说明
azure-search-documents 12	活动	Changelog	使用 `azure-search-documents` 客户端库执行数据平面操作。
azure-mgmt-search 9	活动	Changelog	使用 `azure-mgmt-search` 客户端库执行控制平面操作。

如果要查找 beta 客户端库和文档，此页包含指向所有Azure SDK库包、代码和文档的链接。

此页面是否有帮助？