Een indexalias maken in Azure AI Zoeken

In Azure AI Zoeken is een indexalias een secundaire naam voor een zoekindex. U kunt een alias maken die is toegewezen aan een zoekindex en de aliasnaam vervangen op plaatsen waar u anders naar een indexnaam verwijst. Deze functie biedt flexibiliteit als u de index wilt wijzigen waarnaar uw toepassing verwijst. In plaats van verwijzingen naar de indexnaam in uw productiecode bij te werken, kunt u de aliastoewijzing bijwerken.

U kunt aliassen voor een zoekservice maken en beheren via HTTP-aanvragen (POST, GET, PUT of DELETE) voor een bepaalde aliasresource. Aliassen zijn resources op serviceniveau die onafhankelijk van zoekindexen worden onderhouden. Nadat u een zoekindex hebt gemaakt, kunt u een alias maken die eraan is toegewezen.

Voordat u een alias gebruikt, verzendt uw toepassing aanvragen rechtstreeks naar 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
}

Nadat u een alias hebt gebruikt, verzendt uw toepassing verzoeken naar my-alias, dat naar hotel-samples-index leidt.

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

Voorwaarden

• Een Azure AI Zoeken-service in elke regio en prijscategorie.
• Een bestaande zoekindex waaraan u de alias wilt toewijzen.
• Machtigingen voor het maken van een alias:
  • Voor verificatie op basis van sleutels, een beheer-API-sleutel voor uw zoekservice.
  • Voor authenticatie op basis van rollen is de rol Bijdrager aan zoekservice.

Beperkingen en overwegingen

• U kunt alleen een alias met documentbewerkingen gebruiken of een indexdefinitie ophalen en bijwerken.
• U kunt geen alias gebruiken om een index te verwijderen of teksttokenisatie te testen.
• U kunt niet verwijzen naar een alias als de targetIndexName naam van een indexeerfunctie of kennisbron.

Een indexalias maken

Het maken van een alias brengt een toewijzing tot stand tussen een aliasnaam en een indexnaam. Als de aanvraag is geslaagd, kunt u de alias gebruiken voor indexering, query's en andere bewerkingen.

U kunt een alias maken met behulp van de REST API, Azure-SDK's of de Azure-portal. Een alias bestaat uit de name alias en de naam van de zoekindex waaraan de alias wordt toegewezen. U kunt slechts één indexnaam opgeven in de indexes matrix.

Het maximum aantal aliassen dat u kunt maken, verschilt per prijscategorie. Zie De limieten voor indexalias voor meer informatie.

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);

Aanvragen verzenden naar een indexalias

U kunt een alias gebruiken voor alle documentbewerkingen, waaronder query's, indexeren, suggesties en automatisch aanvullen.

Met de volgende query wordt de aanvraag verzonden naar my-alias, die is toegewezen aan een werkelijke index in uw zoekservice.

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
}

Een aliasdefinitie ophalen

Gebruik Aliassen - List (REST API) om een lijst met bestaande aliasobjecten op naam te retourneren.

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

Gebruik Aliassen - Get (REST API) om de definitie van een specifieke alias te retourneren.

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

Een alias bijwerken

De meest voorkomende update van een alias is het wijzigen van de indexnaam wanneer de onderliggende index wordt vervangen door een nieuwere versie.

Aliassen gebruiken : Een alias maken of bijwerken (REST API) om een alias bij te werken. In het volgende voorbeeld ziet u hoe u deze kunt bijwerken my-alias zodat deze verwijst hotel-samples-index2 in plaats van hotel-samples-index.

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

Het kan tot 10 seconden duren voordat een update van een alias via het systeem wordt doorgegeven. Wacht dus ten minste 10 seconden voordat u de index verwijdert waaraan de alias eerder is toegewezen.

Als u probeert een index te verwijderen die momenteel is toegewezen aan een alias, mislukt de bewerking met 400 (Ongeldige aanvraag) en een foutbericht waarin wordt aangegeven dat de aliassen die aan die index zijn toegewezen, moeten worden verwijderd of toegewezen aan een andere index voordat de index kan worden verwijderd.

Verwante inhoud

• Drop en bouw een index opnieuw op in Azure AI Zoeken