Erstellen eines Indexalias in Azure KI-Suche

In Azure KI-Suche ist ein Indexalias ein sekundärer Name für einen Suchindex. Sie können einen Alias erstellen, der einem Suchindex zugeordnet ist, und den Aliasnamen an Stellen ersetzen, an denen Sie andernfalls auf einen Indexnamen verweisen. Dieses Feature bietet Flexibilität, wenn Sie den Index ändern müssen, auf den Ihre Anwendung verweist. Anstatt Verweise auf den Indexnamen in Ihrem Produktionscode zu aktualisieren, können Sie einfach die Aliaszuordnung aktualisieren.

Sie können Aliase für einen Suchdienst über HTTP-Anforderungen (POST, GET, PUT oder DELETE) für eine bestimmte Aliasressource erstellen und verwalten. Aliase sind Ressourcen auf Dienstebene, die unabhängig von Suchindizes verwaltet werden. Nachdem Sie einen Suchindex erstellt haben, können Sie einen Alias erstellen, der ihr zugeordnet ist.

Bevor Sie einen Alias verwenden, sendet Ihre Anwendung Anforderungen direkt an 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
}

Nachdem ein Alias verwendet wurde, sendet Ihre Anwendung Anforderungen an den Alias my-alias, der hotel-samples-index zugeordnet ist.

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

Voraussetzungen

• Ein Azure KI-Suche-Dienst in jeder Region und Preisebene.
• Ein vorhandener Suchindex , dem Sie den Alias zuordnen möchten.
• Berechtigungen zum Erstellen eines Alias:
  • Für die schlüsselbasierte Authentifizierung ist ein Administrator-API-Schlüssel für Ihren Suchdienst vorgesehen.
  • Für die rollenbasierte Authentifizierung wird die Rolle "Suchdienst-Beitragender" verwendet.

Einschränkungen und Überlegungen

• Sie können nur einen Alias mit Dokumentvorgängen verwenden oder eine Indexdefinition abrufen und aktualisieren.
• Sie können keinen Alias verwenden, um einen Index zu löschen oder die Texttokenisierung zu testen.
• Sie können einen Alias nicht als targetIndexName in einem Indexer oder einer Wissensquelle referenzieren.

Erstellen eines Indexalias

Durch das Erstellen eines Alias wird eine Zuordnung zwischen einem Aliasnamen und einem Indexnamen eingerichtet. Wenn die Anforderung erfolgreich ist, können Sie den Alias für die Indizierung, Abfrage und andere Vorgänge verwenden.

Sie können einen Alias mithilfe der REST-API, Azure SDKs oder des Azure Portals erstellen. Ein Alias besteht aus dem name des Alias und dem Namen des Suchindexes, dem der Alias zugeordnet wird. Sie können nur einen Indexnamen im indexes Array angeben.

Die maximale Anzahl von Aliasen, die Sie erstellen können, variiert je nach Preisniveau. Weitere Informationen finden Sie unter "Indexaliaslimits".

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

// Create a SearchIndexClient
SearchIndexClient adminClient = new SearchIndexClient(serviceEndpoint, credential);

// Create an index alias
SearchAlias myAlias = new SearchAlias("my-alias", "hotel-samples-index");
adminClient.CreateAlias(myAlias);

Anfragen an einen Indexalias senden

Sie können einen Alias für alle Dokumentvorgänge verwenden, einschließlich Abfragen, Indizierung, Vorschläge und AutoVervollständigen.

Die folgende Abfrage sendet die Anforderung an my-alias, die einem tatsächlichen Index ihres Suchdiensts zugeordnet ist.

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
}

Abrufen einer Aliasdefinition

Verwenden Sie Aliase – Liste (REST-API), um eine Liste vorhandener Aliasobjekte anhand des Namens zurückzugeben.

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

Verwenden Sie Aliases - Get (REST-API), um die Definition eines bestimmten Alias abzurufen.

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

Aktualisieren eines Alias

Das am häufigsten verwendete Update für einen Alias ändert den Indexnamen, wenn der zugrunde liegende Index durch eine neuere Version ersetzt wird.

Verwenden Sie Aliase – Erstellen oder Aktualisieren (REST-API), um einen Alias zu aktualisieren. Das folgende Beispiel zeigt, wie Sie my-alias aktualisieren, um anstelle von hotel-samples-index2 auf hotel-samples-index zu verweisen.

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

Eine Aktualisierung eines Alias kann bis zu 10 Sekunden dauern, bis sie über das System verteilt werden. Warten Sie also mindestens 10 Sekunden, bevor Sie den Index löschen, dem der Alias zuvor zugeordnet wurde.

Wenn Sie versuchen, einen Index zu löschen, der derzeit einem Alias zugeordnet ist, schlägt der Vorgang mit 400 (Ungültige Anforderung) fehl, und eine Fehlermeldung, die angibt, dass der diesem Index zugeordnete Alias(n) gelöscht oder einem anderen Index zugeordnet werden muss, bevor der Index gelöscht werden kann.

Verwandte Inhalte

• Ein Index in Azure KI-Suche löschen und neu erstellen