Knowledge Sources - Ingest File Replacement
İçerik İşlemcide işlenen ve Dosya bilgi kaynağında mevcut bir dosyanın yerine geçen eşzamansız alım başlatır. Güncellenmiş dosyayı almak için dönen işlemi sorgulayın.
POST {endpoint}/knowledgesources('{sourceName}')/files('{fileId}'):ingest?api-version=2026-11-01-preview
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. |
|
file
|
path | True |
string |
Dosyanın güncellenmesi gereken benzersiz tanımlayıcı. |
|
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 |
|---|---|---|
| 202 Accepted |
Asenkron dosya alımı kabul edildiğinde verilen yanıt. Üst Bilgiler
|
|
| 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
SearchServiceIngestKnowledgeSourceFileReplacement
Örnek isteği
POST https://typespecpreviewexampleservice.search.windows.net/knowledgesources('hr-files')/files('file-00000000000000000000000000000001'):ingest?api-version=2026-11-01-preview
Örnek yanıt
Operation-Id: 00000000-0000-0000-0000-000000000001
Operation-Location: https://typespecpreviewexampleservice.search.windows.net/knowledgesources('hr-files')/files/operations/00000000-0000-0000-0000-000000000001?api-version=2026-11-01-preview
Retry-After: 30
{
"id": "00000000-0000-0000-0000-000000000001",
"kind": "knowledgeSourceFileIngestion",
"status": "Running"
}
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. |
|
Knowledge |
Başarısız bir dosya alma işlemi tarafından döndürülen hata. |
|
Knowledge |
Bilgi kaynağında dosyanın eşzamansız olarak yüklenmesini veya değiştirilmesini izler. |
|
Operation |
Geçerli durum. İşlem başarılı olana veya başarısız olana kadar anket yapın. |
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. |
KnowledgeSourceFileIngestionError
Başarısız bir dosya alma işlemi tarafından döndürülen hata.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| code |
string |
Makine tarafından okunabilir bir hata kodu. |
| message |
string |
Başarısızlığın bir tanımı. |
KnowledgeSourceFileIngestionOperation
Bilgi kaynağında dosyanın eşzamansız olarak yüklenmesini veya değiştirilmesini izler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| error |
Başarısızlık detayları, yalnızca alım başarısız olduğunda ortaya çıkar. |
|
| id |
string |
Sunucu tarafından oluşturulan işlem tanımlayıcısı. |
| kind |
enum:
knowledge |
Böyle bir operasyon. |
| result |
Dosya meta verileri, yalnızca alım başarılı olduğunda görünür. |
|
| status |
Geçerli durum. İşlem başarılı olana veya başarısız olana kadar anket yapın. |
OperationState
Geçerli durum. İşlem başarılı olana veya başarısız olana kadar anket yapın.
| Değer | Description |
|---|---|
| NotStarted |
İşlem başlatılmadı. |
| Running |
İşlem devam ediyor. |
| Succeeded |
İşlem başarıyla tamamlandı. |
| Failed |
İşlem başarısız oldu. |
| Canceled |
İşlem kullanıcı tarafından iptal edildi. |