Knowledge Sources - Upload File

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

Uploadt een bestand naar een kennisbron voor verwerking en indexering.

POST {endpoint}/knowledgesources('{sourceName}')/files?api-version=2026-05-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://previewexampleservice.search.windows.net/knowledgesources('ks-file-test')/files?api-version=2026-05-01-preview



"dGVzdCBmaWxlIGNvbnRlbnQ="

Voorbeeldrespons

Statuscode:
201 
{
  "fileId": "00000000-0000-0000-0000-000000000001",
  "fileName": "example.pdf",
  "fileSizeBytes": 12345,
  "createdAt": "2026-01-01T00:00:00Z",
  "lastUpdatedAt": "2026-01-01T00:00:00Z",
  "errorMessage": null
}

Definities

Name Description
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.)
KnowledgeSourceFile

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

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.

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