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

Cet article répertorie les versions actuelles et passées des API REST de gestion pour Recherche d’IA Azure.

Documentation de l’API avec version

Les documents de 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 Spécification Mises à jour d’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éversion des versions

Les versions en préversion sont publiées pour tester de 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émentaireset ne sont pas recommandées pour les charges de travail de production.

Version de l’API Spécification Mises à jour d’API
2024-06-01-Preview (Dernière version) spécification Swagger note de publication
2024-03-01-Preview 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-06-01-Preview

Cette préversion est basée sur la base de référence 2024-03-01-Preview et ajoute la prise en charge d’une nouvelle valeur de NetworkRuleSet.Bypass appelée AzureServices. Vous pouvez contourner les règles IP réseau si les requêtes proviennent d’un service approuvé sur Azure. La seule autre modification consiste à renommer l'SearchService.ProvisioningState en majuscules (par exemple, de la réussite à la réussite).

2024-03-01-Preview

Cette préversion repose sur la base de référence 2023-11-01 et ajoute la prise en charge de périmètre de sécurité réseau.

2023-11-01

Cette version généralement disponible permet d’activer ou de désactiver de classement sémantique dans créer ou mettre à jour un service et update Service.

2022-09-01

Cette version généralement disponible ajoute des propriétés d’authentification à créer ou mettre à jour le service et update Service.

La possibilité d’activer ou de désactiver 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 présente toutes les fonctionnalités de l’API de préversion précédente et ajoute les fonctionnalités suivantes :

  • Prise en charge en préversion de 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 version d’API en préversion.

  • Activez ou désactivez de 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 créer ou mettre à jour des services pour désactiver la recherche sémantique au niveau du service pour interdire toute requête qui appelle le 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 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 Search vers des ressources externes. Utilisez créer ou mettre à jour des 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 équivaut à la version en disponibilité générale 2020-08-01et ajoute les fonctionnalités suivantes :

  • Ajout sharedPrivateLinkResources prise en charge de deux nouveaux types de ressources. Les nouvelles valeurs de groupId incluent mysqlServer (base de données Azure pour MySQL) et sites (Azure Functions/app services).

2020-08-01

Cette version généralement disponible a ajouté ressources de liaison privée partagée prise en charge de toutes les ressources accessibles en sortie, sauf celles indiquées dans la préversion.

2020-03-13

Cette version généralement disponible a ajouté la prise en charge de connexions 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 vous recommandons aux clients de mettre à jour à l’aide d’une version d’API plus récente (une version d’API en disponibilité générale ou en préversion) pour obtenir les mêmes résultats.

2015-08-19

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

Voir aussi