Knowledge Sources - Upload File

Hizmet:: Search Service

API Sürümü:: 2026-08-01-preview

İşleme ve indeksleme için bir dosya bilgi kaynağına bir dosya yükler.

POST {endpoint}/knowledgesources('{sourceName}')/files?api-version=2026-08-01-preview

URI Parametreleri

Name	İç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ü.

İstek Başlığı

Media Types: "application/octet-stream"

Name	Gerekli	Tür	Description
Content-Disposition	True	string	Yüklenen dosyanın dosya adını belirten İçerik-Dağıtlama başlığı. Formatı takip etmelidir: `attachment; filename="<filename>"`. Örneğin: `attachment; filename="installation-guide.pdf"`.
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ı.

İstek Gövdesi

Media Types: "application/octet-stream"

Name	Tür	Description
file	string (binary)	Dosya içeriği yükleniyor.

Yanıtlar

Name	Tür	Description
201 Created	KnowledgeSourceFile	İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
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

Name	Description
https://search.azure.com/.default

Örnekler

SearchServiceUploadKnowledgeSourceFile

Örnek isteği

HTTP

POST https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')/files?api-version=2026-08-01-preview



"U2FtcGxlIGZpbGUgY29udGVudCBmb3IgdXBsb2FkLg=="

Örnek yanıt

Durum kodu:: 201

{
  "fileId": "00000000-0000-0000-0000-000000000001",
  "fileName": "kr-features.md",
  "fileSizeBytes": 31,
  "createdAt": "2026-01-01T00:00:00Z",
  "lastUpdatedAt": "2026-01-02T00:00:00Z",
  "metadata": {
    "team": "kr",
    "source": "build26-notes"
  },
  "parsingMode": "markdown",
  "extractionMode": "minimal"
}

Tanımlar

Name	Description
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.

BlobIndexerParsingMode

Numaralandırma

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

Nesne

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

Name	Tür	Description
info		Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	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

Nesne

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

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

FileKnowledgeSourceExtractionMode

Numaralandırma

Çı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

Nesne

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

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