Azure AI 搜尋服務會定期推出功能更新。 有時候 (但並不一定)，這些更新會需要新版本的 API，以維持回溯相容性。 發行新版本可讓您控制在程式碼中整合搜尋服務更新的時機與方式。
REST API 和程式庫通常只在必要時才設定版本，因為升級程式碼來使用新的 API 版本有些費力。 只有在以破壞回溯相容性的方式變更 API 的某些層面時，才需要新版本。 在修正現有的功能，或新功能會變更現有 API 的介面區時，就會發生這類變更。
如需取代路徑的詳細資訊，請參閱 Azure SDK 生命週期和支持原則。
已取代的版本
2023-07-01-preview 已於 2024 年 4 月 8 日取代，2024 年 7 月 8 日之後將不再支援。
這是第一個支援向量搜尋的 REST API。 較新的 API 版本有不同的向量設定。 您應該盡快移轉至較新版本。
已中止版本
部分 API 版本已停止，且不再記載或支援：
- 2015-02-28
- 2015-02-28-Preview
- 2014-07-31-Preview
- 2014-10-20-Preview
所有 SDK 都以 REST API 版本為基礎。 如果某 REST 版本已停用，則以該版本為基礎的 SDK 套件也會停用。 所有比 3.0.0-rc 更舊的 Azure AI 搜尋服務 .NET SDK 現皆已淘汰。
上述版本已於 2020 年 10 月 15 日停止支援。 如果您有程式碼使用已中止的版本，您可以移轉現有的程式碼至較新的 REST API 版本或較新的 Azure SDK。
REST API
| REST API | 連結 |
|---|---|
| 搜尋服務 (資料平面) | 請參閱 REST API 參考中的 API 版本 。 |
| 搜尋管理 (控制平面) | 請參閱 REST API 參考中的 API 版本 。 |
適用於 .NET 的 Azure SDK
下表提供較新 SDK 版本的連結。
| SDK 版本 | 狀態 | 變更記錄 | 描述 |
|---|---|---|---|
| Azure.Search.Documents 11 | Active | 變更記錄 | 服務上資料平面作業的 API，例如內容和對象的讀寫作業。 |
| Azure.ResourceManager.Search | Active | 變更記錄 | 搜尋服務上控制平面作業的 API。 |
適用於 Java 的 Azure SDK
| SDK 版本 | 狀態 | 變更記錄 | 描述 |
|---|---|---|---|
| azure-search-documents 11 | Active |
變更記錄 使用 azure-search-documents 用戶端程式庫進行資料平面作業。 |
|
| azure-resourcemanager-search 2 | Active | 變更記錄 | 使用 azure-resourcemanager-search 用戶端程式庫進行控制平面作業。 |
適用於 JavaScript 的 Azure SDK
| SDK 版本 | 狀態 | 變更記錄 | 描述 |
|---|---|---|---|
| @azure/search-documents 12 | Active | 變更記錄 | 使用 @azure/search-documents 用戶端程式庫進行資料平面作業。 |
| @azure/arm-search 4 | Active | 變更記錄 | 使用封裝 @azure/arm-search 封裝進行控制平面作業。 |
適用於 Python 的 Azure SDK
| SDK 版本 | 狀態 | 變更記錄 | 描述 |
|---|---|---|---|
| azure-search-documents 11 | Active | 變更記錄 | 使用 azure-search-documents 用戶端程式庫進行資料平面作業。 |
| azure-mgmt-search 9 | Active | 變更記錄 | 使用 azure-mgmt-search 用戶端程式庫進行控制平面作業。 |
所有 Azure SDK
如果您要尋找搶鮮版 (Beta) 用戶端程式庫和文件，此頁面 (英文) 包含所有 Azure SDK 程式庫套件、程式碼和文件的連結。