Partager via


Versions d’API dans Recherche Azure AI

Recherche Azure AI déploie régulièrement des mises à jour de fonctionnalités. Parfois, ces mises à jour requièrent une nouvelle version de l’API pour maintenir la compatibilité descendante. La publication d’une nouvelle version vous permet de contrôler quand et comment intégrer les mises à jour du service de recherche dans votre code.

En règle générale, les API et les bibliothèques REST font l’objet de nouvelles versions seulement quand c’est nécessaire, car mettre à niveau votre code pour utiliser une nouvelle version de l’API peut impliquer un certain travail. Une nouvelle version est requise uniquement si certains aspects de l’API ont changé d’une manière qui interrompt la compatibilité descendante. Ces changements peuvent se produire en raison de correctifs de fonctionnalités existantes ou en raison de nouvelles fonctionnalités qui modifient la surface d’exposition des API existantes.

Pour plus d’informations sur le chemin d’accès de dépréciation, consultez le cycle de vie et la stratégie de support du Kit de développement logiciel (SDK) Azure.

Versions déconseillées

2023-07-01-preview a été déconseillé le 8 avril 2024 et ne sera pas pris en charge après le 8 juillet 2024.

Il s'agissait de la première API REST qui offrait un support de recherche vectorielle. Les versions plus récentes de l'API ont une configuration vectorielle différente. Vous devez migrer vers une version plus récente dès que possible.

Versions plus disponibles

Certaines versions d’API sont supprimées et ne sont plus documentées ou prises en charge :

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

Tous les SDK sont basés sur des versions de l’API REST. Si une version REST est supprimée, les packages SDK basés sur cette version sont également supprimés. Tous les kits de développement logiciel (SDK) .NET Recherche Azure AI antérieurs à 3.0.0-rc sont désormais obsolètes.

La prise en charge des versions répertoriées ci-dessus a pris fin le 15 octobre 2020. Si vous avez un code qui utilise une version interrompue, vous pouvez migrer le code existant vers une nouvelle version de l’API REST ou un nouveau SDK Azure.

API REST

API REST Lien
Service de recherche (plan de données) Consultez les versions d’API dans la référence de l’API REST.
Gestion de la recherche (plan de contrôle) Consultez les versions d’API dans la référence de l’API REST.

Kit SDK Azure pour .NET

Le tableau suivant fournit des liens vers des versions plus récentes du Kit de développement logiciel (SDK).

Version du SDK Statut Journal des modifications Description
Azure.Search.Documents 11 Actif Journal des modifications API pour les opérations de plan de données sur un service, telles que les opérations en lecture-écriture sur le contenu et les objets.
Azure.ResourceManager.Search Actif Journal des modifications API pour les opérations de plan de contrôle sur le service de recherche.

Kit SDK Azure pour Java

Version du SDK Statut Journal des modifications Description
azure-search-documents 11 Actif Journal des modifications Utilisez la bibliothèque de client azure-search-documents pour les opérations de plan de données.
azure-resourcemanager-search 2 Actif Journal des modifications Utilisez la bibliothèque cliente azure-resourcemanager-search pour les opérations de plan de contrôle.

Kit SDK Azure pour JavaScript

Version du SDK Statut Journal des modifications Description
@azure/search-documents 12 Actif Journal des modifications Utilisez la bibliothèque cliente @azure/search-documents pour les opérations de plan de données.
@azure/arm-search 4 Actif Journal des modifications Utilisez le package @azure/arm-search pour les opérations de plan de contrôle.

Kit SDK Azure pour Python

Version du SDK Statut Journal des modifications Description
azure-search-documents 11 Actif Journal des modifications Utilisez la bibliothèque cliente azure-search-documents pour les opérations de plan de données.
azure-mgmt-search 9 Actif Journal des modifications Utilisez la bibliothèque cliente azure-mgmt-search pour les opérations de plan de contrôle.

Tous les kits SDK Azure

Si vous recherchez la documentation et les bibliothèques clientes bêta, cette page contient des liens vers tous les documents, le code et les packages de bibliothèque du kit SDK Azure.