Azure AI 搜尋服務中的 API 版本

Azure AI 搜尋服務會定期推出功能更新。有時候 (但並不一定)，這些更新會需要新版本的 API，以維持回溯相容性。發行新版本可讓您控制在程式碼中整合搜尋服務更新的時機與方式。

REST API 和程式庫通常只在必要時才設定版本，因為升級程式碼來使用新的 API 版本有些費力。只有在以破壞回溯相容性的方式變更 API 的某些層面時，才需要新版本。在修正現有的功能，或新功能會變更現有 API 的介面區時，就會發生這類變更。

如需淘汰路徑的詳細資訊，請參閱 Azure SDK 生命週期和支援原則。

已取代的版本

2023-07-01-preview 已於 2024 年 4 月 8 日取代，2024 年 7 月 8 日之後將不再支援。

這是第一個支援向量搜尋的 REST API。較新的 API 版本有不同的向量設定。您應該盡快移轉至較新版本。

某些 API 版本已中止，遭到搜尋服務拒絕：

所有 SDK 都以 REST API 版本為基礎。如果某 REST 版本已停用，則以該版本為基礎的 SDK 套件也會停用。所有比 3.0.0-rc 更舊的 Azure AI 搜尋服務 .NET SDK 現皆已淘汰。

上述版本已於 2020 年 10 月 15 日停止支援。如果您有程式碼使用已中止的版本，您可以移轉現有的程式碼至較新的 REST API 版本或較新的 Azure SDK。

REST API	連結
搜尋服務 (資料平面)	請參閱 REST API 參考中的 API 版本
管理 (控制平面)	請參閱 REST API 參考中的 API 版本

下表提供較新 SDK 版本的連結。

SDK 版本	狀態	變更記錄檔	描述
Azure.Search.Documents 11	使用中	變更記錄	服務上數據平面作業的 API，例如內容和對象的讀寫作業。
Azure.ResourceManager.Search	使用中	變更記錄	搜尋服務上控制平面作業的 API。

SDK 版本	狀態	變更記錄檔	描述
azure-search-documents 11	使用中	變更記錄使用用戶端連結 `azure-search-documents` 庫進行數據平面作業。
azure-resourcemanager-search 2	使用中	變更記錄	使用 `azure-resourcemanager-search` 用戶端程式庫進行控制平面作業。

SDK 版本	狀態	變更記錄檔	描述
@azure/search-documents 12	使用中	變更記錄	使用 `@azure/search-documents` 用戶端程式庫進行資料平面作業。
@azure/arm-search 4	使用中	變更記錄	使用封裝 `@azure/arm-search` 進行控制平面作業。

SDK 版本	狀態	變更記錄檔	描述
azure-search-documents 11	使用中	變更記錄	使用 `azure-search-documents` 用戶端程式庫進行資料平面作業。
azure-mgmt-search 9	使用中	變更記錄	使用 `azure-mgmt-search` 用戶端程式庫進行控制平面作業。

如果您要尋找搶鮮版 (Beta) 用戶端程式庫和文件，此頁面 (英文) 包含所有 Azure SDK 程式庫套件、程式碼和文件的連結。