Unggah Potongan File

Artikel
08/05/2023

Mengunggah potongan file ke jalur relatif penyimpanan gambar.

Mengunggah potongan file ke penyimpanan gambar dengan ID sesi unggahan dan jalur relatif penyimpanan gambar yang ditentukan. API ini memungkinkan pengguna untuk melanjutkan operasi unggahan file. pengguna tidak perlu menghidupkan ulang unggahan file dari awal setiap kali ada gangguan jaringan. Gunakan opsi ini jika ukuran file besar.

Untuk melakukan unggahan file yang dapat dilanjutkan, pengguna perlu memecah file menjadi beberapa gugus dan mengunggah gugus ini ke penyimpanan gambar satu per satu. Potongan tidak harus diunggah secara berurutan. Jika file yang diwakili oleh jalur relatif penyimpanan gambar sudah ada, file tersebut akan ditimpa saat sesi unggahan dilakukan.

Minta

Metode	Meminta URI
PUT	`/ImageStore/{contentPath}/$/UploadChunk?api-version=6.0&session-id={session-id}&timeout={timeout}`

Parameter

Nama	Jenis	Diperlukan	Lokasi
`contentPath`	string	Ya	Jalur
`Content-Range`	string	Ya	Header
`api-version`	string	Ya	Kueri
`session-id`	string (uuid)	Ya	Kueri
`timeout`	bilangan bulat (int64)	Tidak	Kueri

`contentPath`

Jenis: string
Diperlukan: Ya

Jalur relatif ke file atau folder di penyimpanan citra dari akarnya.

`Content-Range`

Jenis: string
Diperlukan: Ya

Saat mengunggah gugus file ke penyimpanan gambar, bidang header Rentang Konten perlu dikonfigurasi dan dikirim dengan permintaan. Format akan terlihat seperti "byte {First-Byte-Position}-{Last-Byte-Position}/{File-Length}". Misalnya, Content-Range:bytes 300-5000/20000 menunjukkan bahwa pengguna mengirim byte 300 hingga 5.000 dan total panjang file adalah 20.000 byte.

`api-version`

Jenis: string
Diperlukan: Ya
Default: 6.0

Versi API. Parameter ini diperlukan dan nilainya harus '6.0'.

Versi SERVICE Fabric REST API didasarkan pada versi runtime tempat API diperkenalkan atau diubah. Runtime Service Fabric mendukung lebih dari satu versi API. Ini adalah versi TERBARU api yang didukung. Jika versi API yang lebih rendah diteruskan, respons yang dikembalikan mungkin berbeda dari yang didokumenkan dalam spesifikasi ini.

Selain itu, runtime menerima versi apa pun yang lebih tinggi dari versi terbaru yang didukung hingga versi runtime saat ini. Jadi jika versi API terbaru adalah 6.0, tetapi jika runtime adalah 6.1, untuk mempermudah penulisan klien, runtime akan menerima versi 6.1 untuk API tersebut. Namun perilaku API akan sesuai versi 6.0 yang didokumentasikan.

`session-id`

Jenis: string (uuid)
Diperlukan: Ya

GUID yang dihasilkan oleh pengguna untuk pengunggahan file. Ini mengidentifikasi sesi pengunggahan penyimpanan gambar yang melacak semua gugus file hingga diterapkan.

`timeout`

Jenis: bilangan bulat (int64)
Diperlukan: Tidak
Default: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik.

Respons

Kode Status HTTP	Deskripsi	Skema Respons
200 (OK)	Operasi yang berhasil akan mengembalikan kode status HTTP 200 OK.
Semua kode status lainnya	Respons kesalahan terperinci.	FabricError

Bagikan melalui