Skapa ett indexalias i Azure AI-sökning

Note

Azure AI-sökning är tillgängligt via Azure-portalen, REST-API:er och Azure-SDK:er. Den ligger också till grund för Foundry IQ, det hanterade kunskapsskiktet som omvandlar företagsinnehåll till återanvändbara, behörighetsmedvetna kunskapsbaser för agenter i Microsoft Foundry-portalen.

I Azure AI-sökning är ett indexalias ett sekundärt namn för ett sökindex. Du kan skapa ett alias som mappar till ett sökindex och ersätta aliasnamnet på platser där du annars refererar till ett indexnamn. Den här funktionen ger flexibilitet om du behöver ändra det index som programmet pekar på. I stället för att uppdatera referenser till indexnamnet i produktionskoden kan du helt enkelt uppdatera aliasmappningen.

Du kan skapa och hantera alias i en söktjänst via HTTP-begäranden (POST, GET, PUT eller DELETE) mot en viss aliasresurs. Alias är resurser på tjänstnivå som underhålls oberoende av sökindex. När du har skapat ett sökindex kan du skapa ett alias som mappar till det.

Innan du använder ett alias skickar ditt program begäranden direkt till 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
}

När du har använt ett alias skickar programmet begäranden till my-alias, som mappar till 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
}

Förutsättningar

• En Azure AI-sökning tjänst i valfri region och prisnivå.
• Ett befintligt sökindex som du vill mappa aliaset till.
• Behörigheter för att skapa ett alias:
  • För nyckelbaserad autentisering är en api-nyckel för administratör för söktjänsten.
  • För rollbaserad autentisering, rollen Search Service Contributor.

Begränsningar och överväganden

• Du kan bara använda ett alias med dokumentåtgärder eller för att hämta och uppdatera en indexdefinition.
• Du kan inte använda ett alias för att ta bort ett index eller testa texttokenisering.
• Du kan inte referera till ett alias som targetIndexName på en indexerare eller kunskapskälla.

Skapa ett indexalias

När du skapar ett alias upprättas en mappning mellan ett aliasnamn och ett indexnamn. Om begäran lyckas kan du använda aliaset för indexering, frågor och andra åtgärder.

Du kan skapa ett alias med hjälp av REST-API:et, Azure-SDK:er eller Azure-portalen. Ett alias består av name aliaset och namnet på sökindexet som aliaset mappar till. Du kan bara ange ett indexnamn i matrisen indexes .

Det maximala antalet alias som du kan skapa varierar beroende på prisnivå. Mer information finns i Indexaliasgränser.

REST-API

Använd den senaste stabila versionen av Alias – Skapa (REST API) för att skapa ett indexalias.

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

Azure-SDK:er

Indexalias stöds i den senaste stabila Azure-SDK:er för .NET, Java, JavaScript och Python.

I följande exempel visas hur du skapar ett alias med Azure SDKs för .NET.

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

Azure portalen

1. Gå till söktjänsten i Azure-portalen.

2. I den vänstra rutan väljer du Sökhantering>ochAlias.

3. Välj Lägg till alias.

4. Ange ett namn för ditt indexalias.

5. Välj det sökindex som du vill mappa ditt alias till.

6. Välj Spara.

   

Skicka begäranden till ett indexalias

Du kan använda ett alias för alla dokumentåtgärder, inklusive frågor, indexering, förslag och automatisk komplettering.

Följande fråga skickar begäran till my-alias, som mappas till ett faktiskt index i din söktjänst.

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
}

Hämta en definition av alias

Använd Alias – Lista (REST API) för att returnera en lista över befintliga aliasobjekt efter namn.

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

Använd Alias – Hämta (REST API) för att returnera definitionen av ett specifikt alias.

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

Uppdatera ett alias

Den vanligaste uppdateringen av ett alias är att ändra indexnamnet när det underliggande indexet ersätts med en nyare version.

Använd alias – Skapa eller uppdatera (REST API) för att uppdatera ett alias. I följande exempel visas hur du uppdaterar my-alias att peka på hotel-samples-index2 istället för hotel-samples-index.

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

En uppdatering av ett alias kan ta upp till 10 sekunder att spridas genom systemet, så vänta minst 10 sekunder innan du tar bort det index som aliaset tidigare mappades till.

Om du försöker ta bort ett index som för närvarande är mappat till ett alias misslyckas åtgärden med 400 (felaktig begäran) och ett felmeddelande om att aliasen som mappas till indexet måste tas bort eller mappas till ett annat index innan indexet kan tas bort.

Relaterat innehåll

• Ta bort och återskapa ett index i Azure AI-sökning