Azure AI 検索でインデックスエイリアスを作成する

Note

Azure AI 検索は、Azure ポータル、REST API、およびAzure SDKから使用できます。 また、Foundry IQ は、エンタープライズ コンテンツを、Microsoft Foundry ポータルのエージェントの再利用可能なアクセス許可に対応したナレッジ ベースに変換するマネージド ナレッジ レイヤーです。

Azure AI 検索では、インデックスエイリアスは検索インデックスのセカンダリ名です。 検索インデックスにマップされるエイリアスを作成し、インデックス名を参照する代わりにそのエイリアス名を使うことができます。 この機能は、アプリケーションが指すインデックスを変更する必要がある場合に柔軟性を提供します。 運用コード内のインデックス名への参照を更新する代わりに、エイリアス マッピングを更新するだけです。

特定のエイリアス リソースに対する HTTP 要求 (POST、GET、PUT、または DELETE) を使用して、検索サービスでエイリアスを作成および管理できます。 エイリアスは、検索インデックスとは別に維持されるサービス レベルのリソースです。 検索インデックスを作成したら、それにマップするエイリアスを作成できます。

エイリアスを使用する前に、アプリケーションは要求を直接 hotel-samples-indexに送信します。

POST /indexes/hotel-samples-index/docs/search?api-version=2026-04-01
{
    "search": "pool spa +airport",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

エイリアスを使用した後、アプリケーションは my-aliasに要求を送信し、 hotel-samples-indexにマップします。

POST /indexes/my-alias/docs/search?api-version=2026-04-01
{
    "search": "pool spa +airport",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

前提 条件

制限事項と考慮事項

インデックスエイリアスを作成する

エイリアスを作成すると、エイリアス名とインデックス名の間のマッピングが確立されます。 要求が成功した場合は、インデックス作成、クエリ、その他の操作にエイリアスを使用できます。

エイリアスは、REST API、Azure SDK、または Azure ポータルを使用して作成できます。 エイリアスは、エイリアスの name と、エイリアスがマップされる検索インデックスの名前で構成されます。 indexes配列に指定できるインデックス名は 1 つだけです。

作成できるエイリアスの最大数は、価格レベルによって異なります。 詳細については、「 インデックスエイリアスの制限」を参照してください。

最新の安定したバージョンの エイリアス - Create (REST API) を使用してインデックスエイリアスを作成します。

POST /aliases?api-version=2026-04-01
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index"]
}

インデックス エイリアスに要求を送信する

クエリ、インデックス作成、候補、オートコンプリートなど、すべてのドキュメント操作にエイリアスを使用できます。

次のクエリは、 my-aliasに要求を送信します。この要求は、検索サービスの実際のインデックスにマップされます。

POST /indexes/my-alias/docs/search?api-version=2026-04-01
{
    "search": "pool spa +airport",
    "searchMode": "any",
    "queryType": "simple",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

エイリアス定義を取得する

エイリアス - List (REST API) を使用して、既存のエイリアス オブジェクトの一覧を名前で返します。

GET /aliases?api-version=2026-04-01&$select=name

エイリアス - Get (REST API) を使用して、特定のエイリアスの定義を返します。

GET /aliases/my-alias?api-version=2026-04-01

エイリアスを更新する

エイリアスの最も一般的な更新は、基になるインデックスが新しいバージョンに置き換えられるときにインデックス名を変更する方法です。

エイリアス - 作成または更新 (REST API) を使用して、エイリアスを更新します。 次の例は、my-aliasではなくhotel-samples-index2を指すようにhotel-samples-indexを更新する方法を示しています。

PUT /aliases/my-alias?api-version=2026-04-01
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index2"]
}

エイリアスの更新がシステムに反映されるまでに最大 10 秒かかる場合があるため、エイリアスが以前にマップされたインデックスを削除する前に、少なくとも 10 秒待ちます。

現在エイリアスにマップされているインデックスを削除しようとすると、操作は 400 (無効な要求) で失敗し、そのインデックスにマップされているエイリアスを削除するか、インデックスを削除する前に別のインデックスにマップする必要があることを示すエラー メッセージが表示されます。

関連コンテンツ

  • Azure AI 検索
  • Last updated on