Operações de alias (API REST de versão prévia)

Aplica-se a: 2023-07-01-Preview, 2021-04-30-Preview

Importante

2023-07-01-Preview (sem alterações).

2021-04-30-Preview adiciona a API.

No Azure AI Search, um alias de índice é um nome secundário para um índice de pesquisa. Você pode criar um alias que é mapeado para um índice de pesquisa e substituir o nome do alias em locais em que, de outra forma, você referenciaria um nome de índice. Isso oferece flexibilidade se você precisar alterar qual índice seu aplicativo está apontando. Em vez de atualizar as referências para o nome do índice no código do aplicativo, você pode apenas atualizar o mapeamento para o alias.

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

Observação

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, nem podem ser usados com a API de Análise de Texto e tampouco como o targetIndexName em um indexador.

Exemplo

O exemplo a seguir mostra como criar um alias que é mapeado para um índice de pesquisa existente.

POST /aliases?api-version=2023-07-01-Preview
{   
  "name" : "my-alias",  
  "indexes" : ["my-index"]
}  

Confira também