Knowledge Sources - Get File Ingestion Operation
Dosya alma işleminin durumunu ve başarılı olduğunda sonucunu alır.
GET {endpoint}/knowledgesources('{sourceName}')/files/operations/{operationId}?api-version=2026-11-01-preview
URI Parametreleri
| Veri Akışı Adı | İçinde | Gerekli | Tür | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Arama hizmetinin uç nokta URL'si. |
|
operation
|
path | True |
string |
Alım kabul edildiğinde döndürülen sunucu tarafından oluşturulan 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ığı
| 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 başlığı. |
Yanıtlar
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| 200 OK |
İstek başarılı oldu. Üst Bilgiler Retry-After: integer |
|
| 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
SearchServiceGetKnowledgeSourceFileIngestionOperation
Örnek isteği
GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('hr-files')/files/operations/00000000-0000-0000-0000-000000000001?api-version=2026-11-01-preview
Örnek yanıt
{
"id": "00000000-0000-0000-0000-000000000001",
"kind": "knowledgeSourceFileIngestion",
"status": "Succeeded",
"result": {
"fileId": "file-00000000000000000000000000000001",
"fileName": "handbook.txt",
"fileSizeBytes": 18,
"createdAt": "2026-01-01T00:00:00Z",
"lastUpdatedAt": "2026-01-02T00:00:00Z"
}
}
Tanımlar
| Veri Akışı Adı | Description |
|---|---|
| Accept |
Accept başlığı. |
|
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. |
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 |
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. |