Partager via


Opérations d’alias (API REST en préversion)

s’applique à: 2023-07-01-Preview. Cette version n’est plus prise en charge. mettre à niveau immédiatement vers une version plus récente.

Important

2023-07-01-Preview (aucune modification).

2021-04-30-Preview ajoute l’API.

Dans Recherche AZURE AI, un alias d’index est un nom secondaire pour un index de recherche. Vous pouvez créer un alias qui est mappé à un index de recherche et remplacer le nom de l’alias dans les emplacements où vous référencez sinon un nom d’index. Cela vous offre une flexibilité si vous avez besoin de modifier l’index vers lequel pointe votre application. Au lieu de mettre à jour les références au nom d’index dans votre code d’application, vous pouvez simplement mettre à jour le mappage de votre alias.

Vous pouvez créer et gérer des alias dans le service Recherche d’IA Azure via des requêtes HTTP (POST, GET, PUT, DELETE) sur une ressource d’alias donnée. Les alias sont des ressources de niveau de service et gérés indépendamment des index de recherche. Une fois qu’un index de recherche est créé, vous pouvez créer un alias qui correspond à cet index de recherche.

Note

Vous ne pouvez utiliser qu’un alias avec opérations de document ou pour obtenir et mettre à jour une définition d’index. Les alias ne peuvent pas être utilisés pour supprimer un index, ne peuvent pas être utilisés avec l’API Analyser le texte et ne peuvent pas être utilisés comme targetIndexName sur un indexeur.

Exemple

L’exemple suivant montre comment créer un alias qui est mappé à un index de recherche existant.

POST /aliases?api-version=2023-07-01-Preview
{   
  "name" : "my-alias",  
  "indexes" : ["my-index"]
}  

Voir aussi