Operações de alias (API REST de visualização)
Aplica-se a: 2023-07-01-Preview. Esta versão não é mais suportada. Atualize imediatamente para uma versão mais recente.
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 mapeia para um índice de pesquisa e substituir o nome do alias em locais onde, de outra forma, faria referência a um nome de índice. Isso lhe dá flexibilidade se você precisar alterar para qual índice seu aplicativo está apontando. Em vez de atualizar as referências ao nome do índice no código do aplicativo, você pode apenas atualizar o mapeamento para seu alias.
Você pode criar e gerenciar aliases no serviço Azure AI Search por meio de solicitações HTTP (POST, GET, PUT, DELETE) em relação a 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 é criado, você pode criar um alias que mapeia 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, não podem ser usados com a API Analisar Texto e não podem ser usados como targetIndexName em um indexador.
Exemplo
O exemplo a seguir mostra como criar um alias que mapeia para um índice de pesquisa existente.
POST /aliases?api-version=2023-07-01-Preview
{
"name" : "my-alias",
"indexes" : ["my-index"]
}