Azure AI Search のプレビュー機能

この記事では、パブリック プレビューでのデータ プレーンとコントロール プレーンのすべての機能について説明します。 この一覧は、機能の状態を確認する際に役立ちます。 また、新しいプレビュー API バージョンがロールアウトされたときにいつでもアップグレードするための使用ガイダンスとリマインダーも提供します。

プレビュー API バージョンは累積的であり、新しいプレビュー バージョンにロールアップされます。 すべてのプレビュー機能に完全にアクセスするには、常に最新のプレビュー API を使うことをお勧めします。

プレビュー機能は、廃止されたり、一般提供に移行されたりすると、この一覧から削除されます。 一般公開については、サービスの更新情報または新機能に関する記事で確認できます。

データ プレーンのプレビュー機能

コントロール プレーンのプレビュー機能

Azure SDK のプレビュー機能

各 Azure SDK チームは、独自のタイムラインでベータ版パッケージをリリースします。 ベータ版パッケージの新機能に関する情報については、次の変更ログを確認してください。

• Azure SDK for .NET の変更ログ
• Azure SDK for Java の変更ログ
• Azure SDK for JavaScript の変更ログ
• Azure SDK for Python の変更ログ

プレビュー機能の使用

実験的な機能は、最初にプレビュー REST API、Azure portal、Azure SDK を通じて利用できます。

プレビュー機能には、次のステートメントが適用されます。

• プレビュー機能は、サービス レベル アグリーメントなしで、追加使用条件に基づいて利用できます。
• 再設計が必要な場合、プレビュー機能は破壊的変更が行われる可能性があります。
• プレビュー機能では、GA リリースにできない場合があります。

プレビュー API を使ってコードを記述する場合は、新しい API バージョンがロールアウトされたらそのコードをアップグレードできるようにしておく必要があります。Upgrade REST API のドキュメントは、そのステップを簡単に実行できるように保守されています。

プレビューの REST API を呼び出す方法

プレビュー REST API は、URI の api-version パラメータを使用してアクセスします。 以前のプレビューは引き続き動作しますが、時間の経過と共に時代遅れになり、新機能やバグ修正の更新が行われません。

コンテンツのデータ プレーン操作の場合、2024-05-01-preview は最新のプレビュー バージョンです。 次に示す例は、インデックス GET (プレビュー) の構文です。

GET {endpoint}/indexes('{indexName}')?api-version=2024-05-01-Preview

検索サービスの管理操作の場合、2024-06-01-preview は最新のプレビュー バージョンです。 次に示す例は、サービスの更新 2024-06-01-preview バージョンの構文です。

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-06-01-preview

{
  "tags": {
    "app-name": "My e-commerce app",
    "new-tag": "Adding a new tag"
  },
  "properties": {
    "replicaCount": 2
  }
}

関連項目

• クイックスタート: REST API
• 検索 REST API の概要
• 検索 REST API のバージョン
• REST API を使用した管理
• 管理 REST API の概要
• 管理 REST API のバージョン