Crear un alias de índice en Azure AI Search

Importante

Los alias de índice se encuentran actualmente en versión preliminar pública y están disponibles en las condiciones de uso complementarias.

Un alias de índice en Azure AI Search es un nombre alternativo para un índice. Puede usar el alias en lugar del nombre de índice de la aplicación, lo que minimiza las actualizaciones futuras del código de producción. Si necesita cambiar a un índice más reciente, puede actualizar el mapeo de alias.

Antes de usar un alias, la aplicación envía solicitudes directamente a 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
}

Después de usar un alias, la aplicación envía solicitudes a my-alias, que se asigna a 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
}

Escenarios admitidos

Solo puede usar un alias con operaciones de documento o para obtener y actualizar una definición de índice.

Los alias no se pueden usar para eliminar un índice, ni probar la tokenización de texto o hacer referencia a estos como en targetIndexName un indexador.

Creación de un alias de índice

Puede crear un alias mediante la API de REST de la versión preliminar, los SDK de la versión preliminar o a través del Azure Portal. Un alias consta del name del alias y el nombre del índice de búsqueda al que está asignado el alias. Solo se puede especificar un nombre de índice en la matriz indexes.

API DE REST

Puede usar la opción Crear o actualizar alias (versión preliminar de REST) para crear un alias de índice.

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

Azure Portal

Siga los pasos siguientes para crear un alias de índice en el Azure Portal.

1. Vaya al servicio de búsqueda en Azure Portal.
2. Busque y seleccione Alias.
3. Seleccione + Agregar alias.
4. Asigne un nombre al alias de índice y seleccione el índice de búsqueda al que desea asignar el alias. Después, seleccione Guardar.

SDK de .NET

Con uno de los paquetes beta del SDK de Azure para .NET, puede usar la siguiente sintaxis para crear un 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);

Los alias de índice también se admiten en los SDK de versión preliminar más recientes para Java, Python y JavaScript.

Envío de solicitudes a un alias de índice

Los alias se pueden usar para todas las operaciones de documento, incluidas las consultas, la indexación, las sugerencias y la función de autocompletar.

Esta consulta envía la solicitud a my-alias, que se asigna a un índice concreto en su servicio de búsqueda.

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
}

Actualización de un alias

PUT es necesario para las actualizaciones de alias, tal y como se describe en Crear o actualizar alias (versión preliminar de REST).

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

Una actualización de un alias puede tardar hasta 10 segundos en propagarse por el sistema, por lo que debe esperar al menos 10 segundos antes de eliminar el índice al que se asignó anteriormente el alias.

Consulte también

• Quitar y recompilar un índice en Azure AI Search