Versions d’API dans Recherche Azure AI

Recherche Azure AI déploie régulièrement les mises à jour des 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 n’est plus pris en charge depuis 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 sdk Recherche Azure AI .NET 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 du code qui utilise une version abandonnée, vous pouvez migrater du code existant à une version plus récente de l’API REST ou à un Kit de développement logiciel (SDK) Azure plus récent.

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 de développement logiciel (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 de développement logiciel (SDK) Azure pour Java

Version du SDK Statut Journal des modifications Description
azure-search-documents 11 Actif Change Log Utilisez la bibliothèque cliente 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 de développement logiciel (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 de développement logiciel (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.

Toutes les SDK Azure

Si vous recherchez des bibliothèques clientes et de la documentation bêta, cette page contient des liens vers tous les packages, codes et documents de bibliothèque Kit de développement logiciel (SDK) Azure.