Knowledge Sources - Update File

서비스:: Search Service

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

파일 지식 소스에 있는 기존 파일을 업데이트하여 인덱스된 내용을 대체합니다. 멀티파트/폼-데이터를 사용합니다: JSON '메타데이터' 부분(파일 이름 및 맞춤 메타데이터)과 원시 파일 바이트가 포함된 'content' 부분.

PUT {endpoint}/knowledgesources('{sourceName}')/files('{fileId}')?api-version=2026-08-01-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
content	formData	True	file	원시 파일 내용.
metadata	formData	True	string	파일을 설명하는 JSON 메타데이터입니다.
endpoint	path	True	string (uri)	검색 서비스의 엔드포인트 URL입니다.
fileId	path	True	string	업데이트할 파일의 고유 식별자.
sourceName	path	True	string	참조 자료의 이름입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 헤더

Media Types: "multipart/form-data"

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

응답

Name	형식	Description
200 OK	KnowledgeSourceFile	요청이 성공했습니다.
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

예제

SearchServiceUpdateKnowledgeSourceFile

샘플 요청

HTTP

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')/files('00000000-0000-0000-0000-000000000001')?api-version=2026-08-01-preview

샘플 응답

상태 코드:: 200

{
  "fileId": "00000000-0000-0000-0000-000000000001",
  "fileName": "notes/build26/kr-features.md",
  "fileSizeBytes": 43,
  "createdAt": "2026-08-03T17:04:22Z",
  "lastUpdatedAt": "2026-01-02T00:00:00Z",
  "prefix": "notes/build26/",
  "metadata": {
    "team": "kr",
    "source": "build26-notes"
  },
  "parsingMode": "markdown",
  "extractionMode": "minimal"
}

정의

Name	Description
BlobIndexerParsingMode	Azure Blob 데이터 원본에서 인덱싱하기 위한 구문 분석 모드를 나타냅니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.
FileKnowledgeSourceExtractionMode	추출 작업은 개별 파일에 적용되었습니다. 'minimal'(기본값)은 내장 추출을 사용하고; 'standard'는 Content Understanding을 사용합니다.
KnowledgeSourceFile	파일 지식 소스에 업로드된 파일의 메타데이터.

BlobIndexerParsingMode

열거형

Azure Blob 데이터 원본에서 인덱싱하기 위한 구문 분석 모드를 나타냅니다.

값	Description
default	일반 파일 처리를 위해 기본값으로 설정합니다.
text	Blob Storage의 일반 텍스트 파일에서 인덱싱 성능을 향상시키려면 텍스트로 설정합니다.
delimitedText	Blob이 일반 CSV 파일인 경우 delimitedText로 설정합니다.
json	JSON 파일에서 구조적 콘텐츠를 추출하려면 json으로 설정합니다.
jsonArray	JSON 배열의 개별 요소를 별도의 문서로 추출하려면 jsonArray로 설정합니다.
jsonLines	새 줄로 구분된 개별 JSON 엔터티를 별도의 문서로 추출하려면 jsonLines로 설정합니다.
markdown	마크다운 파일에서 콘텐츠를 추출하려면 마크다운으로 설정합니다.

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

FileKnowledgeSourceExtractionMode

열거형

추출 작업은 개별 파일에 적용되었습니다. 'minimal'(기본값)은 내장 추출을 사용하고; 'standard'는 Content Understanding을 사용합니다.

값	Description
minimal	내장 추출 기능이 적용되었습니다.
standard	콘텐츠 이해 추출이 수행되었습니다.

KnowledgeSourceFile

Object

파일 지식 소스에 업로드된 파일의 메타데이터.

Name	형식	Description
createdAt	string (date-time)	파일이 생성된 타임스탬프입니다.
errorMessage	string	파일 처리 실패 시 오류 메시지, 그렇지 않으면 null 메시지.
extractionMode	FileKnowledgeSourceExtractionMode	추출 모드가 파일에 적용되었습니다.
fileId	string	파일에 대한 고유 식별자입니다.
fileName	string	원본 파일 이름입니다.
fileSizeBytes	integer (int64)	파일 크기(바이트)입니다.
lastUpdatedAt	string (date-time)	파일이 마지막으로 업데이트된 타임스탬프입니다.
metadata	object	파일과 함께 저장된 커스텀 키/값 메타데이터. 반환되었지만 검색이나 필터링이 불가능합니다.
parsingMode	BlobIndexerParsingMode	파싱 모드가 파일에 적용되었고(파일에서 자동 감지됨),
prefix	string	접두사(디렉터리 유사 경로)는 전체 파일 이름에서 파생되었습니다.