Indexers - Reset Docs

서비스:: Search Service

API 버전:: 2025-11-01-preview

인덱서에서 선택적으로 다시 수집하도록 데이터 원본의 특정 문서를 다시 설정합니다.

POST {endpoint}/indexers('{indexerName}')/search.resetdocs?api-version=2025-11-01-preview

선택적 매개 변수:

POST {endpoint}/indexers('{indexerName}')/search.resetdocs?api-version=2025-11-01-preview&overwrite={overwrite}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string (uri)	검색 서비스의 엔드포인트 URL입니다.
indexerName	path	True	string	인덱서의 이름입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.
overwrite	query		boolean	false인 경우 키 또는 ID가 기존 키나 ID에 추가됩니다. true인 경우 이 페이로드의 키 또는 ID만 다시 수집하기 위해 대기열에 대기됩니다.

요청 헤더

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

요청 본문

Name	형식	Description
datasourceDocumentIds	string[]	재설정할 데이터 소스 문서 식별자
documentKeys	string[]	재설정할 문서 키

응답

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

예제

SearchServiceResetDocs

샘플 요청

HTTP

POST https://previewexampleservice.search.windows.net/indexers('myindexer')/search.resetdocs?api-version=2025-11-01-preview&overwrite=True


{
  "documentKeys": [
    "1",
    "2",
    "3"
  ]
}

샘플 응답

상태 코드:: 204

정의

Name	Description
Accept	Accept 헤더입니다.
DocumentKeysOrIds	키의 종류가 어떻게 되나요?
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.

Accept

열거형

Accept 헤더입니다.

값	Description
application/json;odata.metadata=minimal

DocumentKeysOrIds

Object

키의 종류가 어떻게 되나요?

Name	형식	Description
datasourceDocumentIds	string[]	재설정할 데이터 소스 문서 식별자
documentKeys	string[]	재설정할 문서 키

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	오류 개체입니다.