Knowledge Sources - Update File

Szolgáltatás:: Search Service

API-verzió:: 2026-08-01-preview

Frissíti a meglévő fájlt egy fájltudásforrásban, helyettesítve annak indexelt tartalmát. Többrészes/form-data-adatokat használ: egy JSON 'metadata' részt (fájlnév és egyedi metaadat) és egy 'tartalom' részt a nyers fájl bájtokkal.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
content	formData	True	file	A nyers fájltartalom.
metadata	formData	True	string	A fájlt leíró JSON metaadat.
endpoint	path	True	string (uri)	A keresési szolgáltatás végpontjának URL-címe.
fileId	path	True	string	A fájl egyedi azonosítója, amit frissíteni kell.
sourceName	path	True	string	A tudásforrás neve.
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.

Kérelem fejléce

Media Types: "multipart/form-data"

Name	Kötelező	Típus	Description
x-ms-client-request-id		string (uuid)	A kérés átlátszatlan, globálisan egyedi, ügyfél által generált sztringazonosítója.

Válaszok

Name	Típus	Description
200 OK	KnowledgeSourceFile	A kérés sikeres volt.
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

api-key

Típus: apiKey
In: header

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Hatókörök

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

Példák

SearchServiceUpdateKnowledgeSourceFile

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:: 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"
}

Definíciók

Name	Description
BlobIndexerParsingMode	Az Azure Blob-adatforrásból való indexelés elemzési módját jelöli.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)
FileKnowledgeSourceExtractionMode	A kinyerési erőfeszítés egy adott fájlra vonatkozott. a 'minimal' (az alapértelmezett) beépített kinyerést használ; a 'standard' a Tartalom Megértését használja.
KnowledgeSourceFile	Metaadat egy fájlhoz feltöltve egy fájltudásforrásba.

BlobIndexerParsingMode

Felsorolás

Az Azure Blob-adatforrásból való indexelés elemzési módját jelöli.

Érték	Description
default	Normál fájlfeldolgozás esetén állítsa be az alapértelmezett értéket.
text	A blobtárolóban lévő egyszerű szöveges fájlok indexelési teljesítményének javításához állítsa be a szöveget szövegre.
delimitedText	Ha a blobok egyszerű CSV-fájlok, akkor az elhatároltText értékre van állítva.
json	A JSON-fájlokból strukturált tartalom kinyeréséhez állítsa be a json értéket.
jsonArray	A JSON-tömb egyes elemeinek különálló dokumentumokként való kinyeréséhez állítsa be a jsonArray értéket.
jsonLines	A jsonLines értékre állítva az egyes JSON-entitásokat egy új sor választja el egymástól, különálló dokumentumokként.
markdown	Állítsa be a markdown-t a tartalom kinyeréséhez a markdown-fájlokból.

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info		A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hiba célpontja.

ErrorResponse

Tárgy

Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

FileKnowledgeSourceExtractionMode

Felsorolás

A kinyerési erőfeszítés egy adott fájlra vonatkozott. a 'minimal' (az alapértelmezett) beépített kinyerést használ; a 'standard' a Tartalom Megértését használja.

Érték	Description
minimal	Beépített kitermelést végeztek.
standard	Tartalom megértése során a kinyerést végezték.

KnowledgeSourceFile

Tárgy

Metaadat egy fájlhoz feltöltve egy fájltudásforrásba.

Name	Típus	Description
createdAt	string (date-time)	Az időbélyeg, amikor a fájlt létrehozták.
errorMessage	string	A hibaüzenet, ha fájlfeldolgozás nem működik, egyébként null.
extractionMode	FileKnowledgeSourceExtractionMode	A kivonási mód a fájlra került.
fileId	string	A fájl egyedi azonosítója.
fileName	string	Az eredeti fájl neve.
fileSizeBytes	integer (int64)	A fájl mérete bájtban.
lastUpdatedAt	string (date-time)	Az időbélyeg, amikor a fájlt utoljára frissítették.
metadata	object	Egyedi kulcs/érték metaadat a fájlban tárolva. Visszaküldve, de nem kereshető vagy szűrhető.
parsingMode	BlobIndexerParsingMode	A fájlra alkalmazva az elemzési mód (automatikusan felismerhető a fájlból).
prefix	string	Az előtag (könyvtárszerű út) a teljes fájlnévből származik.