Azure AI 검색 목록 결과 페이지(미리 보기)

• 최신 Azure.Search.Documents 미리 보기 패키지: dotnet add package Azure.Search.Documents --prerelease

• 키 없는 인증의 경우 패키지:Azure.Identitydotnet add package Azure.Identity

  메모

  클라이언트 라이브러리는 Search Service REST API 버전을 지원 2026-08-01-preview 해야 합니다. 이전 버전은 이 문서에 표시된 커서 매개 변수를 노출하지 않습니다.

• 최신 azure-search-documents 미리 보기 패키지: pip install --pre azure-search-documents

• 키 없는 인증의 경우 패키지:azure-identitypip install azure-identity

  메모

  클라이언트 라이브러리는 Search Service REST API 버전을 지원 2026-08-01-preview 해야 합니다. 이전 버전은 이 문서에 표시된 커서 매개 변수를 노출하지 않습니다.

• Search Service REST API의 2026-08-01-preview 버전입니다.

• 키 없는 인증의 경우 각 HTTP 요청의 헤더에 Microsoft Entra ID 토큰을 Authorization 포함합니다.

다음 예제에서는 이름이 시작 hotels 되고 페이지당 최대 50개의 인덱스를 요청하는 인덱스를 나열합니다. 결과를 반복하면 AsyncPageable<SearchIndex> 각 후속 페이지가 자동으로 요청됩니다.

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

참조:SearchIndexClient.GetIndexesAsync

다음 예제에서는 이름이 시작 hotels 되고 페이지당 최대 50개의 인덱스를 요청하는 인덱스를 나열합니다. 결과를 반복하면 ItemPaged 각 후속 페이지가 자동으로 요청됩니다.

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)

참조:SearchIndexClient.list_indexes

이름이 .로 시작하는 hotels인덱스를 나열하는 초기 요청을 보냅니다. 요청은 최대 50개 인덱스 이름을 반환합니다.

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

참조:인덱스 나열

일치하는 인덱스가 50개 이상 있는 경우 응답에는 @odata.nextLink전체 연속 URL 및 불투명 토큰이 포함됩니다. 다음 응답은 약어입니다.

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

다음 페이지를 요청하려면 GET 요청을 반환된 대로 정확하게 전체 @odata.nextLink 값으로 보냅니다. 동일한 인증 헤더를 유지합니다.

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

참조:인덱스 나열

터미널 응답에는 최종 인덱스 이름이 포함되어 있고 @odata.nextLink는 생략되어 있으며, 이는 더 이상 페이지가 없음을 나타냅니다. 결과 순서는 커서 계약의 일부가 아닙니다.

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