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.

fileId
path True

string

Dosyanın güncellenmesi gereken benzersiz tanımlayıcı.

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: "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

KnowledgeSourceFileIngestionOperation

Asenkron dosya alımı kabul edildiğinde verilen yanıt.

Üst Bilgiler

  • Operation-Id: string
  • Operation-Location: string
  • Retry-After: integer
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

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

KnowledgeSourceFileIngestionError

Başarısız bir dosya alma işlemi tarafından döndürülen hata.

KnowledgeSourceFileIngestionOperation

Bilgi kaynağında dosyanın eşzamansız olarak yüklenmesini veya değiştirilmesini izler.

OperationState

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

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.

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

KnowledgeSourceFileIngestionError

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:

knowledgeSourceFileIngestion

Böyle bir operasyon.

result

KnowledgeSourceFile

Dosya meta verileri, yalnızca alım başarılı olduğunda görünür.

status

OperationState

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.