Knowledge Sources - Upload File

서비스:: Search Service

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

파일 지식 소스에 파일을 업로드하여 처리 및 색인화합니다.

POST {endpoint}/knowledgesources('{sourceName}')/files?api-version=2026-05-01-preview

URI 매개 변수

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

요청 헤더

Media Types: "application/octet-stream"

Name	필수	형식	Description
Content-Disposition	True	string	업로드된 파일의 파일명을 지정하는 Content-Disposition 헤더. 다음 형식을 따라야 합니다: `attachment; filename="<filename>"`. 예: `attachment; filename="installation-guide.pdf"`.
x-ms-client-request-id		string (uuid)	요청에 대한 불투명하고 전역적으로 고유한 클라이언트 생성 문자열 식별자입니다.

요청 본문

Media Types: "application/octet-stream"

Name	형식	Description
file	string (binary)	업로드할 파일 내용.

응답

Name	형식	Description
201 Created	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

예제

SearchServiceUploadKnowledgeSourceFile

샘플 요청

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources('ks-file-test')/files?api-version=2026-05-01-preview



"dGVzdCBmaWxlIGNvbnRlbnQ="

샘플 응답

상태 코드:: 201

{
  "fileId": "00000000-0000-0000-0000-000000000001",
  "fileName": "example.pdf",
  "fileSizeBytes": 12345,
  "createdAt": "2026-01-01T00:00:00Z",
  "lastUpdatedAt": "2026-01-01T00:00:00Z",
  "errorMessage": null
}

정의

Name	Description
ErrorAdditionalInfo	리소스 관리 오류 추가 정보
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.
KnowledgeSourceFile	파일 지식 소스에 업로드된 파일의 메타데이터.

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

KnowledgeSourceFile

Object

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

Name	형식	Description
createdAt	string (date-time)	파일이 생성된 타임스탬프입니다.
errorMessage	string	파일 처리 실패 시 오류 메시지, 그렇지 않으면 null 메시지.
fileId	string	파일에 대한 고유 식별자입니다.
fileName	string	원본 파일 이름입니다.
fileSizeBytes	integer (int64)	파일 크기(바이트)입니다.
lastUpdatedAt	string (date-time)	파일이 마지막으로 업데이트된 타임스탬프입니다.