Bläddra igenom listresultaten i Azure AI-sökning (förhandsversion)

• Det senaste Azure.Search.Documents förhandsversionspaketet: dotnet add package Azure.Search.Documents --prerelease

• För nyckellös autentisering, paketet Azure.Identity: dotnet add package Azure.Identity

  Note

  Klientbiblioteket måste ha stöd för 2026-08-01-preview versionen av rest-API:et för söktjänsten. Tidigare versioner exponerar inte de markörparametrar som visas i den här artikeln.

• Det senaste azure-search-documents förhandsversionspaketet: pip install --pre azure-search-documents

• För nyckellös autentisering, paketet azure-identity: pip install azure-identity

  Note

  Klientbiblioteket måste ha stöd för 2026-08-01-preview versionen av rest-API:et för söktjänsten. Tidigare versioner exponerar inte de markörparametrar som visas i den här artikeln.

• Versionen 2026-08-01-preview av REST-API:t för söktjänsten.

• För nyckellös autentisering inkluderar du en Microsoft Entra ID token i rubriken för Authorization varje HTTP-begäran.

I följande exempel visas index vars namn börjar med hotels och begär upp till 50 index per sida. Iterering av resultatet AsyncPageable<SearchIndex> begär automatiskt varje efterföljande sida.

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);
}

Referens:SearchIndexClient.GetIndexesAsync

I följande exempel visas index vars namn börjar med hotels och begär upp till 50 index per sida. Iterering av resultatet ItemPaged begär automatiskt varje efterföljande sida.

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)

Referens:SearchIndexClient.list_indexes

Skicka en första begäran om att lista index vars namn börjar med hotels. Begäran returnerar upp till 50 indexnamn:

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

Referens:Listindex

När det finns fler än 50 matchande index innehåller @odata.nextLinksvaret , som innehåller den fullständiga fortsättnings-URL:en och en ogenomskinlig token. Följande svar förkortas:

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

Om du vill begära nästa sida skickar du en GET-begäran till det fullständiga @odata.nextLink värdet exakt som returnerat. Behåll samma autentiseringshuvud:

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

Referens:Listindex

Terminalsvaret innehåller de slutliga indexnamnen och utelämnar @odata.nextLink, vilket anger att inga fler sidor är tillgängliga. Resultatordningen ingår inte i markörens kontrakt:

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