Azure AI 搜尋) (管理 REST API 版本

本文列出 Azure AI 搜尋管理 REST API 的目前和過去版本。

版本化 API 檔

REST API 檔現在已設定版本。當您開啟 API 參考頁面時，請從下拉式篩選條件中選取 API 版本。

版本選取器的螢幕快照。

預覽版本會發行以測試新功能、收集意見反應，以及探索並修正問題。預覽 API 可在補充使用規定下取得，不建議用於生產工作負載。

此預覽版本會新增未來對網路安全性周邊的支援。它是以基準為基礎建置， 2023-11-01 並提供該版本中的所有 API。觀看 Azure AI 搜尋新功能中有關網路安全性周邊的公告。

此正式推出版本會將驗證屬性新增至建立或更新服務和更新服務。

此版本正式推出啟用或停用角色型訪問控制的能力。

此預覽 API 具有先前預覽 API 的所有功能，並新增下列功能：

預覽角色型訪問控制的支援。雖然這項工作的支援已在中 2022-09-01正式推出，但您也可以使用此預覽 API 版本來啟用或停用。
啟用或停用語意搜尋。語意搜尋是在標準層服務上執行的進階功能。在此預覽管理 REST API 中，使用建立或更新服務停用服務層級的語意搜尋，以禁止叫用語意排名的任何查詢。您也可以在免費層上的搜尋服務上啟用這項功能，以取得少量的免費查詢。
透過客戶管理的金鑰強制執行資料平面資源的加密， (CMK) 。使用建立或更新服務來設定此選項。不符合此需求的現有搜尋服務會標示為不符合規範。
停用將數據從 Azure AI 搜尋推送至外部資源的工作負載。使用 [建立] 或 [更新服務 ] 設定為 properties.disabledDataExfiltrationOptions [全部] 或 null (預設) 。停用所有工作負載會關閉下列功能：
- Power query 連接器
- 偵錯工作階段
- 擴充快取
- 知識存放區和技能集通常是因為它們支援與外部程式代碼整合的自定義技能。

此預覽 API 相當於正式運作的版本 2020-08-01，並新增下列功能：

已新增 sharedPrivateLinkResources 兩個新的資源類型支援。新的groupId值包括 mysqlServer (適用於 MySQL 的 Azure 資料庫) 和 sites (Azure Functions/應用程式服務) 。

此正式推出版本已針對所有輸出存取的資源新增共用 Private Link 資源支援，但預覽版本中所記錄的資源除外。

此正式推出版本已透過 Azure Private Link 新增私人端點 Connections 的支援，以及新服務的網路IP規則。

這是第一個預覽版本。此清單中沒有引進預覽功能。此預覽功能相當於 2020-03-13。它仍可供使用。任何呼叫該版本的腳本或程式代碼都可以運作，但我們建議客戶更新為使用較新的 API 版本， (正式推出或預覽 API 版本) 以取得相同的結果。

這是管理 REST API 的初始版本。它提供 API 來建立和刪除服務、布建複本和數據分割，以及管理 API 金鑰。