Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se enumeran las versiones actuales y anteriores de las API rest de administración para Azure AI Search.
Documentos de API con versiones
Los documentos de la API de REST tienen versiones. Al abrir una página de referencia de API, seleccione la versión de API en el filtro desplegable.
Versiones estables
| Versión de API | Specification | Actualizaciones de API |
|---|---|---|
2025-05-01 (más reciente) |
Especificación de Swagger | Nota de la versión |
2023-11-01 |
Especificación de Swagger | Nota de la versión |
2022-09-01 |
Especificación de Swagger | Nota de la versión |
2020-08-01 |
Especificación de Swagger | Nota de la versión |
2020-03-13 |
Especificación de Swagger | Nota de la versión |
2015-08-19 |
Especificación de Swagger | Nota de la versión |
Versiones preliminares
Las versiones preliminares se publican para probar nuevas funcionalidades, recopilar comentarios y detectar y corregir problemas. Las API de versión preliminar están disponibles en los términos de uso complementarios y no se recomiendan para cargas de trabajo de producción.
| Versión de API | Specification | Actualizaciones de API |
|---|---|---|
2025-02-01-Preview (más reciente) |
Especificación de Swagger | Nota de la versión |
2024-06-01-Preview |
Especificación de Swagger | Nota de la versión |
2024-03-01-Preview |
Especificación de Swagger | Nota de la versión |
2021-04-01-Preview |
Especificación de Swagger | Nota de la versión |
2020-08-01-Preview |
Especificación de Swagger | Nota de la versión |
2019-10-01-Preview |
Especificación de Swagger | Nota de la versión |
Notas de lanzamiento
2025-05-01
Esta versión disponible con carácter general realiza las siguientes actualizaciones:
| Update | REST API |
|---|---|
| Promueve la actualización del servicio de búsqueda de la versión preliminar a la disponibilidad general. | Servicio de actualización |
| Promueve el cambio del plan de tarifa de la versión preliminar a la disponibilidad general. |
Servicio de actualización (sku propiedad) |
| Promueve la asociación de una identidad administrada asignada por el usuario con el servicio de búsqueda desde la versión preliminar hasta la disponibilidad general. |
Servicio de actualización (identity propiedad) |
| Promueve la asignación del servicio de búsqueda a un perímetro de seguridad de red desde la versión preliminar hasta la disponibilidad general. | configuraciones perimetrales de seguridad de red |
| Libera soporte informático confidencial para nuevos servicios de búsqueda directamente a disponibilidad general. |
Crear o actualizar servicio (computeType propiedad) |
2025-02-01-Preview
Esta versión preliminar realiza las siguientes actualizaciones:
| Update | REST API |
|---|---|
| Agrega compatibilidad para actualizar el servicio de búsqueda. Si creó su servicio antes de abril de 2024 en una región compatible, realice una actualización única para obtener límites de almacenamiento y vectores más altos. | Servicio de actualización |
| Agrega compatibilidad para cambiar el plan de tarifa. Actualmente, solo puede cambiar entre los niveles Básico y Estándar (S1, S2 y S3). |
Servicio de actualización (sku propiedad) |
2024-06-01-Preview
Esta versión preliminar realiza las siguientes actualizaciones:
| Update | REST API |
|---|---|
| Agrega compatibilidad para asignar el servicio de búsqueda a un perímetro de seguridad de red. | configuraciones perimetrales de seguridad de red |
Agrega el AzureServices valor a NetworkRuleSet.Bypass. Si las solicitudes se originan en un servicio de confianza en Azure, puede omitir las reglas de IP de red. |
Crear o actualizar servicio y actualizar servicio (NetworkRuleSet.Bypass propiedad) |
Agrega compatibilidad para cambiar SearchService.ProvisioningState el nombre a mayúsculas, como cambiar succeeded a Succeeded. |
Crear o actualizar servicio y actualizar servicio (SearchService.ProvisioningState propiedad) |
2024-03-01-Preview
Esta versión preliminar realiza las siguientes actualizaciones:
| Update | REST API |
|---|---|
| Agrega API para el perímetro de seguridad de la red, que no está disponible actualmente. | configuraciones perimetrales de seguridad de red |
2023-11-01
Esta versión disponible con carácter general realiza las siguientes actualizaciones:
| Update | REST API |
|---|---|
| Promueve la clasificación semántica desde la versión preliminar hasta la disponibilidad general. | Crear o actualizar servicio y actualizar servicio |
2022-09-01
Esta versión disponible con carácter general realiza las siguientes actualizaciones:
| Update | REST API |
|---|---|
| Agrega propiedades de autenticación a las API de REST aplicables. | Crear o actualizar servicio y actualizar servicio |
| Promueve el control de acceso basado en roles desde la versión preliminar hasta la disponibilidad general. | Crear o actualizar servicio y actualizar servicio |
2021-04-01-Preview
Esta versión preliminar realiza las siguientes actualizaciones:
| Update | REST API |
|---|---|
| Agrega compatibilidad para habilitar o deshabilitar el control de acceso basado en roles en el servicio de búsqueda. | Crear o actualizar servicio y actualizar servicio |
| Agrega compatibilidad para habilitar o deshabilitar el clasificador semántico en el servicio de búsqueda. | Crear o actualizar servicio y actualizar servicio |
| Agrega compatibilidad con claves administradas por el cliente para aplicar el cifrado de los recursos del plano de datos. Los servicios de búsqueda existentes que no cumplen este requisito se marcan como no conformes. | Crear o actualizar servicio y actualizar servicio |
Agrega compatibilidad para deshabilitar cargas de trabajo que insertan datos de Azure AI Search en recursos externos. Si se establece properties.disabledDataExfiltrationOptions en "Todos", se deshabilitan los conectores de Power Query, las sesiones de depuración, la caché de enriquecimiento, los almacenes de conocimiento y los conjuntos de aptitudes con aptitudes personalizadas. |
Crear o actualizar servicio y actualizar servicio (disabledDataExfiltrationOptions propiedad) |
2020-08-01-Preview
Esta versión preliminar agrega sharedPrivateLinkResources compatibilidad con dos nuevos tipos de recursos. Los nuevos valores de groupId incluyen mysqlServer (Azure Database for MySQL) y sites (Azure Functions/app services).
2020-08-01
Esta versión disponible con carácter general agrega compatibilidad con recursos de Private Link compartidos para todos los recursos a los que se accede de salida, excepto los indicados en la versión preliminar.
2020-03-13
Esta versión disponible con carácter general agrega compatibilidad con conexiones de punto de conexión privado a través de Azure Private Link y reglas de IP de red para nuevos servicios.
2019-10-01-Preview
Esta es la primera versión preliminar. No se introducen características de vista previa en esta lista. Esta versión preliminar es funcionalmente equivalente y 2020-03-13 sigue estando disponible. Cualquier script o código que llame a esa versión funciona, pero se recomienda usar una versión más reciente de la API disponible con carácter general o en versión preliminar para obtener los mismos resultados.
2015-08-19
Esta es la versión inicial de la API REST de administración. Proporcionó API para crear y eliminar un servicio de búsqueda, aprovisionar réplicas y particiones, y administrar claves de API.