共用方式為

管理 REST API 版本 （Azure AI 搜尋）

  • 發行項

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

版本設定的 API 檔

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

版本選取器的螢幕快照。

穩定版本

API 版本 規範 API 更新
2023-11-01 （最新） Swagger 規格 版本資訊
2022-09-01 Swagger 規格 版本資訊
2020-08-01 Swagger 規格 版本資訊
2020-03-13 Swagger 規格 版本資訊
2015-08-19 Swagger 規格 版本資訊

預覽版本

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

API 版本 規範 API 更新
2024-06-01-Preview （最新） Swagger 規格 版本資訊
2024-03-01-Preview Swagger 規格 版本資訊
2021-04-01-Preview Swagger 規格 版本資訊
2020-08-01-Preview Swagger 規格 版本資訊
2019-10-01-Preview Swagger 規格 版本資訊

版本資訊

2024-06-01-Preview

此預覽新增下列項目的支援：

2024-03-01-Preview

此預覽版會新增 網路安全性周邊API，但尚無法使用。

2023-11-01

此正式發行版本可在 建立或更新服務 和 Update Service中，新增 啟用或停用語意排名 的功能。

2022-09-01

此正式推出版本會將驗證屬性新增至 Create or Update Service 和 Update Service。

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

2021-04-01-Preview

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

  • 預覽 角色型訪問控制的支援。 雖然此工作的支援已在 2022-09-01中正式推出，但您也可以使用此預覽 API 版本來啟用或停用它。

  • 開啟或停用 語意搜尋。 語意搜尋是在標準層服務上執行的進階功能。 在此預覽管理 REST API 中，請使用 建立或更新服務 停用服務層級的語意搜尋，以禁止叫用語意排名的任何查詢。 您也可以在免費層上的搜尋服務上啟用這項功能，以進行少量的免費查詢。

  • 透過 客戶管理金鑰 （CMK）強制執行資料平面資源的加密。 使用 建立或更新服務 來設定此選項。 不符合此需求的現有搜尋服務會標示為不符合規範。

  • 停用將數據從 Azure AI 搜尋推送至外部資源的工作負載。 使用 建立或更新服務，將 properties.disabledDataExfiltrationOptions 設定為 “All” 或 null （預設值）。 停用所有工作負載會關閉下列功能：

2020-08-01-Preview

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

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

2020-08-01

此正式推出版本已新增 共用私人鏈接資源 支援所有輸出存取的資源，但預覽版本中所指出的資源除外。

2020-03-13

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

2019-10-01-Preview

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

2015-08-19

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

另請參閱