Compartir a través de


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.

Para más información sobre la ruta de acceso de desuso, consulte la Directiva de soporte técnico y ciclo de vida del SDK de Azure.

Versiones en desuso

2023-07-01-preview ha quedado en desuso el 8 de abril de 2024 y no se admitirá después del 8 de julio de 2024.

Esta fue la primera API de REST que ofrecía compatibilidad con el vector de búsqueda. Las versiones más recientes de API tienen una configuración de vector diferente. Debe migrar a una versión más reciente lo antes posible.

Versiones descontinuadas

Algunas versiones de API se descontinuan y ya no se documentan o admiten:

  • 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 interrumpen los paquetes del SDK basados en esa versión. Todos los SDK .NET de Azure AI Search anteriores a 3.0.0-rc se encuentran obsoletas.

El 15 de octubre de 2020 finalizó la compatibilidad con las versiones enumeradas anteriormente. 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

API DE REST Vínculo
Servicio de búsqueda (plano de datos) Consulte Versiones de API en la referencia de la API de REST.
Administración de búsquedas (plano de control) Consulte Versiones de API en la referencia de la API de 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 Registro de cambios Descripción
Azure.Search.Documents 11 Active Registro de cambios API para operaciones de plano de datos en un servicio, como operaciones de lectura y escritura en contenido y objetos.
Azure.ResourceManager.Search Active Registro de cambios API para las operaciones del plano de control en el servicio de búsqueda.

SDK de Azure para Java

Versión del SDK Estado Registro de cambios Descripción
azure-search-documentos 11 Active Registro de cambios Usar la azure-search-documents biblioteca cliente para las operaciones del plano de datos.
azure-resourcemanager-search 2 Active Registro de cambios Use la biblioteca cliente de azure-resourcemanager-search para las operaciones del plano de control.

SDK de Azure para JavaScript

Versión del SDK Estado Registro de cambios Descripción
@azure/search-documents 12 Active Registro de cambios Use la biblioteca cliente de @azure/search-documents para las operaciones del plano de datos.
@azure/arm-search 4 Active Registro de cambios Use el paquete @azure/arm-search para las operaciones del plano de control.

SDK de Azure para Python

Versión del SDK Estado Registro de cambios Descripción
azure-search-documentos 11 Active Registro de cambios Use la biblioteca cliente de azure-search-documents para las operaciones del plano de datos.
azure-mgmt-search 9 Active Registro de cambios Use la biblioteca cliente de azure-mgmt-search 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.