UploadSemanticFile - DataWorks - Alibaba Cloud Documentation Center

Deskripsi operasi

Skenario

Meminta saluran unggah untuk file referensi guna menyiapkan file untuk sumber singleTableFile dari CreateSemanticJob.

Prosedur

Teruskan nama file, tipe MIME, dan ukuran aktual ke operasi ini untuk memperoleh Data.UploadUrl dan Data.FileId.
Lakukan unggahan HTTP PUT dengan Content-Type yang sama sebelum UploadUrl kedaluwarsa.
Setelah unggahan selesai, gunakan FileId sebagai satu-satunya elemen dari CreateSemanticJob.ReferenceFileIds.

Pertimbangan keamanan

UploadUrl adalah URL PUT pra-tanda tangan berumur pendek. Pemegangnya dapat menulis ke objek yang sesuai. Jangan mencatat, membagikan, atau menyimpan URL ini secara permanen.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
FileName	string	Yes	Nama file asli dari file referensi yang akan diunggah. Panjang maksimum: 255 karakter. Ketika singleTableFile menggunakan FileId, hanya file CSV atau XLSX yang didukung.	Referensi.pdf
ContentType	string	Yes	Tipe MIME dari objek yang akan diunggah. Panjang maksimum: 128 karakter. Nilai ini disertakan dalam tanda tangan UploadUrl. Gunakan Content-Type yang sama saat melakukan permintaan PUT.	application/pdf
SizeBytes	integer	Yes	Ukuran file yang akan diunggah, dalam byte. Nilai ini dicatat sebagai metadata lampiran. Tentukan ukuran file aktual.	1024

Susun parameter permintaan berdasarkan deskripsi setiap bidang permintaan.

Elemen respons

Element	Type	Description	Example
	object	Tanggapan standar untuk meminta saluran unggah lampiran. Setelah unggahan PUT selesai, Data.FileId dapat digunakan sebagai satu-satunya referensi file dalam CreateSemanticJob.ReferenceFileIds.
RequestId	string	ID permintaan. Digunakan untuk melacak log dan memecahkan masalah.	676271D6-53B4-57BE-89FA-72F7AE1418DF
Success	boolean	Menunjukkan apakah permintaan berhasil.
Data	object	Informasi saluran unggah lampiran. Unggah file ke Data.UploadUrl sebelum Data.ExpiresAt, lalu gunakan Data.FileId untuk membuat tugas semantik file tunggal.
FileId	string	Pengidentifikasi unik lampiran. Setelah menyelesaikan unggahan PUT ke UploadUrl, teruskan nilai ini ke parameter ReferenceFileIds dari CreateSemanticJob.	FID1
UploadUrl	string	URL unggah PUT OSS sementara. Berlaku selama 30 menit. Hanya objek yang ditentukan yang dapat diunggah. Gunakan ContentType dari permintaan saat melakukan permintaan PUT. Jangan mencatat atau mendistribusikan URL lengkap.	https://example.com/temporary-upload-url
ExpiresAt	integer	Pengatur waktu kedaluwarsa UploadUrl, dinyatakan sebagai stempel waktu UNIX dalam milidetik. Setelah waktu ini, panggil UploadSemanticFile lagi untuk meminta URL baru.	1700001800000

Untuk arti bidang tanggapan dan hubungannya dengan panggilan berikutnya, lihat deskripsi setiap bidang.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": false,
  "Data": {
    "FileId": "FID1",
    "UploadUrl": "https://example.com/temporary-upload-url",
    "ExpiresAt": 1700001800000
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.