Share via

Versions de l’API REST de gestion (Azure AI Recherche)

  • Article

Cet article répertorie les versions actuelles et passées des API REST de gestion pour azure AI Recherche.

Documentation sur l’API versionnée

Les documents sur l’API REST sont désormais versionnés. Lorsque vous ouvrez une page de référence d’API, sélectionnez la version de l’API dans le filtre de liste déroulante.

Capture d’écran du sélecteur de version.

Versions stables

Version de l'API Caractéristique Mises à jour des API
2023-11-01 (Dernière version) Spécification Swagger Note de publication
2022-09-01 Spécification Swagger Note de publication
2020-08-01 Spécification Swagger Note de publication
2020-03-13 Spécification Swagger Note de publication
2015-08-19 Spécification Swagger Note de publication

Préversions

Les préversions sont publiées pour tester les nouvelles fonctionnalités, recueillir des commentaires et détecter et résoudre les problèmes. Les API en préversion sont disponibles sous Conditions d’utilisation supplémentaires et ne sont pas recommandées pour les charges de travail de production.

Version de l'API Caractéristique Mises à jour des API
2024-03-01-Preview (Dernière version) Spécification Swagger Note de publication
2021-04-01-Preview Spécification Swagger Note de publication
2020-08-01-Preview Spécification Swagger Note de publication
2019-10-01-Preview Spécification Swagger Note de publication

Notes de publication

2024-03-01-Preview

Cette préversion ajoute la prise en charge future du périmètre de sécurité réseau. Il est basé sur la 2023-11-01 base de référence et fournit toutes les API de cette version. Regardez une annonce sur le périmètre de sécurité réseau dans Nouveautés d’Azure AI Recherche.

2023-11-01

Cette version en disponibilité générale ajoute la possibilité d’activer ou de désactiver le classement sémantique dans Créer ou mettre à jour le service et Le service de mise à jour.

2022-09-01

Cette version en disponibilité générale ajoute des propriétés d’authentification à Create ou Update Service et Update Service.

La possibilité d’activer ou de désactiver le contrôle d’accès en fonction du rôle est généralement disponible dans cette version.

2021-04-01-Preview

Cette API en préversion possède toutes les fonctionnalités de l’API de préversion précédente et ajoute les fonctionnalités suivantes :

  • Prise en charge de la préversion pour le contrôle d’accès en fonction du rôle. Bien que la prise en charge de cette tâche soit généralement disponible dans 2022-09-01, vous pouvez également l’activer ou la désactiver à l’aide de cette préversion de l’API.

  • Activer ou désactiver la recherche sémantique. La recherche sémantique est une fonctionnalité Premium qui s’exécute sur les services de niveau Standard. Dans cette API REST de gestion en préversion, utilisez Create ou Update Services pour désactiver la recherche sémantique au niveau du service afin d’interdire toute requête qui appelle un classement sémantique. Vous pouvez également activer cette fonctionnalité sur les services de recherche sur le niveau gratuit pour un petit nombre de requêtes gratuites.

  • Appliquer le chiffrement des ressources du plan de données via des clés gérées par le client (CMK). Utilisez Créer ou Mettre à jour des services pour configurer cette option. Les services de recherche existants qui ne répondent pas à cette exigence sont marqués comme non conformes.

  • Désactivez les charges de travail qui poussent des données d’Azure AI Recherche vers des ressources externes. Utilisez Create ou Update Services pour définir properties.disabledDataExfiltrationOptions sur « All » ou null (valeur par défaut). La désactivation de toutes les charges de travail désactive les fonctionnalités suivantes :

2020-08-01-Preview

Cette API en préversion est équivalente à la version 2020-08-01généralement disponible et ajoute les fonctionnalités suivantes :

  • Ajout de sharedPrivateLinkResources la prise en charge de deux nouveaux types de ressources. Les nouvelles groupId valeurs incluent mysqlServer (Azure Database pour MySQL) et sites (Azure Functions/services d’application).

2020-08-01

Cette version en disponibilité générale a ajouté la prise en charge de Shared Private Link Resources pour toutes les ressources accessibles sortantes, à l’exception de celles indiquées dans la préversion.

2020-03-13

Cette version en disponibilité générale a ajouté la prise en charge des Connections de point de terminaison privé via Azure Private Link et des règles IP réseau pour les nouveaux services.

2019-10-01-Preview

Il s’agit de la première préversion. Aucune fonctionnalité en préversion n’a été introduite dans cette liste. Cette préversion est fonctionnellement équivalente à 2020-03-13. Il reste disponible. Tout script ou code qui appelle cette version fonctionne, mais nous recommandons aux clients d’effectuer une mise à jour vers une version d’API plus récente (version généralement disponible ou préversion de l’API) pour obtenir les mêmes résultats.

2015-08-19

Il s’agit de la version initiale de l’API REST de gestion. Il fournissait des API pour la création et la suppression de services, l’approvisionnement de réplicas et de partitions, et la gestion des clés API.

Voir aussi