Créer un alias d’index dans Recherche Azure AI

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 à des endroits où vous référencez sinon un nom d’index. Cette fonctionnalité offre une flexibilité si vous devez modifier l’index vers lequel votre application pointe. Au lieu de mettre à jour les références au nom d’index dans votre code de production, vous pouvez simplement mettre à jour le mappage d’alias.

Vous pouvez créer et gérer des alias sur un service de recherche via des requêtes HTTP (POST, GET, PUT ou DELETE) sur une ressource d’alias donnée. Les alias sont des ressources au niveau du service gérées indépendamment des index de recherche. Après avoir créé un index de recherche, vous pouvez créer un alias qui lui est mappé.

Avant d’utiliser un alias, votre application envoie des requêtes directement à hotel-samples-index.

POST /indexes/hotel-samples-index/docs/search?api-version=2026-04-01
{
    "search": "pool spa +airport",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

Après avoir utilisé un alias, votre application envoie des requêtes à my-alias, qui sont mappée à hotel-samples-index.

POST /indexes/my-alias/docs/search?api-version=2026-04-01
{
    "search": "pool spa +airport",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

Conditions préalables

• Un service Recherche Azure AI dans n’importe quelle région et niveau tarifaire.
• Index de recherche existant auquel vous souhaitez mapper l’alias.
• Autorisations pour créer un alias :
  • Pour l’authentification basée sur des clés, une clé API d’administration pour votre service de recherche.
  • Pour l’authentification basée sur les rôles, le rôle Contributeur du service de recherche .

Limitations et considérations

• Vous ne pouvez utiliser qu’un alias avec des opérations de document ou pour obtenir et mettre à jour une définition d’index.
• Vous ne pouvez pas utiliser d’alias pour supprimer un index ou tester la jetonisation de texte.
• Vous ne pouvez pas référencer un alias comme targetIndexNameindexeur ou source de connaissances.

Créer un alias d’index

La création d’un alias établit un mappage entre un nom d’alias et un nom d’index. Si la requête réussit, vous pouvez utiliser l’alias pour l’indexation, l’interrogation et d’autres opérations.

Vous pouvez créer un alias à l’aide de l’API REST, du SDK Azure ou du portail Azure. Un alias se compose de l’alias name et du nom de l’index de recherche auquel l’alias est mappé. Vous ne pouvez spécifier qu’un seul nom d’index dans le indexes tableau.

Le nombre maximal d’alias que vous pouvez créer varie selon le niveau tarifaire. Pour plus d’informations, consultez Limites des alias d’index.

POST /aliases?api-version=2026-04-01
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index"]
}

// Create a SearchIndexClient
SearchIndexClient adminClient = new SearchIndexClient(serviceEndpoint, credential);

// Create an index alias
SearchAlias myAlias = new SearchAlias("my-alias", "hotel-samples-index");
adminClient.CreateAlias(myAlias);

Envoyer des requêtes à un alias d’index

Vous pouvez utiliser un alias pour toutes les opérations de document, notamment l’interrogation, l’indexation, les suggestions et la saisie semi-automatique.

La requête suivante envoie la requête à my-alias, qui est mappée à un index réel sur votre service de recherche.

POST /indexes/my-alias/docs/search?api-version=2026-04-01
{
    "search": "pool spa +airport",
    "searchMode": "any",
    "queryType": "simple",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

Obtenir une définition d’alias

Utilisez des alias - List (API REST) pour retourner une liste d’objets d’alias existants par nom.

GET /aliases?api-version=2026-04-01&$select=name

Utilisez des alias - Get (API REST) pour retourner la définition d’un alias spécifique.

GET /aliases/my-alias?api-version=2026-04-01

Mettre à jour un alias

La mise à jour la plus courante d’un alias change le nom de l’index lorsque l’index sous-jacent est remplacé par une version plus récente.

Utilisez des alias - Créer ou mettre à jour (API REST) pour mettre à jour un alias. L'exemple suivant montre comment mettre à jour my-alias pour pointer vers hotel-samples-index2 au lieu de hotel-samples-index.

PUT /aliases/my-alias?api-version=2026-04-01
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index2"]
}

Une mise à jour d’un alias peut prendre jusqu’à 10 secondes pour se propager via le système. Patientez donc au moins 10 secondes avant de supprimer l’index auquel l’alias précédemment mappé.

Si vous tentez de supprimer un index actuellement mappé à un alias, l’opération échoue avec 400 (Requête incorrecte) et un message d’erreur indiquant que les alias mappés à cet index doivent être supprimés ou mappés à un autre index avant de pouvoir le supprimer.

Contenu connexe

• Supprimer et reconstruire un index dans Recherche Azure AI