本文列出 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（適用於 MySQL 的 Azure 資料庫）和 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。