Parcourir les résultats de la liste dans Recherche Azure AI (préversion)

• Le dernier paquet Azure.Search.Documents (préversion) : dotnet add package Azure.Search.Documents --prerelease

• Pour l’authentification sans clé, le Azure.Identity package : dotnet add package Azure.Identity

  Note

  La bibliothèque cliente doit prendre en charge la 2026-08-01-preview version de l’API REST du service de recherche. Les versions antérieures n’exposent pas les paramètres de curseur affichés dans cet article.

• Le dernier paquet azure-search-documents (préversion) : pip install --pre azure-search-documents

• Pour l’authentification sans clé, le azure-identity package : pip install azure-identity

  Note

  La bibliothèque cliente doit prendre en charge la 2026-08-01-preview version de l’API REST du service de recherche. Les versions antérieures n’exposent pas les paramètres de curseur affichés dans cet article.

• La version 2026-08-01-preview de l’API REST du service de recherche.

• Pour l’authentification sans clé, incluez un jeton de Microsoft Entra ID dans l’en-tête Authorization de chaque requête HTTP.

L’exemple suivant liste les index dont les noms commencent par hotels et demande jusqu’à 50 index par page. Itérer le résultat AsyncPageable<SearchIndex> demande automatiquement chaque page suivante.

using System;
using Azure;
using Azure.Identity;
using Azure.Search.Documents;
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
using Azure.Search.Documents.Models;

string endpoint = Environment.GetEnvironmentVariable(
    "AZURE_SEARCH_ENDPOINT")!;

var options = new SearchClientOptions(
    SearchClientOptions.ServiceVersion.V2026_08_01_Preview);
var client = new SearchIndexClient(
    new Uri(endpoint),
    new AzureCliCredential(),
    options);

AsyncPageable<SearchIndex> indexes = client.GetIndexesAsync(
    search: "hotels",
    pageSize: 50,
    searchType: ListingSearchType.Prefix);

await foreach (SearchIndex index in indexes)
{
    Console.WriteLine(index.Name);
}

Reference :SearchIndexClient.GetIndexesAsync

L’exemple suivant liste les index dont les noms commencent par hotels et demande jusqu’à 50 index par page. Itérer le résultat ItemPaged demande automatiquement chaque page suivante.

import os

from azure.identity import AzureCliCredential
from azure.search.documents.indexes import SearchIndexClient

endpoint = os.getenv("AZURE_SEARCH_ENDPOINT")

with SearchIndexClient(
    endpoint,
    AzureCliCredential(),
    api_version="2026-08-01-preview",
) as client:
    indexes = client.list_indexes(
        select=["name"],
        search="hotels",
        page_size=50,
        search_type="prefix",
    )
    for index in indexes:
        print(index.name)

Référence :SearchIndexClient.list_indexes

Envoyez une requête initiale aux index de liste dont les noms commencent par hotels. La requête retourne jusqu’à 50 noms d’index :

GET https://<search-service-name>.search.windows.net/indexes?api-version=2026-08-01-preview&search=hotels&searchType=prefix&pageSize=50&$select=name
Authorization: Bearer <access-token>
Accept: application/json

Reference :List Indexes

Lorsque plus de 50 index correspondants existent, la réponse inclut @odata.nextLink, qui contient l’URL de continuation complète et un jeton opaque. La réponse suivante est abrégée :

{
  "value": [
    {
      "name": "<index-name>"
    }
  ],
  "@odata.nextLink": "https://<search-service-name>.search.windows.net/indexes?api-version=2026-08-01-preview&searchType=prefix&%24select=name&%24skiptoken=<opaque-token>"
}

Pour demander la page suivante, envoyez une requête GET en utilisant exactement la valeur complète @odata.nextLink telle qu’elle a été renvoyée. Conservez le même en-tête d’authentification :

GET <[email protected]>
Authorization: Bearer <access-token>
Accept: application/json

Reference :List Indexes

La réponse du terminal contient les noms d’index définitifs et omet @odata.nextLink, ce qui indique qu’aucune autre page n’est disponible. L’ordre des résultats ne fait pas partie du contrat du curseur :

{
  "value": [
    {
      "name": "<next-index-name>"
    }
  ]
}