Knowledge Sources - Upload File Multipart
Dosyayı çok parçalı/form-veri kullanarak bir dosya bilgi kaynağına yükler: bir JSON 'metadata' parçası (dosya adı ve özel metadata) ve ham dosya baytlarıyla birlikte bir 'içerik' bölümü.
POST {endpoint}/knowledgesources('{sourceName}')/files?api-version=2026-10-01
URI Parametreleri
| Veri Akışı Adı | İçinde | Gerekli | Tür | Description |
|---|---|---|---|---|
|
content
|
formData | True |
file |
Ham dosya içeriği. |
|
metadata
|
formData | True |
string |
Dosyayı tanımlayan JSON meta verileri. |
|
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ü. |
İstek Başlığı
Media Types: "multipart/form-data"
| 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ı. |
Yanıtlar
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| 201 Created |
İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu. |
|
| 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
SearchServiceUploadKnowledgeSourceFileMultipart
Örnek isteği
POST https://typespecstableexampleservice.search.windows.net/knowledgesources('ks-stable-test')/files?api-version=2026-10-01
Örnek yanıt
{
"fileId": "00000000-0000-0000-0000-000000000001",
"fileName": "notes/build26/kr-features.md",
"fileSizeBytes": 59,
"createdAt": "2026-01-01T00:00:00Z",
"lastUpdatedAt": "2026-01-02T00:00:00Z",
"prefix": "notes/build26/",
"metadata": {
"team": "kr",
"source": "build26-notes"
},
"parsingMode": "markdown",
"extractionMode": "minimal"
}
Tanımlar
| Veri Akışı Adı | Description |
|---|---|
|
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. |
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. |