Versiones de api REST de administración (Azure AI Search)

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 REST ahora 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	Especificación	Actualizaciones de API
2023-11-01 (más reciente)	de especificación de Swagger	nota de la versión
2022-09-01	de especificación de Swagger	nota de la versión
2020-08-01	de especificación de Swagger	nota de la versión
2020-03-13	de especificación de Swagger	nota de la versión
2015-08-19	de 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 en versión preliminar están disponibles en términos de uso complementariosy no se recomiendan para cargas de trabajo de producción.

Versión de API	Especificación	Actualizaciones de API
2024-06-01-Preview (más reciente)	de especificación de Swagger	nota de la versión
2024-03-01-Preview	de especificación de Swagger	nota de la versión
2021-04-01-Preview	de especificación de Swagger	nota de la versión
2020-08-01-Preview	de especificación de Swagger	nota de la versión
2019-10-01-Preview	de especificación de Swagger	nota de la versión

Notas

2024-06-01-Preview

Esta versión preliminar agrega compatibilidad con:

• ahora se admiten configuraciones perimetrales de seguridad de red. Para obtener más información, consulte Agregar un servicio de búsqueda a un perímetro de seguridad de red.
• NetworkRuleSet.Bypass ahora tiene un nuevo valor denominado AzureServices. Puede omitir las reglas ip de red si las solicitudes se originan en un servicio de confianza en Azure.
• La última actualización cambia el nombre del SearchService.ProvisioningState a mayúsculas (por ejemplo, de correcto a Correcto).

2024-03-01-Preview

Esta versión preliminar agrega API para perímetro de seguridad de red, que aún no está disponible.

2023-11-01

Esta versión disponible con carácter general agrega la capacidad de habilitar o deshabilitar de clasificación semántica en Crear o actualizar servicio y Update Service.

2022-09-01

Esta versión disponible con carácter general agrega propiedades de autenticación a Create o Update Service y Update Service.

La capacidad de habilitar o deshabilitar control de acceso basado en rol está disponible con carácter general en esta versión.

2021-04-01-Preview

Esta API de versión preliminar tiene todas las características de la API de versión preliminar anterior y agrega la siguiente funcionalidad:

• Compatibilidad con la versión preliminar de control de acceso basado en rol. Aunque la compatibilidad con esta tarea está disponible con carácter general en 2022-09-01, también puede habilitarla o deshabilitarla mediante esta versión preliminar de la API.

• Habilite o deshabilite búsqueda semántica. La búsqueda semántica es una característica premium que se ejecuta en los servicios de nivel Estándar. En esta API REST de administración en versión preliminar, use crear o actualizar servicios para deshabilitar la búsqueda semántica en el nivel de servicio para prohibir cualquier consulta que invoque la clasificación semántica. También puede habilitar esta característica en los servicios de búsqueda en el nivel gratis para un pequeño número de consultas gratuitas.

• Aplique el cifrado de los recursos del plano de datos a través de claves administradas por el cliente (CMK). Use crear o actualizar servicios para configurar esta opción. Los servicios de búsqueda existentes que no cumplen este requisito se marcan como no conformes.

• Deshabilite las cargas de trabajo que insertan datos de Azure AI Search en recursos externos. Use crear o actualizar servicios para establecer properties.disabledDataExfiltrationOptions en "All" o null (valor predeterminado). Al deshabilitar todas las cargas de trabajo, se desactivan las siguientes funcionalidades:

  • conectores de Power Query
  • sesiones de depuración
  • de caché de enriquecimiento de
  • Los almacenes de conocimientosy Conjuntos de aptitudes generalmente porque admiten aptitudes personalizadas que se integran con código externo.

2020-08-01-Preview

Esta API en versión preliminar es equivalente a la versión disponible con carácter general 2020-08-01y agrega la siguiente funcionalidad:

• Se ha agregado 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 agregó recursos compartidos de Private Link compatibilidad con todos los recursos de acceso saliente, excepto los indicados en la versión preliminar.

2020-03-13

Esta versión disponible con carácter general agregó compatibilidad con conexiones de punto de conexión privado a través de Azure Private Link y reglas ip de red para nuevos servicios.

2019-10-01-Preview

Esta es la primera versión preliminar. No había características en versión preliminar introducidas en esta lista. Esta versión preliminar es funcionalmente equivalente a 2020-03-13. Sigue estando disponible. Cualquier script o código que llame a esa versión funcionará, pero se recomienda a los clientes actualizar a mediante una versión de API más reciente (ya sea una versión de API disponible con carácter general o una 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 la creación y eliminación del servicio, el aprovisionamiento de réplicas y particiones, y la administración de claves de API.

Consulte también

• Crear un servicio de búsqueda
• administración del servicio mediante el portal
• de administración de PowerShell de
• Supervisión de azure AI Search