Creación de un alias de índice en Búsqueda de Azure AI

En Búsqueda de Azure AI, un alias de índice es un nombre secundario para un índice de búsqueda. Puede crear un alias que se asigne a un índice de búsqueda y sustituir el nombre del alias en lugares donde, de lo contrario, haría referencia a un nombre de índice. Esta característica proporciona flexibilidad si necesita cambiar el índice al que apunta la aplicación. En lugar de actualizar las referencias al nombre del índice en el código de producción, simplemente puede actualizar la asignación de alias.

Puede crear y administrar alias en un servicio de búsqueda a través de solicitudes HTTP (POST, GET, PUT o DELETE) en un recurso de alias determinado. Los alias son recursos de nivel de servicio que se mantienen independientemente de los índices de búsqueda. Después de crear un índice de búsqueda, puede crear un alias que se asigne a él.

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=2026-04-01
{
    "search": "pool spa +airport",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

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

Requisitos previos

• Un servicio Búsqueda de Azure AI en cualquier región y plan de tarifa.
• Índice de búsqueda existente al que desea asignar el alias.
• Permisos para crear un alias:
  • Para la autenticación basada en claves, una clave de API de administración para el servicio de búsqueda.
  • Para la autenticación basada en roles, el rol de Colaborador del servicio de búsqueda.

Limitaciones y consideraciones

• Solo puede usar un alias con operaciones de documento o para obtener y actualizar una definición de índice.
• No puede usar un alias para eliminar un índice o probar la tokenización de texto.
• No se puede hacer referencia a un alias como targetIndexName en un indexador o en una fuente de conocimiento.

Creación de un alias de índice

La creación de un alias establece una asignación entre un nombre de alias y un nombre de índice. Si la solicitud se realiza correctamente, puede usar el alias para la indexación, la consulta y otras operaciones.

Puede crear un alias mediante la API REST, SDK de Azure o el portal de Azure. Un alias consta del name del alias y el nombre del índice de búsqueda al que se asigna el alias. Solo puede especificar un nombre de índice en la indexes matriz.

El número máximo de alias que puede crear varía según el plan de tarifa. Para más información, consulte Límites 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);

Envío de solicitudes a un alias de índice

Puede usar un alias para todas las operaciones de documento, como consultar, indexar, sugerencias y autocompletar.

La consulta siguiente envía la solicitud a my-alias, que se asigna a un índice real en el servicio de búsqueda.

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
}

Obtención de una definición de alias

Use Aliases: lista (API REST) para devolver una lista de objetos de alias existentes por nombre.

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

Use Aliases- Get (API REST) para devolver la definición de un alias específico.

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

Actualización de un alias

La actualización más común a un alias cambia el nombre del índice cuando el índice subyacente se reemplaza por una versión más reciente.

Usar alias: crear o actualizar (API REST) para actualizar un alias. En el ejemplo siguiente se muestra cómo actualizar my-alias para que apunte a hotel-samples-index2 en lugar de hotel-samples-index.

PUT /aliases/my-alias?api-version=2026-04-01
{
    "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ó previamente el alias.

Si intenta eliminar un índice asignado actualmente a un alias, se produce un error en la operación con 400 (solicitud incorrecta) y un mensaje de error que indica que los alias asignados a ese índice deben eliminarse o asignarse a otro índice antes de que se pueda eliminar el índice.

Contenido relacionado

• Drop y recompile un índice en Búsqueda de Azure AI