Knowledge Sources - Ingest File Replacement
Beginnt eine asynchrone Einfassung, die eine bestehende Datei in einer Dateiwissensquelle ersetzt, die auf einem Content Processor verarbeitet wird. Abfragen Sie die zurückgegebene Operation, um die aktualisierte Datei abzurufen.
POST {endpoint}/knowledgesources('{sourceName}')/files('{fileId}'):ingest?api-version=2026-11-01-preview
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
content
|
formData | True |
file |
Der rohe Dateiinhalt. |
|
metadata
|
formData | True |
string |
Die JSON-Metadaten, die die Datei beschreiben. |
|
endpoint
|
path | True |
string (uri) |
Die Endpunkt-URL des Suchdiensts. |
|
file
|
path | True |
string |
Die eindeutige Kennung der Datei, die aktualisiert werden soll. |
|
source
|
path | True |
string |
Der Name der Wissensquelle. |
|
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
Anforderungsheader
Media Types: "multipart/form-data"
| Name | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
Ein undurchsichtiger, global eindeutiger, clientgenerierter Zeichenfolgenbezeichner für die Anforderung. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 202 Accepted |
Die Antwort, wenn asynchrone Dateieingabe akzeptiert wird. Header
|
|
| Other Status Codes |
Unerwartete Fehlerantwort. |
Sicherheit
api-key
Typ:
apiKey
In:
header
OAuth2Auth
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| https://search.azure.com/.default |
Beispiele
SearchServiceIngestKnowledgeSourceFileReplacement
Beispielanforderung
POST https://typespecpreviewexampleservice.search.windows.net/knowledgesources('hr-files')/files('file-00000000000000000000000000000001'):ingest?api-version=2026-11-01-preview
Beispiel für eine Antwort
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"
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Blob |
Stellt den Analysemodus für die Indizierung aus einer Azure-Blobdatenquelle dar. |
|
Error |
Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung. |
|
Error |
Die Fehlerdetails. |
|
Error |
Häufige Fehlerantwort für alle Azure Resource Manager-APIs, um Fehlerdetails für fehlgeschlagene Vorgänge zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.) |
|
File |
Der Extraktionsprozess bezog sich auf eine einzelne Datei. 'minimal' (der Standard) verwendet eingebaute Extraktion; 'standard' verwendet Content Understanding. |
|
Knowledge |
Metadaten für eine Datei, die in eine Datei-Wissensquelle hochgeladen wird. |
|
Knowledge |
Der Fehler, der durch eine fehlgeschlagene Datei-Eingabeoperation zurückgekehrt wurde. |
|
Knowledge |
Verfolgt das asynchrone Hoch- oder Ersetzen einer Datei in einer Wissensquelle. |
|
Operation |
Der aktuelle Zustand. Abfrage durchführen, bis die Operation erfolgreich oder fehlschlägt. |
BlobIndexerParsingMode
Stellt den Analysemodus für die Indizierung aus einer Azure-Blobdatenquelle dar.
| Wert | Beschreibung |
|---|---|
| default |
Standardeinstellung für die normale Dateiverarbeitung. |
| text |
Legen Sie diesen Wert auf Text fest, um die Indizierungsleistung für Nur-Text-Dateien im BLOB-Speicher zu verbessern. |
| delimitedText |
Legen Sie diese Eigenschaft auf "delimitedText" fest, wenn Blobs einfache CSV-Dateien sind. |
| json |
Legen Sie auf json fest, um strukturierte Inhalte aus JSON-Dateien zu extrahieren. |
| jsonArray |
Legen Sie "jsonArray" fest, um einzelne Elemente eines JSON-Arrays als separate Dokumente zu extrahieren. |
| jsonLines |
Legen Sie auf jsonLines fest, um einzelne JSON-Entitäten zu extrahieren, getrennt durch eine neue Zeile, als separate Dokumente. |
| markdown |
Legen Sie diese Option auf Markdown fest, um Inhalte aus Markdowndateien zu extrahieren. |
ErrorAdditionalInfo
Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.
| Name | Typ | Beschreibung |
|---|---|---|
| info |
Zusätzliche Informationen. |
|
| type |
string |
Typ der Zusatzinformationen. |
ErrorDetail
Die Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| additionalInfo |
Die Zusatzinformationen zum Fehler. |
|
| code |
string |
Der Fehlercode. |
| details |
Die Fehlerdetails. |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Der Fehlerzielwert. |
ErrorResponse
Häufige Fehlerantwort für alle Azure Resource Manager-APIs, um Fehlerdetails für fehlgeschlagene Vorgänge zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Das Fehlerobjekt. |
FileKnowledgeSourceExtractionMode
Der Extraktionsprozess bezog sich auf eine einzelne Datei. 'minimal' (der Standard) verwendet eingebaute Extraktion; 'standard' verwendet Content Understanding.
| Wert | Beschreibung |
|---|---|
| minimal |
Eine eingebaute Extraktion wurde durchgeführt. |
| standard |
Die Extraktion des Inhaltsverstehens wurde durchgeführt. |
KnowledgeSourceFile
Metadaten für eine Datei, die in eine Datei-Wissensquelle hochgeladen wird.
| Name | Typ | Beschreibung |
|---|---|---|
| createdAt |
string (date-time) |
Der Zeitstempel, als die Datei erstellt wurde. |
| errorMessage |
string |
Die Fehlermeldung, wenn die Dateiverarbeitung fehlgeschlagen hat, ist sonst null. |
| extractionMode |
Der Extrahiermodus wurde auf die Datei angewendet. |
|
| fileId |
string |
Die eindeutige Kennung der Datei. |
| fileName |
string |
Der ursprüngliche Dateiname. |
| fileSizeBytes |
integer (int64) |
Die Größe der Datei in Byte. |
| lastUpdatedAt |
string (date-time) |
Der Zeitstempel, als die Datei zuletzt aktualisiert wurde. |
| metadata |
object |
Benutzerdefinierte Schlüssel-/Wertmetadaten, die mit der Datei gespeichert sind. Zurückgegeben, aber nicht durchsuchbar oder filterbar. |
| parsingMode |
Der Parsing-Modus wurde auf die Datei angewendet (automatisch aus der Datei erkannt). |
|
| prefix |
string |
Das Präfix (verzeichnisartiger Pfad) leitet sich vom vollständigen Dateinamen ab. |
KnowledgeSourceFileIngestionError
Der Fehler, der durch eine fehlgeschlagene Datei-Eingabeoperation zurückgekehrt wurde.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Ein computerlesbarer Fehlercode. |
| message |
string |
Eine Beschreibung des Versagens. |
KnowledgeSourceFileIngestionOperation
Verfolgt das asynchrone Hoch- oder Ersetzen einer Datei in einer Wissensquelle.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Die Fehlerdetails, die nur beim Fehlschließ der Aufnahme auftreten. |
|
| id |
string |
Die vom Server generierte Operationsidenz. |
| kind |
enum:
knowledge |
Die Art von Operation. |
| result |
Die Dateimetadaten, die nur beim erfolgreichen Ingestium vorhanden sind. |
|
| status |
Der aktuelle Zustand. Abfrage durchführen, bis die Operation erfolgreich oder fehlschlägt. |
OperationState
Der aktuelle Zustand. Abfrage durchführen, bis die Operation erfolgreich oder fehlschlägt.
| Wert | Beschreibung |
|---|---|
| NotStarted |
Der Vorgang wurde noch nicht gestartet. |
| Running |
Der Vorgang wird ausgeführt. |
| Succeeded |
Der Vorgang wurde erfolgreich abgeschlossen. |
| Failed |
Beim Vorgang ist ein Fehler aufgetreten. |
| Canceled |
Der Vorgang wurde vom Benutzer abgebrochen. |