Versiones de API en Azure AI Search

Azure AI Search implementa las actualizaciones de características de forma regular. A veces, aunque no siempre, estas actualizaciones requieren una nueva versión de la API para mantener la compatibilidad con versiones anteriores. La publicación de una nueva versión le permite controlar cuándo y cómo integrar en su código las actualizaciones del servicio de búsqueda.

Por lo general, se publican versiones de las API REST y bibliotecas solo cuando es necesario, ya que actualizar el código para usar una nueva versión de API puede suponer cierto esfuerzo. Solo se necesita una versión nueva si es necesario cambiar algún aspecto de la API de tal manera que se interrumpe la compatibilidad con versiones anteriores. Estos cambios pueden deberse a correcciones en las características existentes o a características nuevas que cambian el área expuesta de la API.

Consulte Ciclo de vida y directiva de soporte técnico de SDK de Azure para obtener más información sobre la ruta de desuso.

Versiones no admitidas

Algunas versiones de API están discontinuadas y el servicio de búsqueda las rechazará:

  • 2015-02-28
  • 2015-02-28-Preview
  • 2014-07-31-Preview
  • 2014-10-20-Preview

Todos los SDK se basan en versiones de las API REST. Si se interrumpe una versión rest, también se descontinuan los paquetes del SDK basados en esa versión. Todos los SDK de .NET de Azure AI Search anteriores a 3.0.0-rc ahora están obsoletos.

La compatibilidad con las versiones anteriores finalizó el 15 de octubre de 2020. Si tiene código que usa una versión descontinuada, puede migrar el código existente a una versión más reciente de la API REST o a un SDK de Azure más reciente.

API de REST

REST API Vínculo
Servicio de búsqueda (plano de datos) Consulte las versiones de API en la referencia de API REST.
Administración (plano de control) Consulte las versiones de API en la referencia de API REST.

SDK de Azure para .NET

En la tabla siguiente se proporcionan vínculos a versiones más recientes del SDK.

Versión del SDK Estado Descripción
Azure.Search.Documents 11 Activas Nueva biblioteca cliente del equipo del SDK para .NET de Azure, publicada inicialmente en julio de 2020. Consulte el registro de cambios para información sobre las versiones secundarias.
Microsoft.Azure.Search 10 Retirado Publicada en mayo de 2019. Esta es la última versión del paquete Microsoft.Azure.Search y está en desuso. Se reemplazó por Azure.Search.Documents.
Microsoft.Azure.Management.Search 4.0.0 Activas Tiene como destino la API REST de administración api-version=2020-08-01.
Microsoft.Azure.Management.Search 3.0.0 Retirado Tiene como destino la API de REST de administración api-version=2015-08-19.

SDK de Azure para Java

Versión del SDK Estado Descripción
Java azure-search-documents 11 Activas Use la azure-search-documents biblioteca cliente para las operaciones del plano de datos.
Java Management Client 1.35.0 Activas Use la azure-mgmt-search biblioteca cliente para las operaciones del plano de control.

Azure SDK para JavaScript

Versión del SDK Estado Descripción
JavaScript @azure/search-documents 11.0 Activas Use la @azure/search-documents biblioteca cliente para las operaciones del plano de datos.
JavaScript @azure/arm-search Activas Use la @azure/arm-search biblioteca cliente para las operaciones del plano de control.

SDK de Azure para Python

Versión del SDK Estado Descripción
Python azure-search-documents 11.0 Activas Use la azure-search-documents biblioteca cliente para las operaciones del plano de datos.
Python azure-mgmt-search 8.0 Activas Use la azure-mgmt-search biblioteca cliente para las operaciones del plano de control.

Todos los SDK de Azure

Si busca documentación y bibliotecas de cliente en versión beta, esta página contiene vínculos a toda la documentación, código y paquetes de la biblioteca del SDK de Azure.