Knowledge Sources - List Files
Tüm dosyaları bir Dosya bilgi kaynağında listeler.
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 Parametreleri
| Veri Akışı Adı | İçinde | Gerekli | Tür | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Arama hizmetinin uç nokta URL'si. |
|
source
|
path | True |
string |
Bilgi kaynağının adı. |
|
api-version
|
query | True |
string minLength: 1 |
Bu işlem için kullanılacak API sürümü. |
|
page
|
query |
integer (int32) minimum: 1maximum: 3000 |
Tek bir sayfada iade edilecek maksimum ürün sayısı. Sunucu maksimum bir zorunluluk uygular; eğer bu eksik edilirse, sunucu uygun bir varsayılan belirler. |
|
|
prefix
|
query |
string |
Dosyaları dizin benzeri yollarına göre filtrelemek için isteğe bağlı ön ek. |
|
|
search
|
query |
string |
Daha az sonucu sayfa gibi incelemek için listeyi daraltmak için kullanılan bir dizidir. Eğer atlanırsa veya boş bir dizi geçirilirse, daraltma uygulanmaz. |
|
|
search
|
query |
Arama parametresinin nasıl yorumlandığını belirtir. Şu anda sadece 'preek' destekleniyor. |
İstek Başlığı
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı. |
|
| Accept |
Accept başlığı. |
Yanıtlar
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| 200 OK |
İstek başarılı oldu. |
|
| Other Status Codes |
Beklenmeyen bir hata yanıtı. |
Güvenlik
api-key
Tür:
apiKey
İçinde:
header
OAuth2Auth
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Kapsamlar
| Veri Akışı Adı | Description |
|---|---|
| https://search.azure.com/.default |
Örnekler
SearchServiceListKnowledgeSourceFiles
Örnek isteği
GET https://typespecstableexampleservice.search.windows.net/knowledgesources('ks-stable-test')/files?api-version=2026-10-01&prefix=&search=&pageSize=&searchType=prefix
Örnek yanıt
{
"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"
}
}
]
}
Tanımlar
| Veri Akışı Adı | Description |
|---|---|
| Accept |
Accept başlığı. |
|
Blob |
Azure blob veri kaynağından dizin oluşturma için ayrıştırma modunu temsil eder. |
|
Error |
Kaynak yönetimi hatasına ilişkin ek bilgiler. |
|
Error |
Hata ayrıntısı. |
|
Error |
Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.). |
|
File |
Çıkarma çalışması bireysel bir dosyaya uygulandı. 'minimal' (varsayılan olarak) yerleşik çıkarma kullanır; 'standard' ise İçerik Anlama kullanır. |
|
Knowledge |
Dosya bilgi kaynağına yüklenen bir dosya için meta veriler. |
|
Listing |
Bir listeleme sonuç kümesini daraltırken arama parametresinin nasıl yorumlandığını belirtir. Şu anda sadece 'preek' destekleniyor. |
|
List |
List Files talebinden yanıt. |
Accept
Accept başlığı.
| Değer | Description |
|---|---|
| application/json;odata.metadata=minimal |
BlobIndexerParsingMode
Azure blob veri kaynağından dizin oluşturma için ayrıştırma modunu temsil eder.
| Değer | Description |
|---|---|
| default |
Normal dosya işleme için varsayılan olarak ayarlayın. |
| text |
Blob depolamadaki düz metin dosyalarında dizin oluşturma performansını geliştirmek için metne ayarlayın. |
| delimitedText |
Bloblar düz CSV dosyaları olduğunda delimitedText olarak ayarlayın. |
| json |
JSON dosyalarından yapılandırılmış içerik ayıklamak için json olarak ayarlayın. |
| jsonArray |
JSON dizisinin tek tek öğelerini ayrı belgeler olarak ayıklamak için jsonArray olarak ayarlayın. |
| jsonLines |
Ayrı ayrı JSON varlıklarını ayrı belgeler olarak, yeni bir satırla ayırarak ayıklamak için jsonLines olarak ayarlayın. |
| markdown |
Markdown dosyalarından içerik ayıklamak için markdown olarak ayarlayın. |
ErrorAdditionalInfo
Kaynak yönetimi hatasına ilişkin ek bilgiler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| info |
Ek bilgiler. |
|
| type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| additionalInfo |
Hata ek bilgisi. |
|
| code |
string |
Hata kodu. |
| details |
Hata ayrıntıları. |
|
| message |
string |
Hata iletisi. |
| target |
string |
Hata hedefi |
ErrorResponse
Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| error |
Hata nesnesi. |
FileKnowledgeSourceExtractionMode
Çıkarma çalışması bireysel bir dosyaya uygulandı. 'minimal' (varsayılan olarak) yerleşik çıkarma kullanır; 'standard' ise İçerik Anlama kullanır.
| Değer | Description |
|---|---|
| minimal |
Yerleşik çıkarma işlemi yapıldı. |
| standard |
İçerik Anlama çıkarımı gerçekleştirildi. |
KnowledgeSourceFile
Dosya bilgi kaynağına yüklenen bir dosya için meta veriler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| createdAt |
string (date-time) |
Dosyanın oluşturulduğu zaman damgası. |
| errorMessage |
string |
Dosya işleme başarısız olursa hata mesajı, aksi takdirde null olur. |
| extractionMode |
Dosyaya çıkarma modu uygulandı. |
|
| fileId |
string |
Dosyanın benzersiz tanımlayıcısı. |
| fileName |
string |
Orijinal dosya adı. |
| fileSizeBytes |
integer (int64) |
Bayt cinsinden dosya boyutu. |
| lastUpdatedAt |
string (date-time) |
Dosyanın en son güncellendiği zaman damgası. |
| metadata |
object |
Dosya ile birlikte saklanan özel anahtar/değer meta verileri. Geri döndüm ama aranabilir veya filtrelenemez. |
| parsingMode |
Dosyaya uygulanan ayrıştırma modu (dosyadan otomatik olarak algılanıyordu). |
|
| prefix |
string |
Ön ek (dizin benzeri yol) tam dosya adından türemiştir. |
ListingSearchType
Bir listeleme sonuç kümesini daraltırken arama parametresinin nasıl yorumlandığını belirtir. Şu anda sadece 'preek' destekleniyor.
| Değer | Description |
|---|---|
| prefix |
Adı arama parametresinin değeriyle başlayan öğeleri eşleştirir. |
ListKnowledgeSourceFilesResult
List Files talebinden yanıt.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.nextLink |
string |
Bir sonraki sonuç setini almak için kullanılabilecek URL. |
| value |
Dosyaların listesi. |