管理 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-06-01-Preview (最新) Swagger 仕様の リリース ノート の
2024-03-01-Preview Swagger 仕様の リリース ノート の
2021-04-01-Preview Swagger 仕様の リリース ノート の
2020-08-01-Preview Swagger 仕様の リリース ノート の
2019-10-01-Preview Swagger 仕様の リリース ノート の

リリース ノート

2024-06-01-Preview

このプレビュー バージョンは、2024-03-01-Preview ベースラインに基づいて構築され、AzureServicesと呼ばれる新しい NetworkRuleSet.Bypass 値のサポートを追加します。 要求が Azure 上の信頼されたサービスから送信された場合は、ネットワーク IP 規則をバイパスできます。 他の唯一の変更は、SearchService.ProvisioningState の名前を大文字に変更すること (たとえば、succeeded から Succeeded) です。

2024-03-01-Preview

このプレビュー バージョンは、 ベースラインに基づいて構築され、ネットワーク セキュリティ境界サポートを追加します。

2023-11-01

この一般公開バージョンでは、Create または Update Service と Update Serviceでセマンティック ランク付け を有効または無効 機能が追加されます。

2022-09-01

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

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

2021-04-01-Preview

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

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

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

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

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

2020-08-01-Preview

このプレビュー API は、一般公開バージョンの 2020-08-01に相当し、次の機能が追加されます。

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

2020-08-01

この一般提供バージョン 共有プライベート リンク リソース、プレビュー バージョンに記載されているものを除くすべての送信アクセスリソースのサポートが追加されました。

2020-03-13

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

2019-10-01-Preview

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

2015-08-19

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

関連項目

  • 検索サービス を作成する
  • ポータル を使用したサービス管理の
  • PowerShell 管理 の
  • Azure AI Search の監視の