Procházení výsledků seznamu Azure AI Vyhledávač (Preview)

• Nejnovější balíček Azure.Search.Documents ve verzi Preview: dotnet add package Azure.Search.Documents --prerelease

• Balíček Azure.Identity pro bezklíčové ověřování: dotnet add package Azure.Identity

  Note

  Klientská knihovna musí podporovat 2026-08-01-preview verzi rozhraní REST API vyhledávací služby. Dřívější verze nezpřístupňují parametry kurzoru uvedené v tomto článku.

• Nejnovější balíček azure-search-documents ve verzi Preview: pip install --pre azure-search-documents

• Balíček azure-identity pro bezklíčové ověřování: pip install azure-identity

  Note

  Klientská knihovna musí podporovat 2026-08-01-preview verzi rozhraní REST API vyhledávací služby. Dřívější verze nezpřístupňují parametry kurzoru uvedené v tomto článku.

• Verze 2026-08-01-preview rozhraní REST API vyhledávací služby.

• Pro bezklíčové ověřování uveďte v Authorization hlavičce každého požadavku HTTP token Microsoft Entra ID.

Následující příklad uvádí indexy, jejichž názvy začínají řetězcem hotels, a požaduje až 50 indexů na stránku. Iterace výsledku AsyncPageable<SearchIndex> automaticky vyžaduje každou další stránku.

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

Následující příklad uvádí indexy, jejichž názvy začínají řetězcem hotels, a požaduje až 50 indexů na stránku. Iterace výsledku ItemPaged automaticky vyžaduje každou další stránku.

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)

Referenční informace:SearchIndexClient.list_indexes

Odešlete počáteční požadavek na seznam indexů, jejichž názvy začínají hotels. Požadavek vrátí až 50 názvů 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:Seznam indexů

Pokud existuje více než 50 odpovídajících indexů, odpověď obsahuje @odata.nextLinkúplnou adresu URL pokračování a neprůkazný token. Následující odpověď je zkrácena:

{
  "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>"
}

Pokud chcete požádat o další stránku, odešlete požadavek GET na úplnou @odata.nextLink hodnotu přesně tak, jak je vrácena. Zachovat stejnou hlavičku ověřování:

GET <complete-@odata.nextLink-value>
Authorization: Bearer <access-token>
Accept: application/json

Reference:Seznam indexů

Odpověď terminálu obsahuje konečné názvy indexů a vynechá se @odata.nextLink, což znamená, že nejsou k dispozici žádné další stránky. Pořadí výsledků není součástí kontraktu kurzoru:

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