Versiones de la API REST de administración (Azure AI Búsqueda)

  • Artículo

En este artículo se enumeran las versiones actuales y anteriores de las API rest de administración para azure AI Búsqueda.

Documentos de API con versiones

Ahora se han versionado los documentos de la API REST. Al abrir una página de referencia de API, seleccione la versión de API en el filtro desplegable.

Captura de pantalla del selector de versiones.

Versiones estables

Versión de API Especificación Actualizaciones de la API
2023-11-01 (Más reciente) 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 funciones, recopilar comentarios, así como detectar y corregir problemas. Las API en versión preliminar están disponibles en Términos de uso complementarios y no se recomiendan para cargas de trabajo de producción.

Versión de API Especificación Actualizaciones de la API
2024-03-01-Preview (Más reciente) 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 la versión

2024-03-01-Preview

Esta versión preliminar agrega compatibilidad futura con el perímetro de seguridad de red. Se basa en la 2023-11-01 línea base y proporciona todas las API de esa versión. Observe un anuncio sobre el perímetro de seguridad de red en Novedades de Azure AI Búsqueda.

2023-11-01

Esta versión disponible con carácter general agrega la capacidad de habilitar o deshabilitar la clasificación semántica en Create o Update Service 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 el control de acceso basado en roles está disponible con carácter general en esta versión.

2021-04-01-Preview

Esta API en 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 del 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 la 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 Create o Update Services 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 Create o Update Services 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 Búsqueda en recursos externos. Use Create o Update Services para establecer properties.disabledDataExfiltrationOptions en "All" o null (valor predeterminado). La deshabilitación de todas las cargas de trabajo desactiva las siguientes funcionalidades:

2020-08-01-Preview

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

  • Se ha agregado sharedPrivateLinkResources compatibilidad con dos nuevos tipos de recursos. Entre los nuevos groupId valores se incluyen mysqlServer (Azure Database for MySQL) y sites (Azure Functions/app services).

2020-08-01

Esta versión disponible con carácter general agregó 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 agregó compatibilidad con Connections 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 presentaron características en versión preliminar 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 recomendamos a los clientes que actualicen con una versión de API más reciente (ya sea una versión de API disponible con carácter general o 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