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