Knowledge Sources - Get File Ingestion Operation

파일 수집 작업의 상태와 성공 시 결과를 가져옵니다.

GET {endpoint}/knowledgesources('{sourceName}')/files/operations/{operationId}?api-version=2026-11-01-preview

URI 매개 변수

속성 In(다음 안에) 필수 형식 Description
endpoint
path True

string (uri)

검색 서비스의 엔드포인트 URL입니다.

operationId
path True

string

수집이 승인되었을 때 반환된 서버에서 생성된 식별자입니다.

sourceName
path True

string

참조 자료의 이름입니다.

api-version
query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

요청 헤더

속성 필수 형식 Description
x-ms-client-request-id

string (uuid)

요청에 대한 불투명하고 전역적으로 고유한 클라이언트 생성 문자열 식별자입니다.

Accept

Accept

Accept 헤더입니다.

응답

속성 형식 Description
200 OK

KnowledgeSourceFileIngestionOperation

요청이 성공했습니다.

헤더

Retry-After: integer

Other Status Codes

ErrorResponse

예기치 않은 오류 응답입니다.

보안

api-key

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

OAuth2Auth

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

범위

속성 Description
https://search.azure.com/.default

예제

SearchServiceGetKnowledgeSourceFileIngestionOperation

샘플 요청

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('hr-files')/files/operations/00000000-0000-0000-0000-000000000001?api-version=2026-11-01-preview


샘플 응답

{
  "id": "00000000-0000-0000-0000-000000000001",
  "kind": "knowledgeSourceFileIngestion",
  "status": "Succeeded",
  "result": {
    "fileId": "file-00000000000000000000000000000001",
    "fileName": "handbook.txt",
    "fileSizeBytes": 18,
    "createdAt": "2026-01-01T00:00:00Z",
    "lastUpdatedAt": "2026-01-02T00:00:00Z"
  }
}

정의

속성 Description
Accept

Accept 헤더입니다.

BlobIndexerParsingMode

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

ErrorAdditionalInfo

리소스 관리 오류 추가 정보

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

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

FileKnowledgeSourceExtractionMode

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

KnowledgeSourceFile

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

KnowledgeSourceFileIngestionError

파일 수집 실패로 반환된 오류입니다.

KnowledgeSourceFileIngestionOperation

지식 소스에서 파일의 비동기 업로드 또는 교체를 추적합니다.

OperationState

현재 상태입니다. 작업이 성공하거나 실패할 때까지 폴링을 계속하세요.

Accept

Accept 헤더입니다.

값 Description
application/json;odata.metadata=minimal

BlobIndexerParsingMode

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

값 Description
default

일반 파일 처리를 위해 기본값으로 설정합니다.

text

Blob Storage의 일반 텍스트 파일에서 인덱싱 성능을 향상시키려면 텍스트로 설정합니다.

delimitedText

Blob이 일반 CSV 파일인 경우 delimitedText로 설정합니다.

json

JSON 파일에서 구조적 콘텐츠를 추출하려면 json으로 설정합니다.

jsonArray

JSON 배열의 개별 요소를 별도의 문서로 추출하려면 jsonArray로 설정합니다.

jsonLines

새 줄로 구분된 개별 JSON 엔터티를 별도의 문서로 추출하려면 jsonLines로 설정합니다.

markdown

마크다운 파일에서 콘텐츠를 추출하려면 마크다운으로 설정합니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보

속성 형식 Description
info

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

속성 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상.

ErrorResponse

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

속성 형식 Description
error

ErrorDetail

오류 개체입니다.

FileKnowledgeSourceExtractionMode

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

값 Description
minimal

내장 추출 기능이 적용되었습니다.

standard

콘텐츠 이해 추출이 수행되었습니다.

KnowledgeSourceFile

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

속성 형식 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

접두사(디렉터리 유사 경로)는 전체 파일 이름에서 파생되었습니다.

KnowledgeSourceFileIngestionError

파일 수집 실패로 반환된 오류입니다.

속성 형식 Description
code

string

컴퓨터에서 읽을 수 있는 오류 코드입니다.

message

string

실패에 대한 설명입니다.

KnowledgeSourceFileIngestionOperation

지식 소스에서 파일의 비동기 업로드 또는 교체를 추적합니다.

속성 형식 Description
error

KnowledgeSourceFileIngestionError

다운로드 실패 시에만 표시되는 실패 세부 정보.

id

string

서버에서 생성된 작업 식별자.

kind enum:

knowledgeSourceFileIngestion

그런 작전이요.

result

KnowledgeSourceFile

수집이 성공할 때만 존재하는 파일 메타데이터입니다.

status

OperationState

현재 상태입니다. 작업이 성공하거나 실패할 때까지 폴링을 계속하세요.

OperationState

현재 상태입니다. 작업이 성공하거나 실패할 때까지 폴링을 계속하세요.

값 Description
NotStarted

작업이 시작되지 않았습니다.

Running

작업이 진행 중입니다.

Succeeded

작업이 성공적으로 완료되었습니다.

Failed

작업이 실패했습니다.

Canceled

사용자가 작업을 취소했습니다.