Knowledge Sources - Upload File

Служба:: Search Service

Версия API:: 2026-05-01-preview

Загружает файл в источник знаний для обработки и индексации.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string (uri)	URL-адрес конечной точки службы поиска.
sourceName	path	True	string	Название источника знаний.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Заголовок запроса

Media Types: "application/octet-stream"

Имя	Обязательно	Тип	Описание
Content-Disposition	True	string	Заголовок Content-Disposition, указывающий имя файла загруженного файла. Должно следовать формату: `attachment; filename="<filename>"`. Например: `attachment; filename="installation-guide.pdf"`.
x-ms-client-request-id		string (uuid)	Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Текст запроса

Media Types: "application/octet-stream"

Имя	Тип	Описание
file	string (binary)	Содержимое файла для загрузки.

Ответы

Имя	Тип	Описание
201 Created	KnowledgeSourceFile	Запрос успешно выполнен, и в результате был создан новый ресурс.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Безопасность

api-key

Тип: apiKey
В: header

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Области

Имя	Описание
https://search.azure.com/.default

Примеры

SearchServiceUploadKnowledgeSourceFile

Образец запроса

HTTP

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



"dGVzdCBmaWxlIGNvbnRlbnQ="

Пример ответа

Код состояния:: 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
}

Определения

Имя	Описание
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Подробности ошибки.
ErrorResponse	Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).
KnowledgeSourceFile	Метаданные для файла, загруженного в источник знаний File.

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info		Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

Объект

Подробности ошибки.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

KnowledgeSourceFile

Объект

Метаданные для файла, загруженного в источник знаний File.

Имя	Тип	Описание
createdAt	string (date-time)	Временная метка при создании файла.
errorMessage	string	Сообщение об ошибке, если обработка файлов не удалась, в противном случае — null.
fileId	string	Уникальный идентификатор файла.
fileName	string	Оригинальное имя файла.
fileSizeBytes	integer (int64)	Размер файла в байтах.
lastUpdatedAt	string (date-time)	Отметка времени последнего обновления файла.