Knowledge Sources - Upload File

Layanan:
Search Service
Versi API:
2026-05-01-preview

Mengunggah file ke sumber pengetahuan File untuk diproses dan diindeks.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
endpoint
 path True

string (uri)

URL titik akhir layanan pencarian.
sourceName
 path True

string

Nama sumber pengetahuan.
api-version
 query True

string

minLength: 1

Versi API yang akan digunakan untuk operasi ini.

Header Permintaan

Media Types: "application/octet-stream"

Nama Diperlukan Jenis Deskripsi
Content-Disposition True

string

Header Content-Disposition yang menentukan nama file file yang diunggah. Harus mengikuti format: attachment; filename="<filename>". Misalnya: attachment; filename="installation-guide.pdf".
x-ms-client-request-id

string (uuid)

Pengidentifikasi string yang buram dan unik secara global yang dihasilkan klien untuk permintaan tersebut.

Isi Permintaan

Media Types: "application/octet-stream"

Nama Jenis Deskripsi
file

string (binary)

Konten file yang akan diunggah.

Respons

Nama Jenis Deskripsi
201 Created

KnowledgeSourceFile

Permintaan telah berhasil dan sumber daya baru telah dibuat sebagai hasilnya.
Other Status Codes

ErrorResponse

Respons kesalahan yang tidak terduga.

Keamanan

api-key

Jenis: apiKey
Dalam: header

OAuth2Auth

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Cakupan

Nama Deskripsi
https://search.azure.com/.default

Contoh

SearchServiceUploadKnowledgeSourceFile

Permintaan sampel

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



"dGVzdCBmaWxlIGNvbnRlbnQ="

Respon sampel

Kode status:
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
}

Definisi

Nama Deskripsi
ErrorAdditionalInfo

Informasi tambahan tentang kesalahan pengelolaan sumber daya.
ErrorDetail

Detail kesalahan.
ErrorResponse

Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).
KnowledgeSourceFile

Metadata untuk file yang diunggah ke sumber pengetahuan File.

ErrorAdditionalInfo

Objek

Informasi tambahan tentang kesalahan pengelolaan sumber daya.

Nama Jenis Deskripsi
info

Info tambahan.
type

string

Jenis informasi tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Informasi tambahan tentang kesalahan.
code

string

Kode kesalahan.
details

ErrorDetail[]

Rincian kesalahan.
message

string

Pesan kesalahan.
target

string

Sasaran kesalahan.

ErrorResponse

Objek

Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

KnowledgeSourceFile

Objek

Metadata untuk file yang diunggah ke sumber pengetahuan File.

Nama Jenis Deskripsi
createdAt

string (date-time)

Stempel waktu saat file dibuat.
errorMessage

string

Pesan kesalahan jika pemrosesan file gagal, null jika tidak.
fileId

string

Pengidentifikasi unik untuk file.
fileName

string

Nama file asli.
fileSizeBytes

integer (int64)

Ukuran file dalam byte.
lastUpdatedAt

string (date-time)

Stempel waktu saat file terakhir diperbarui.