Knowledge Sources - Upload File

Služba:: Search Service

Verze rozhraní API:: 2026-08-01-preview

Nahraje soubor do zdroje znalostí souboru pro zpracování a indexování.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string (uri)	Adresa URL koncového bodu vyhledávací služby.
sourceName	path	True	string	Název zdroje znalostí.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Media Types: "application/octet-stream"

Name	Vyžadováno	Typ	Description
Content-Disposition	True	string	Hlavička Content-Disposition specifikující název souboru nahraného souboru. Musí dodržovat formát: `attachment; filename="<filename>"`. Například: `attachment; filename="installation-guide.pdf"`.
x-ms-client-request-id		string (uuid)	Neprůzrný globálně jedinečný identifikátor řetězce vygenerovaný klientem pro požadavek.

Text požadavku

Media Types: "application/octet-stream"

Name	Typ	Description
file	string (binary)	Obsah souboru k nahrání.

Odpovědi

Name	Typ	Description
201 Created	KnowledgeSourceFile	Požadavek byl úspěšný a v důsledku toho byl vytvořen nový prostředek.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

api-key

Typ: apiKey
V: header

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Rozsahy

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

Příklady

SearchServiceUploadKnowledgeSourceFile

Ukázkový požadavek

HTTP

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



"U2FtcGxlIGZpbGUgY29udGVudCBmb3IgdXBsb2FkLg=="

Ukázková odpověď

Stavový kó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"
}

Definice

Name	Description
BlobIndexerParsingMode	Představuje režim analýzy pro indexování ze zdroje dat objektů blob Azure.
ErrorAdditionalInfo	Další informace o chybě při správě prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)
FileKnowledgeSourceExtractionMode	Extrakce se vztahovala na jednotlivý soubor. 'minimalní' (výchozí) používá vestavěnou extrakci; 'standardní' používá Content Understanding.
KnowledgeSourceFile	Metadata souboru nahraného do zdroje znalostí souboru.

BlobIndexerParsingMode

Výčet

Představuje režim analýzy pro indexování ze zdroje dat objektů blob Azure.

Hodnota	Description
default	Nastavte na výchozí hodnotu pro normální zpracování souborů.
text	Nastavte na text, aby se zlepšil výkon indexování u souborů ve formátu prostého textu v úložišti objektů blob.
delimitedText	Nastavte na oddělovačText, pokud jsou objekty blob prostými soubory CSV.
json	Nastavte na json a extrahujte strukturovaný obsah ze souborů JSON.
jsonArray	Nastavte na jsonArray a extrahujte jednotlivé prvky pole JSON jako samostatné dokumenty.
jsonLines	Nastavte na jsonLines a extrahujte jednotlivé entity JSON oddělené novým řádkem jako samostatné dokumenty.
markdown	Nastavením na markdown extrahujete obsah ze souborů markdown.

ErrorAdditionalInfo

Objekt

Další informace o chybě při správě prostředků

Name	Typ	Description
info		Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

FileKnowledgeSourceExtractionMode

Výčet

Extrakce se vztahovala na jednotlivý soubor. 'minimalní' (výchozí) používá vestavěnou extrakci; 'standardní' používá Content Understanding.

Hodnota	Description
minimal	Byla provedena vestavěná extrakce.
standard	Byla provedena extrakce Content Understanding.

KnowledgeSourceFile

Objekt

Metadata souboru nahraného do zdroje znalostí souboru.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko, kdy byl soubor vytvořen.
errorMessage	string	Chybová zpráva pokud selhalo zpracování souborů, jinak nulovala.
extractionMode	FileKnowledgeSourceExtractionMode	Na soubor se aplikoval režim extrakce.
fileId	string	Jedinečný identifikátor souboru.
fileName	string	Původní název souboru.
fileSizeBytes	integer (int64)	Velikost souboru v bajtech.
lastUpdatedAt	string (date-time)	Časové razítko, kdy byl soubor naposledy aktualizován.
metadata	object	Vlastní metadata klíč/hodnota uložená v souboru. Vráceno, ale není vyhledávatelné ani filtrovatelné.
parsingMode	BlobIndexerParsingMode	Na soubor aplikoval režim parsování (automaticky detekovaný ze souboru).
prefix	string	Prefix (adresářová cesta) je odvozen z plného názvu souboru.