Knowledge Sources - Upload File

Tjänst:
Search Service
API-version:
2026-08-01-preview

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

POST {endpoint}/knowledgesources('{sourceName}')/files?api-version=2026-08-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
x-ms-client-request-id

string (uuid)

En ogenomskinlig, globalt unik, klientgenererad strängidentifierare för begäran.
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".

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

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



"U2FtcGxlIGZpbGUgY29udGVudCBmb3IgdXBsb2FkLg=="

Exempelsvar

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

Definitioner

Name Description
BlobIndexerParsingMode

Representerar parsningsläget för indexering från en Azure Blob Data-källa.
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.).
FileKnowledgeSourceExtractionMode

Extraktionsarbetet tillämpades på en enskild fil. 'minimal' (standard) använder inbyggd extraktion; 'standard' använder Content Understanding.
KnowledgeSourceFile

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

BlobIndexerParsingMode

Uppräkning

Representerar parsningsläget för indexering från en Azure Blob Data-källa.

Värde Description
default

Ange som standard för normal filbearbetning.
text

Ange till text för att förbättra indexeringsprestanda för oformaterade textfiler i Blob Storage.
delimitedText

Ange till avgränsadtext när blobar är vanliga CSV-filer.
json

Ange till json för att extrahera strukturerat innehåll från JSON-filer.
jsonArray

Ange till jsonArray för att extrahera enskilda element i en JSON-matris som separata dokument.
jsonLines

Ange till jsonLines för att extrahera enskilda JSON-entiteter, avgränsade med en ny rad, som separata dokument.
markdown

Ställ in på markdown för att extrahera innehåll från markdown-filer.

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.

FileKnowledgeSourceExtractionMode

Uppräkning

Extraktionsarbetet tillämpades på en enskild fil. 'minimal' (standard) använder inbyggd extraktion; 'standard' använder Content Understanding.

Värde Description
minimal

Inbyggd extraktion utfördes.
standard

Extraktion av innehållsförståelse utfördes.

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

FileKnowledgeSourceExtractionMode

Extraktionsläget tillämpades på filen.
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.
metadata

object

Anpassad nyckel-/värdemetadata lagrad med filen. Returnerat men inte sökbart eller filtrerbart.
parsingMode

BlobIndexerParsingMode

Parsing-läget tillämpades på filen (automatiskt upptäckt från filen).
prefix

string

Prefixet (katalogliknande sökväg) härstammar från det fullständiga filnamnet.