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.

sourceName
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ü.

pageSize
query

integer (int32)

minimum: 1
maximum: 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.

searchType
query

ListingSearchType

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

Accept başlığı.

Yanıtlar

Veri Akışı Adı Tür Description
200 OK

ListKnowledgeSourceFilesResult

İstek başarılı oldu.

Other Status Codes

ErrorResponse

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ığı.

BlobIndexerParsingMode

Azure blob veri kaynağından dizin oluşturma için ayrıştırma modunu temsil eder.

ErrorAdditionalInfo

Kaynak yönetimi hatasına ilişkin ek bilgiler.

ErrorDetail

Hata ayrıntısı.

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.).

FileKnowledgeSourceExtractionMode

Çıkarma çalışması bireysel bir dosyaya uygulandı. 'minimal' (varsayılan olarak) yerleşik çıkarma kullanır; 'standard' ise İçerik Anlama kullanır.

KnowledgeSourceFile

Dosya bilgi kaynağına yüklenen bir dosya için meta veriler.

ListingSearchType

Bir listeleme sonuç kümesini daraltırken arama parametresinin nasıl yorumlandığını belirtir. Şu anda sadece 'preek' destekleniyor.

ListKnowledgeSourceFilesResult

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

ErrorAdditionalInfo[]

Hata ek bilgisi.

code

string

Hata kodu.

details

ErrorDetail[]

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

ErrorDetail

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

FileKnowledgeSourceExtractionMode

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

BlobIndexerParsingMode

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

KnowledgeSourceFile[]

Dosyaların listesi.