Knowledge Sources - Upload File

Szolgáltatás:: Search Service

API-verzió:: 2026-05-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-05-01-preview

URI-paraméterek

Name	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"

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

Kérelem törzse

Media Types: "application/octet-stream"

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

Válaszok

Name	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

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

Példák

SearchServiceUploadKnowledgeSourceFile

Mintakérelem

HTTP

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



"dGVzdCBmaWxlIGNvbnRlbnQ="

Mintaválasz

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

Definíciók

Name	Description
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.)
KnowledgeSourceFile	Metaadat egy fájlhoz feltöltve egy fájltudásforrásba.

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.

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