Knowledge Sources - List Files
파일 지식 소스에 있는 모든 파일을 나열합니다.
GET {endpoint}/knowledgesources('{sourceName}')/files?api-version=2026-10-01
GET {endpoint}/knowledgesources('{sourceName}')/files?api-version=2026-10-01&prefix={prefix}&search={search}&pageSize={pageSize}&searchType=prefix
URI 매개 변수
| 속성 | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
검색 서비스의 엔드포인트 URL입니다. |
|
source
|
path | True |
string |
참조 자료의 이름입니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
|
page
|
query |
integer (int32) minimum: 1maximum: 3000 |
한 페이지에 반납할 수 있는 최대 항목 수. 서버는 최대값을 강제합니다; 만약 누락되면 적절한 기본값을 결정합니다. |
|
|
prefix
|
query |
string |
파일을 디렉터리와 유사한 경로로 필터링하는 선택적 접두사도 있습니다. |
|
|
search
|
query |
string |
목록을 좁혀 페이지 넘기는 결과를 줄이기 위한 문자열입니다. 만약 생략되거나 빈 줄이 통과되면 좁아짐이 적용되지 않습니다. |
|
|
search
|
query |
검색 매개변수가 어떻게 해석되는지 명시합니다. 현재는 '접두사'만 지원되고 있습니다. |
요청 헤더
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
요청에 대한 불투명하고 전역적으로 고유한 클라이언트 생성 문자열 식별자입니다. |
|
| Accept |
Accept 헤더입니다. |
응답
| 속성 | 형식 | Description |
|---|---|---|
| 200 OK |
요청이 성공했습니다. |
|
| Other Status Codes |
예기치 않은 오류 응답입니다. |
보안
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 |
예제
SearchServiceListKnowledgeSourceFiles
샘플 요청
GET https://typespecstableexampleservice.search.windows.net/knowledgesources('ks-stable-test')/files?api-version=2026-10-01&prefix=&search=&pageSize=&searchType=prefix
샘플 응답
{
"value": [
{
"fileId": "00000000-0000-0000-0000-000000000001",
"fileName": "notes/build26/kr-features.md",
"fileSizeBytes": 1184,
"createdAt": "2026-08-03T17:04:22Z",
"lastUpdatedAt": "2026-08-03T17:04:22Z",
"prefix": "notes/build26/",
"parsingMode": "markdown",
"extractionMode": "minimal",
"metadata": {
"team": "kr",
"source": "build26-notes"
}
}
]
}
정의
| 속성 | Description |
|---|---|
| Accept |
Accept 헤더입니다. |
|
Blob |
Azure Blob 데이터 원본에서 인덱싱하기 위한 구문 분석 모드를 나타냅니다. |
|
Error |
리소스 관리 오류 추가 정보 |
|
Error |
오류 세부 정보입니다. |
|
Error |
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다. |
|
File |
추출 작업은 개별 파일에 적용되었습니다. 'minimal'(기본값)은 내장 추출을 사용하고; 'standard'는 Content Understanding을 사용합니다. |
|
Knowledge |
파일 지식 소스에 업로드된 파일의 메타데이터. |
|
Listing |
검색 매개변수가 목록 결과 세트를 좁힐 때 어떻게 해석되는지 명시합니다. 현재는 '접두사'만 지원되고 있습니다. |
|
List |
리스트 파일 요청에 대한 응답. |
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 |
오류 추가 정보 |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상. |
ErrorResponse
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.
| 속성 | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
FileKnowledgeSourceExtractionMode
추출 작업은 개별 파일에 적용되었습니다. 'minimal'(기본값)은 내장 추출을 사용하고; 'standard'는 Content Understanding을 사용합니다.
| 값 | Description |
|---|---|
| minimal |
내장 추출 기능이 적용되었습니다. |
| standard |
콘텐츠 이해 추출이 수행되었습니다. |
KnowledgeSourceFile
파일 지식 소스에 업로드된 파일의 메타데이터.
| 속성 | 형식 | Description |
|---|---|---|
| createdAt |
string (date-time) |
파일이 생성된 타임스탬프입니다. |
| errorMessage |
string |
파일 처리 실패 시 오류 메시지, 그렇지 않으면 null 메시지. |
| extractionMode |
추출 모드가 파일에 적용되었습니다. |
|
| fileId |
string |
파일에 대한 고유 식별자입니다. |
| fileName |
string |
원본 파일 이름입니다. |
| fileSizeBytes |
integer (int64) |
파일 크기(바이트)입니다. |
| lastUpdatedAt |
string (date-time) |
파일이 마지막으로 업데이트된 타임스탬프입니다. |
| metadata |
object |
파일과 함께 저장된 커스텀 키/값 메타데이터. 반환되었지만 검색이나 필터링이 불가능합니다. |
| parsingMode |
파싱 모드가 파일에 적용되었고(파일에서 자동 감지됨), |
|
| prefix |
string |
접두사(디렉터리 유사 경로)는 전체 파일 이름에서 파생되었습니다. |
ListingSearchType
검색 매개변수가 목록 결과 세트를 좁힐 때 어떻게 해석되는지 명시합니다. 현재는 '접두사'만 지원되고 있습니다.
| 값 | Description |
|---|---|
| prefix |
검색 매개변수 값으로 이름이 시작하는 항목과 매칭합니다. |
ListKnowledgeSourceFilesResult
리스트 파일 요청에 대한 응답.
| 속성 | 형식 | Description |
|---|---|---|
| @odata.nextLink |
string |
다음 결과 집합을 가져오는 데 사용할 수 있는 URL입니다. |
| value |
파일 목록. |