Criar um alias de índice no Pesquisa de IA do Azure 

Em Pesquisa de IA do Azure , um alias de índice é um nome secundário para um índice de pesquisa. Você pode criar um alias que mapeia para um índice de pesquisa e substituir o nome do alias nos locais onde você normalmente faria referência a um nome de índice. Esse recurso fornecerá flexibilidade se você precisar alterar o índice para o qual o aplicativo aponta. Em vez de atualizar as referências ao nome do índice no seu código de produção, você pode simplesmente atualizar o mapeamento do alias.

Você pode criar e gerenciar aliases em um serviço de pesquisa por meio de solicitações HTTP (POST, GET, PUT ou DELETE) em um determinado recurso de alias. Os 'aliases' são recursos de nível de serviço que são mantidos independentemente dos índices de pesquisa. Depois de criar um índice de pesquisa, você pode criar um alias mapeado para ele.

Antes de usar um alias, seu aplicativo envia solicitações diretamente para 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
}

Depois de usar um alias, seu aplicativo envia solicitações para my-alias, que é mapeado para 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
}

Pré-requisitos

• Um serviço Pesquisa de IA do Azure  em qualquer região e camada de preços.
• Um índice de pesquisa existente para o qual você deseja mapear o alias.
• Permissões para criar um alias:
  • Para autenticação baseada em chave, uma chave de API de administrador para seu serviço de pesquisa.
  • Para autenticação baseada em função, a função Contribuidor do Serviço de Pesquisa.

Limitações e considerações

• Você só pode usar um alias com operações de documento ou para obter e atualizar uma definição de índice.
• Você não pode usar um alias para excluir um índice ou testar a tokenização de texto.
• Você não pode referenciar um alias como o targetIndexName em um indexador ou fonte de conhecimento.

Criar um alias de índice

A criação de um alias estabelece um mapeamento entre um nome de alias e um nome de índice. Se a solicitação for bem-sucedida, você poderá usar o alias para indexação, consulta e outras operações.

Você pode criar um alias usando a API REST, SDKs do Azure ou o portal Azure. Um alias consiste no name do alias e no nome do índice de pesquisa ao qual o alias está mapeado. Você pode especificar apenas um nome de índice na indexes matriz.

O número máximo de aliases que você pode criar varia de acordo com o tipo de preço. Para obter mais informações, consulte limites de alias de índice.

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

Enviar solicitações para um alias de índice

Você pode usar um alias para todas as operações de documento, incluindo consulta, indexação, sugestões e preenchimento automático.

A consulta a seguir envia a solicitação para my-alias, que está mapeado para um índice real no seu serviço de pesquisa.

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
}

Obter uma definição de alias

Use aliases – Lista (API REST) para retornar uma lista de objetos de alias existentes por nome.

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

Use Aliases – Obter (API REST) para retornar a definição de um alias específico.

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

Atualizar um alias

A atualização mais comum para um alias é alterar o nome do índice quando o índice subjacente é substituído por uma versão mais recente.

Use aliases – Criar ou atualizar (API REST) para atualizar um alias. O exemplo a seguir mostra como atualizar my-alias para apontar hotel-samples-index2 em vez de hotel-samples-index.

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

Uma atualização para um alias pode levar até 10 segundos para ser propagada pelo sistema, portanto, aguarde pelo menos 10 segundos antes de excluir o índice para o qual o alias mapeou anteriormente.

Se você tentar excluir um índice atualmente mapeado para um alias, a operação falhará com 400 (Solicitação Incorreta) e uma mensagem de erro informando que o alias(es) mapeado para esse índice deve ser excluído ou mapeado para um índice diferente antes que o índice possa ser excluído.

Conteúdo relacionado

• Drop e reconstruir um índice no Pesquisa de IA do Azure