Percorrer os resultados da listagem no Pesquisa de IA do Azure (pré-visualização)

• O pacote de pré-visualização mais recente Azure.Search.Documents: dotnet add package Azure.Search.Documents --prerelease

• Para autenticação sem chave, o Azure.Identity pacote: dotnet add package Azure.Identity

  Note

  A biblioteca cliente deve suportar a 2026-08-01-preview versão da API REST do Serviço de Pesquisa. Versões anteriores não expõem os parâmetros do cursor apresentados neste artigo.

• O pacote de pré-visualização mais recente azure-search-documents: pip install --pre azure-search-documents

• Para autenticação sem chave, o azure-identity pacote: pip install azure-identity

  Note

  A biblioteca cliente deve suportar a 2026-08-01-preview versão da API REST do Serviço de Pesquisa. Versões anteriores não expõem os parâmetros do cursor apresentados neste artigo.

• A versão 2026-08-01-preview de pré-visualização da API REST do Serviço de Pesquisa.

• Para autenticação sem chave, inclua um token Microsoft Entra ID no Authorization cabeçalho de cada pedido HTTP.

O exemplo seguinte lista índices cujos nomes começam com hotels e solicitam até 50 índices por página. Ao iterar sobre o resultado AsyncPageable<SearchIndex>, cada página seguinte é solicitada automaticamente.

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

Referência:SearchIndexClient.GetIndexesAsync

O exemplo seguinte lista índices cujos nomes começam com hotels e solicitam até 50 índices por página. Ao iterar sobre o resultado ItemPaged, cada página seguinte é solicitada automaticamente.

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)

Referência:SearchIndexClient.list_indexes

Envie um pedido inicial para listar índices cujos nomes começam por hotels. O pedido devolve até 50 nomes de índice:

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

Referência:Listas de Índices

Quando existem mais de 50 índices correspondentes, a resposta inclui @odata.nextLink, que contém a URL de continuação completa e um token opaco. A seguinte resposta é abreviada:

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

Para solicitar a página seguinte, envie um pedido GET para o valor completo @odata.nextLink exatamente tal como foi devolvido. Mantém o mesmo cabeçalho de autenticação:

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

Referência:Listas de Índices

A resposta terminal contém os nomes finais dos índices e omite @odata.nextLink, indicando que não há mais páginas disponíveis. A ordem dos resultados não faz parte do contrato do cursor:

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