Azure AI Search は、機能の更新を定期的にロールアウトします。 このような更新が発生すると、下位互換性を維持するために、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-プレビュー
- 2014-07-31-プレビュー
- 2014-10-20-プレビュー
すべての SDK は、REST API のバージョンに基づいています。 REST バージョンが廃止された場合、そのバージョンに基づく SDK パッケージも廃止されます。 3.0.0-rc より前のすべての Azure AI Search .NET SDK は廃止されました。
上記のバージョンのサポートは、2020 年 10 月 15 日をもって終了しました。 停止されたバージョンを使用しているコードがある場合は、新しい REST API バージョンまたは新しい Azure SDK に既存のコードを移行できます。
REST API
| REST API | リンク |
|---|---|
| 検索サービス (データ プレーン) | REST API リファレンスについては、API のバージョンに関するページを参照してください。 |
| 管理 (コントロール プレーン) | REST API リファレンスについては、API のバージョンに関するページを参照してください。 |
Azure SDK for .NET
次の表では、新しいバージョンの SDK へのリンクを示します。
| SDK バージョン | 状態 | ログの変更 | 説明 |
|---|---|---|---|
| Azure.Search.Documents 11 | アクティブです | 変更ログ | コンテンツやオブジェクトに対する読み取り/書き込み操作など、サービスに対するデータ プレーン操作の API。 |
| Azure.ResourceManager.Search | アクティブです | 変更ログ | 検索サービスでのコントロール プレーン操作の API。 |
Azure SDK for Java
| SDK バージョン | 状態 | ログの変更 | 説明 |
|---|---|---|---|
| azure-search-documents 11 | アクティブです |
ログの変更 データ プレーン操作には azure-search-documents クライアント ライブラリを使用します。 |
|
| azure-resourcemanager-search 2 | アクティブです | 変更ログ | コントロール プレーン操作には azure-resourcemanager-search クライアント ライブラリを使用します。 |
Azure SDK for JavaScript
| SDK バージョン | 状態 | ログの変更 | 説明 |
|---|---|---|---|
| @azure/search-documents 12 | アクティブです | 変更ログ | データ プレーン操作には @azure/search-documents クライアント ライブラリを使用します。 |
| @azure/arm-search 4 | アクティブです | 変更ログ | コントロール プレーン操作には、@azure/arm-search パッケージを使用します。 |
Azure SDK for Python
| SDK バージョン | 状態 | ログの変更 | 説明 |
|---|---|---|---|
| azure-search-documents 11 | アクティブです | 変更ログ | データ プレーン操作には azure-search-documents クライアント ライブラリを使用します。 |
| azure-mgmt-search 9 | アクティブです | 変更ログ | コントロール プレーン操作には azure-mgmt-search クライアント ライブラリを使用します。 |
すべての Azure SDK
ベータ版のクライアント ライブラリとドキュメントをお探しの場合、このページに、すべての Azure SDK ライブラリ パッケージ、コード、ドキュメントへのリンクが含まれています。