管理 REST API のバージョン (Azure AI Search)

この記事では、Azure AI Searchの管理 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-03-01-Preview (最新) Swagger の仕様 リリース ノート
2021-04-01-Preview Swagger の仕様 リリース ノート
2020-08-01-Preview Swagger の仕様 リリース ノート
2019-10-01-Preview Swagger の仕様 リリース ノート

リリース ノート

2024-03-01-Preview

このプレビュー バージョンでは、ネットワーク セキュリティ境界の将来のサポートが追加されます。 これはベースラインに基づいて 2023-11-01 構築されており、そのバージョンのすべての API を提供します。 ネットワーク セキュリティ境界に関するお知らせについては、「Azure AI Searchの新機能」を参照してください

2023-11-01

この一般公開バージョンでは、サービスの作成または更新とサービスの更新セマンティック ランク付けを有効または無効にする機能が追加されます

2022-09-01

この一般公開バージョンでは、サービス の作成または更新とサービスの更新 に認証プロパティが追加 されます

ロールベースのアクセス制御を有効または無効にする機能は、このリリースで一般提供されています。

2021-04-01-Preview

このプレビュー API には、以前のプレビュー API のすべての機能があり、次の機能が追加されています。

  • ロールベースのアクセス制御のプレビュー サポート。 このタスクのサポートは で 2022-09-01一般提供されていますが、このプレビュー API バージョンを使用して有効または無効にすることもできます。

  • セマンティック検索を有効または無効にします。 セマンティック検索は、Standard レベルのサービスで実行される Premium 機能です。 このプレビュー管理 REST API では、 Create または Update Services を 使用してサービス レベルでセマンティック検索を無効にして、セマンティック ランク付けを呼び出すクエリを禁止します。 Free レベルの検索サービスで、少数の無料クエリに対してこの機能を有効にすることもできます。

  • カスタマー マネージド キー (CMK) を使用してデータ プレーン リソースの暗号化を適用します。 このオプションを構成するには、 サービスの作成または更新 を使用します。 この要件を満たしていない既存の検索サービスは、非準拠としてマークされます。

  • Azure AI Searchから外部リソースにデータをプッシュするワークロードを無効にします。 [ サービスの作成] または [更新] を使用して、"すべて" または null (既定値) に設定 properties.disabledDataExfiltrationOptions します。 すべてのワークロードを無効にすると、次の機能がオフになります。

2020-08-01-Preview

このプレビュー API は、一般提供されているバージョン 2020-08-01と同等であり、次の機能を追加します。

  • 2 つの新しいリソースの種類のサポートが追加されました sharedPrivateLinkResources 。 新しいgroupId値には、(Azure database for MySQL) と sites (Azure Functions/app services) が含まれますmysqlServer

2020-08-01

この一般公開バージョンでは、プレビュー バージョンに記載されているものを除き、送信アクセスされたすべてのリソースに対する Shared Private Link Resources のサポートが追加されました。

2020-03-13

この一般公開バージョンでは、新しいサービスのAzure Private Linkとネットワーク IP 規則を介したプライベート エンドポイント Connectionsのサポートが追加されました。

2019-10-01-Preview

これは最初のプレビュー バージョンです。 この一覧には、導入されたプレビュー機能はありませんでした。 このプレビューは、 と機能的に同等 2020-03-13です。 引き続き使用できます。 そのバージョンを呼び出すスクリプトまたはコードは機能しますが、同じ結果を得るには、より新しい API バージョン (一般提供またはプレビュー API バージョン) を使用するように更新することをお勧めします。

2015-08-19

これは、Management REST API の最初のリリースです。 サービスの作成と削除、レプリカとパーティションのプロビジョニング、API キーの管理のための API が提供されました。

こちらもご覧ください