Knowledge Sources - Upload File

Tjänst:: Search Service

API-version:: 2026-05-01-preview

Laddar upp en fil till en filkunskapskälla för bearbetning och indexering.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string (uri)	Slutpunkts-URL:en för söktjänsten.
sourceName	path	True	string	Namnet på kunskapskällan.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandehuvud

Media Types: "application/octet-stream"

Name	Obligatorisk	Typ	Description
Content-Disposition	True	string	Content-Disposition-headern specificerar filnamnet på den uppladdade filen. Måste följa formatet: `attachment; filename="<filename>"`. Till exempel: `attachment; filename="installation-guide.pdf"`.
x-ms-client-request-id		string (uuid)	En ogenomskinlig, globalt unik, klientgenererad strängidentifierare för begäran.

Begärandetext

Media Types: "application/octet-stream"

Name	Typ	Description
file	string (binary)	Filinnehållet att ladda upp.

Svar

Name	Typ	Description
201 Created	KnowledgeSourceFile	Begäran har slutförts och en ny resurs har skapats som ett resultat.
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

api-key

Typ: apiKey
I: header

OAuth2Auth

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Omfattningar

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

Exempel

SearchServiceUploadKnowledgeSourceFile

Exempelbegäran

HTTP

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



"dGVzdCBmaWxlIGNvbnRlbnQ="

Exempelsvar

Statuskod:: 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
}

Definitioner

Name	Description
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).
KnowledgeSourceFile	Metadata för en fil som laddas upp till en filkunskapskälla.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info		Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).

Name	Typ	Description
error	ErrorDetail	Felobjektet.

KnowledgeSourceFile

Objekt

Metadata för en fil som laddas upp till en filkunskapskälla.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln när filen skapades.
errorMessage	string	Felmeddelandet om filbehandlingen misslyckades, annars är det noll.
fileId	string	Den unika identifieraren för filen.
fileName	string	Det ursprungliga filnamnet.
fileSizeBytes	integer (int64)	Filstorleken i byte.
lastUpdatedAt	string (date-time)	Tidsstämpeln när filen senast uppdaterades.