Indexers - Resync

서비스:: Search Service

API 버전:: 2026-08-01-preview

인덱서가 다시 인제스트할 수 있도록 데이터 소스에서 선택적 옵션을 재동기화합니다."

POST {endpoint}/indexers('{indexerName}')/search.resync?api-version=2026-08-01-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string (uri)	검색 서비스의 엔드포인트 URL입니다.
indexerName	path	True	string	인덱서의 이름입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 헤더

Name	필수	형식	Description
Accept		Accept	Accept 헤더입니다.
x-ms-client-request-id		string (uuid)	요청에 대한 불투명하고 전역적으로 고유한 클라이언트 생성 문자열 식별자입니다.

요청 본문

Name	형식	Description
options	IndexerResyncOption[]	데이터 원본에서 미리 정의된 옵션을 다시 동기화합니다.

응답

Name	형식	Description
204 No Content		이 요청에 대해 보낼 콘텐츠는 없지만 헤더가 유용할 수 있습니다.
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

api-key

형식: apiKey
In(다음 안에): header

OAuth2Auth

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

범위

Name	Description
https://search.azure.com/.default

예제

SearchServiceResync

샘플 요청

HTTP

POST https://typespecpreviewexampleservice.search.windows.net/indexers('myaclindexer')/search.resync?api-version=2026-08-01-preview



{
  "options": [
    "permissions"
  ]
}

샘플 응답

상태 코드:: 204

정의

Name	Description
Accept	Accept 헤더입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.
IndexerResyncBody	재동기화 인덱서 작동을 요청하는 본체.
IndexerResyncOption	인덱싱할 다양한 유형의 권한 데이터가 있는 옵션입니다.

Accept

열거형

Accept 헤더입니다.

값	Description
application/json;odata.metadata=minimal

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보

Name	형식	Description
info		추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상.

ErrorResponse

Object

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

IndexerResyncBody

Object

재동기화 인덱서 작동을 요청하는 본체.

Name	형식	Description
options	IndexerResyncOption[]	데이터 원본에서 미리 정의된 옵션을 다시 동기화합니다.

IndexerResyncOption

열거형

인덱싱할 다양한 유형의 권한 데이터가 있는 옵션입니다.

값	Description
permissions	인덱서는 데이터 원본에서 인덱스로 미리 선택한 권한 데이터를 다시 수집합니다.