Criar um alias de índice no Azure AI Search

Importante

Os aliases de índice estão atualmente em versão prévia pública e disponíveis nos termos de uso complementares.

Um alias de índice no Azure AI Search é um nome alternativo para um índice. Você pode usar o alias em vez do nome do índice em seu aplicativo, o que minimiza atualizações futuras para o código de produção. Se você precisar alternar para um índice mais recente, poderá atualizar o mapeamento de alias.

Antes de usar um alias, seu aplicativo envia solicitações diretamente para hotel-samples-index.

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

Após utilizar um alias, seu aplicativo envia solicitações para my-alias, que é mapeado para hotel-samples-index.

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

Cenários com suporte

Você só pode usar um alias com operações de documento ou para obter e atualizar uma definição de índice.

Os aliases não podem ser usados para excluir um índice ou testar a tokenização de texto ou referenciados como o targetIndexNameem um indexador.

Criar um índice de alias

Você pode criar um alias usando a API REST em versão prévia, os SDKs em versão prévia ou por meio do portal do Azure. Um alias consiste no name do alias e no nome do índice de pesquisa para o qual o alias é mapeado. Somente um nome de índice pode ser especificado na matriz indexes.

REST API

Você pode usar o Criar ou atualizar alias (versão prévia de REST) para criar um alias de índice.

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

Portal do Azure

Siga as etapas abaixo para criar um alias de índice no portal do Azure.

1. Navegue até o serviço de pesquisa no portal do Azure.
2. Localize e selecione Aliases.
3. Selecione + Adicionar Alias.
4. Dê um nome ao alias de índice e selecione o índice de pesquisa para o qual você quer mapear o alias. Em seguida, selecione Salvar.

SDK .NET

Usando um dos pacotes beta do SDK do Azure para .NET, você pode usar a sintaxe a seguir para criar um alias de índice.

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

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

Também há suporte para aliases de índice nos SDKs em versão prévia mais recentes para Java, Python e JavaScript.

Enviar solicitações para um alias de índice

Os aliases podem ser usados para todas as operações de documento, incluindo consulta, indexação, sugestões e preenchimento automático.

Essa consulta envia a solicitação para my-alias, que é mapeada para um índice real em seu serviço de pesquisa.

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

Atualizar um alias

PUT é necessário para atualizações de alias, conforme descrito em Criar ou Atualizar Alias (versão prévia REST).

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

Uma atualização para um alias pode levar até dez segundos para se propagar pelo sistema, de modo que você deve aguardar pelo menos dez segundos antes de excluir o índice para o qual o alias foi mapeado anteriormente.

Confira também

• Remover e recompilar um índice no Azure AI Search