Knowledge Sources - Upload File

Szolgáltatás:: Search Service

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

Feltölt egy fájlt egy fájltudásforrásba feldolgozásra és indexelésre.

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

URI-paraméterek

Név	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	A keresési szolgáltatás végpontjának URL-címe.
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: "application/octet-stream"

Név	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.
Content-Disposition	True	string	A Tartalom-Meghatározás fejléce, amely megadja a feltöltött fájl fájlnevét. A formátumot kell követni: `attachment; filename="<filename>"`. Például: `attachment; filename="installation-guide.pdf"`.

Kérelem törzse

Media Types: "application/octet-stream"

Név	Típus	Description
file	string (binary)	A fájl tartalmát kell feltölteni.

Válaszok

Név	Típus	Description
201 Created	KnowledgeSourceFile	A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre.
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

Név	Description
https://search.azure.com/.default

Példák

SearchServiceUploadKnowledgeSourceFile

Mintakérelem

HTTP

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



"U2FtcGxlIGZpbGUgY29udGVudCBmb3IgdXBsb2FkLg=="

Mintaválasz

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

Definíciók

Név	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.

Név	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.

Név	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.)

Név	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.

Név	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.