Knowledge Sources - Upload File

Služba:
Search Service
Verze rozhraní API:
2026-05-01-preview

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

POST {endpoint}/knowledgesources('{sourceName}')/files?api-version=2026-05-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

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



"dGVzdCBmaWxlIGNvbnRlbnQ="

Ukázková odpověď

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

Definice

Name Description
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.)
KnowledgeSourceFile

Metadata souboru nahraného do zdroje znalostí souboru.

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.

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