Azure Yapay Zeka Arama listeleme sonuçlarında sayfalar arasında gezinme (önizleme)

• En son Azure.Search.Documents önizleme paketi: dotnet add package Azure.Search.Documents --prerelease

• Anahtarsız kimlik doğrulaması için Azure.Identity paket: dotnet add package Azure.Identity

  Not

  İstemci kitaplığı, Arama Hizmeti REST API'sinin 2026-08-01-preview sürümünü desteklemelidir. Önceki sürümler bu makalede gösterilen imleç parametrelerini kullanıma sunmaz.

• En son azure-search-documents önizleme paketi: pip install --pre azure-search-documents

• Anahtarsız kimlik doğrulaması için azure-identity paket: pip install azure-identity

  Not

  İstemci kitaplığı, Arama Hizmeti REST API'sinin 2026-08-01-preview sürümünü desteklemelidir. Önceki sürümler bu makalede gösterilen imleç parametrelerini kullanıma sunmaz.

• Arama Hizmeti REST API'sinin 2026-08-01-preview sürümü.

• Anahtarsız kimlik doğrulaması için her HTTP isteğinin üst bilgisine Authorization bir Microsoft Entra ID belirteci ekleyin.

Aşağıdaki örnek, adları ile hotels başlayan ve sayfa başına en fazla 50 dizin isteyen dizinleri listeler. AsyncPageable<SearchIndex> sonucunu yinelediğinizde, izleyen her sayfa otomatik olarak istenir.

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

Başvuru:SearchIndexClient.GetIndexesAsync

Aşağıdaki örnek, adları ile hotels başlayan ve sayfa başına en fazla 50 dizin isteyen dizinleri listeler. ItemPaged sonucunu yinelediğinizde, izleyen her sayfa otomatik olarak istenir.

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)

Referans:SearchIndexClient.list_indexes

adları ile hotelsbaşlayan dizinleri listelemek için bir ilk istek gönderin. İstek en fazla 50 dizin adı döndürür:

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

Referans:İndeksleri Listele

50'den fazla eşleşen dizin mevcut olduğunda yanıt, tam devamlılık URL'sini ve bir opak belirteci içeren öğesini içerir @odata.nextLink. Aşağıdaki yanıt kısaltılır:

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

Sonraki sayfayı istemek için tam olarak döndürülen değere @odata.nextLink bir GET isteği gönderin. Aynı kimlik doğrulama üst bilgisini koru:

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

Referans:İndeksleri Listele

Terminal yanıtı nihai dizin adlarını içerir ve @odata.nextLink öğesini atlayarak başka sayfa olmadığını gösterir. Sonuç sırası imleç sözleşmesinin bir parçası değildir:

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