Azure AI 搜索中的 API 版本
Azure AI 搜索会定期发布功能更新。 这些更新有时（但并非总是）需要发布 API 的新版本，以保持后向兼容性。 发布新版本使你可以控制何时以及如何在代码中集成搜索服务更新。
通常，REST API 和库只有在必要时才发布新版本，因为升级代码以使用新版 API 并非轻而易举的事情。 仅在 API 的某些方面以破坏后向兼容性的方式发生更改时，才需要新版本。 此类更改可能会因以下情况而发生：现有功能修复，或更改现有 API 外围功能的新功能。
有关弃用路径的详细信息，请参阅 Azure SDK 生命周期和支持策略。
不支持的版本
某些 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 库包、代码和文档的链接。