Knowledge Sources - Upload File

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

Mengunggah file ke sumber pengetahuan File untuk diproses dan diindeks.

POST {endpoint}/knowledgesources('{sourceName}')/files?api-version=2026-08-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://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')/files?api-version=2026-08-01-preview



"U2FtcGxlIGZpbGUgY29udGVudCBmb3IgdXBsb2FkLg=="

Respon sampel

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

Definisi

Nama Deskripsi
BlobIndexerParsingMode

Mewakili mode penguraian untuk pengindeksan dari sumber data blob Azure.
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.).
FileKnowledgeSourceExtractionMode

Upaya ekstraksi diterapkan pada satu file individual. 'minimal' (default) menggunakan ekstraksi bawaan; 'standar' menggunakan Content Understanding.
KnowledgeSourceFile

Metadata untuk file yang diunggah ke sumber pengetahuan File.

BlobIndexerParsingMode

Enumerasi

Mewakili mode penguraian untuk pengindeksan dari sumber data blob Azure.

Nilai Deskripsi
default

Atur ke default untuk pemrosesan file normal.
text

Atur ke teks untuk meningkatkan performa pengindeksan pada file teks biasa dalam penyimpanan blob.
delimitedText

Atur ke delimitedText saat blob adalah file CSV biasa.
json

Atur ke json untuk mengekstrak konten terstruktur dari file JSON.
jsonArray

Atur ke jsonArray untuk mengekstrak elemen individual array JSON sebagai dokumen terpisah.
jsonLines

Atur ke jsonLines untuk mengekstrak entitas JSON individual, dipisahkan oleh baris baru, sebagai dokumen terpisah.
markdown

Atur ke markdown untuk mengekstrak konten dari file markdown.

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.

FileKnowledgeSourceExtractionMode

Enumerasi

Upaya ekstraksi diterapkan pada satu file individual. 'minimal' (default) menggunakan ekstraksi bawaan; 'standar' menggunakan Content Understanding.

Nilai Deskripsi
minimal

Ekstraksi bawaan dilakukan.
standard

Ekstraksi Pemahaman Konten telah dilakukan.

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

FileKnowledgeSourceExtractionMode

Mode ekstraksi diterapkan pada file.
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.
metadata

object

Metadata kunci/nilai khusus yang disimpan bersama file. Dikembalikan tetapi tidak dapat dicari atau difilter.
parsingMode

BlobIndexerParsingMode

Mode parsing yang diterapkan pada file (terdeteksi otomatis dari file).
prefix

string

Prefiks (jalur seperti direktori) berasal dari nama file lengkap.