Knowledge Sources - Update File

Tjänst:: Search Service

API-version:: 2026-08-01-preview

Uppdaterar en befintlig fil i en filkunskapskälla som finns på plats, och ersätter dess indexerade innehåll. Använder multipart/formulärdata: en JSON 'metadata'-del (filnamn och anpassad metadata) och en 'innehålls'-del med råa filbyte.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
content	formData	True	file	Det råa filinnehållet.
metadata	formData	True	string	JSON-metadata som beskriver filen.
endpoint	path	True	string (uri)	Slutpunkts-URL:en för söktjänsten.
fileId	path	True	string	Den unika identifieraren för filen som ska uppdateras.
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: "multipart/form-data"

Name	Obligatorisk	Typ	Description
x-ms-client-request-id		string (uuid)	En ogenomskinlig, globalt unik, klientgenererad strängidentifierare för begäran.

Svar

Name	Typ	Description
200 OK	KnowledgeSourceFile	Begäran har slutförts.
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

SearchServiceUpdateKnowledgeSourceFile

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 200

{
  "fileId": "00000000-0000-0000-0000-000000000001",
  "fileName": "notes/build26/kr-features.md",
  "fileSizeBytes": 43,
  "createdAt": "2026-08-03T17:04:22Z",
  "lastUpdatedAt": "2026-01-02T00:00:00Z",
  "prefix": "notes/build26/",
  "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.