你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
本文列出了 Azure AI 搜索管理 REST API 的当前版本和过去版本。
版本控制 API 文档
REST API 文档已版本控制。 打开 API 参考页时，请从下拉列表筛选器中选择 API 版本。
稳定版本
| API 版本 | Specification | API 更新 |
|---|---|---|
2025-05-01（最新） |
招摇规格 | 发行说明 |
2023-11-01 |
招摇规格 | 发行说明 |
2022-09-01 |
招摇规格 | 发行说明 |
2020-08-01 |
招摇规格 | 发行说明 |
2020-03-13 |
招摇规格 | 发行说明 |
2015-08-19 |
招摇规格 | 发行说明 |
预览版本
预览版已发布，用于测试新功能、收集反馈以及发现和修复问题。 预览版 API 根据 补充使用条款 提供，不建议用于生产工作负载。
| API 版本 | Specification | API 更新 |
|---|---|---|
2025-02-01-Preview（最新） |
招摇规格 | 发行说明 |
2024-06-01-Preview |
招摇规格 | 发行说明 |
2024-03-01-Preview |
招摇规格 | 发行说明 |
2021-04-01-Preview |
招摇规格 | 发行说明 |
2020-08-01-Preview |
招摇规格 | 发行说明 |
2019-10-01-Preview |
招摇规格 | 发行说明 |
发行说明
2025-05-01
此正式发布版本进行了以下更新：
| Update | REST API |
|---|---|
| 促进 将搜索服务 从预览版升级到正式发布。 | 升级服务 |
| 促进 将定价层 从预览版更改为正式版。 |
更新服务 （sku 属性） |
| 将 用户分配的托管标识与搜索服务 从预览版关联到正式发布。 |
更新服务 （identity 属性） |
| 将 搜索服务分配给网络安全外围， 从预览版推广到正式版。 | 网络安全外围配置 |
| 将 对新搜索服务的机密计算支持 直接发布到正式发布。 |
创建或更新服务 （computeType 属性） |
2025-02-01-Preview
此预览版进行了以下更新：
| Update | REST API |
|---|---|
| 添加对 升级搜索服务的支持。 如果您在 2024 年 4 月之前在受支持的区域创建了服务，请执行一次性升级以获得更高的存储和向量限制。 | 升级服务 |
| 添加了对 更改定价套餐的支持。 目前，您只能在基本和标准（S1、S2 和 S3）层之间切换。 |
更新服务 （sku 属性） |
2024-06-01-Preview
此预览版进行了以下更新：
| Update | REST API |
|---|---|
| 添加了对 将搜索服务分配到网络安全外围的支持。 | 网络安全外围配置 |
将值AzureServices添加到 NetworkRuleSet.Bypass 。 如果请求源自 Azure 上的受信任服务，则可以绕过网络 IP 规则。 |
创建或更新服务和更新服务 （NetworkRuleSet.Bypass property） |
添加了对重命名 SearchService.ProvisioningState 为大写的支持，例如将 succeeded 更改为 Succeeded。 |
创建或更新服务和更新服务 （SearchService.ProvisioningState property） |
2024-03-01-Preview
此预览版进行了以下更新：
| Update | REST API |
|---|---|
| 添加用于 网络安全外围的 API，目前不可用。 | 网络安全外围配置 |
2023-11-01
此正式发布版本进行了以下更新：
| Update | REST API |
|---|---|
| 将 语义排名 从预览版提升为正式发布。 | 创建或更新服务和更新服务 |
2022-09-01
此正式发布版本进行了以下更新：
| Update | REST API |
|---|---|
| 将身份验证属性添加到适用的 REST API。 | 创建或更新服务和更新服务 |
| 将 基于角色的访问控制 从预览版推广到正式发布。 | 创建或更新服务和更新服务 |
2021-04-01-Preview
此预览版进行了以下更新：
| Update | REST API |
|---|---|
| 添加了对在搜索服务 上启用或禁用基于角色的访问控制 的支持。 | 创建或更新服务和更新服务 |
| 添加了对在搜索服务 上启用或禁用语义排名程序 的支持。 | 创建或更新服务和更新服务 |
| 添加了对 客户管理的密钥 的支持，以强制加密数据平面资源。 不符合此要求的现有搜索服务被标记为不符合。 | 创建或更新服务和更新服务 |
添加了对禁用将数据从 Azure AI 搜索推送到外部资源的工作负载的支持。 设置为 properties.disabledDataExfiltrationOptions “全部”将禁用 Power Query 连接器、 调试会话、 扩充缓存、 知识存储和具有自定义技能 的技能组 。 |
创建或更新服务和更新服务 （disabledDataExfiltrationOptions property） |
2020-08-01-Preview
此预览版增加了 sharedPrivateLinkResources 对两种新资源类型的支持。 新的 groupId 值包括 mysqlServer（Azure database for MySQL）和 sites（Azure Functions/应用服务）。
2020-08-01
此正式发布版本增加了对所有出站访问资源的 共享专用链接资源 支持，但预览版中注明的资源除外。
2020-03-13
此正式发布版本通过 Azure 专用链接添加了 专用终结点连接 支持，并为新服务添加了网络 IP 规则。
2019-10-01-Preview
这是第一个预览版。 此列表中未引入任何预览功能。 此预览在功能上等同 2020-03-13 于并保持可用。 调用该版本的任何脚本或代码都可以使用，但我们建议使用更新的正式发布或预览版 API 以获得相同的结果。
2015-08-19
这是管理 REST API 的初始版本。 它提供了用于创建和删除搜索服务、预置副本和分区以及管理 API 密钥的 API。