Knowledge Sources - Upload File

Service:
Search Service
API-versie:
2026-08-01-preview

Uploadt een bestand naar een kennisbron voor verwerking en indexering.

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

URI-parameters

Name In Vereist Type Description
endpoint
 path True

string (uri)

De eindpunt-URL van de zoekservice.
sourceName
 path True

string

De naam van de kennisbron.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagkoptekst

Media Types: "application/octet-stream"

Name Vereist Type Description
Content-Disposition True

string

De Content-Disposition-header specificeert de bestandsnaam van het geüploade bestand. Moet het format volgen: attachment; filename="<filename>". Bijvoorbeeld: attachment; filename="installation-guide.pdf".
x-ms-client-request-id

string (uuid)

Een ondoorzichtige, wereldwijd unieke, door de client gegenereerde tekenreeks-id voor de aanvraag.

Aanvraagbody

Media Types: "application/octet-stream"

Name Type Description
file

string (binary)

De inhoud van het bestand om te uploaden.

Antwoorden

Name Type Description
201 Created

KnowledgeSourceFile

De aanvraag is geslaagd en er is een nieuwe resource gemaakt.
Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

api-key

Type: apiKey
In: header

OAuth2Auth

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiken

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

Voorbeelden

SearchServiceUploadKnowledgeSourceFile

Voorbeeldaanvraag

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



"U2FtcGxlIGZpbGUgY29udGVudCBmb3IgdXBsb2FkLg=="

Voorbeeldrespons

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

Definities

Name Description
BlobIndexerParsingMode

Vertegenwoordigt de parseermodus voor indexering vanuit een Azure-blobgegevensbron.
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

Het foutdetail.
ErrorResponse

Veelvoorkomende foutreactie voor alle Azure Resource Manager-API's om foutdetails te retourneren voor mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)
FileKnowledgeSourceExtractionMode

De extractie-inspanning gold voor een individueel bestand. 'minimal' (de standaard) gebruikt ingebouwde extractie; 'standaard' gebruikt Content Understanding.
KnowledgeSourceFile

Metadata voor een bestand dat is geüpload naar een kennisbron van bestanden.

BlobIndexerParsingMode

Opsomming

Vertegenwoordigt de parseermodus voor indexering vanuit een Azure-blobgegevensbron.

Waarde Description
default

Ingesteld op standaard voor normale bestandsverwerking.
text

Ingesteld op tekst om de indexeringsprestaties voor tekstbestanden zonder opmaak in blobopslag te verbeteren.
delimitedText

Ingesteld op delimitedText wanneer blobs gewone CSV-bestanden zijn.
json

Ingesteld op json om gestructureerde inhoud uit JSON-bestanden te extraheren.
jsonArray

Ingesteld op jsonArray om afzonderlijke elementen van een JSON-matrix als afzonderlijke documenten te extraheren.
jsonLines

Stel deze optie in op jsonLines om afzonderlijke JSON-entiteiten te extraheren, gescheiden door een nieuwe regel, als afzonderlijke documenten.
markdown

Stel in op markdown om inhoud uit markdown-bestanden te extraheren.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

Het foutdetail.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

Aanvullende informatie over de fout.
code

string

De foutcode.
details

ErrorDetail[]

De foutgegevens.
message

string

Het foutbericht.
target

string

Het foutdoelwit.

ErrorResponse

Object

Veelvoorkomende foutreactie voor alle Azure Resource Manager-API's om foutdetails te retourneren voor mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)

Name Type Description
error

ErrorDetail

Het foutobject.

FileKnowledgeSourceExtractionMode

Opsomming

De extractie-inspanning gold voor een individueel bestand. 'minimal' (de standaard) gebruikt ingebouwde extractie; 'standaard' gebruikt Content Understanding.

Waarde Description
minimal

Er werd een ingebouwde extractie uitgevoerd.
standard

Content Understanding extractie werd uitgevoerd.

KnowledgeSourceFile

Object

Metadata voor een bestand dat is geüpload naar een kennisbron van bestanden.

Name Type Description
createdAt

string (date-time)

De tijdstempel waarop het bestand werd aangemaakt.
errorMessage

string

De foutmelding als bestandsverwerking mislukte, anders nul.
extractionMode

FileKnowledgeSourceExtractionMode

De extractiemodus werd toegepast op het bestand.
fileId

string

De unieke identificatiecode van het bestand.
fileName

string

De oorspronkelijke bestandsnaam.
fileSizeBytes

integer (int64)

De bestandsgrootte in bytes.
lastUpdatedAt

string (date-time)

De tijdstempel wanneer het bestand voor het laatst werd bijgewerkt.
metadata

object

Aangepaste sleutel-/waardemetadata die bij het bestand wordt opgeslagen. Geretourneerd maar niet doorzoekbaar of filterbaar.
parsingMode

BlobIndexerParsingMode

De parsingmodus werd toegepast op het bestand (automatisch gedetecteerd vanuit het bestand).
prefix

string

Het voorvoegsel (mapachtig pad) is afgeleid van de volledige bestandsnaam.