All Products
Search
Document Center

Object Storage Service:Unggah file (Python SDK V2)

Last Updated:Nov 10, 2025

OSS SDK untuk Python V2 menyediakan berbagai metode untuk mengunggah file. Pilih metode yang paling sesuai dengan kebutuhan Anda.

Jenis

Nama operasi

Deskripsi

Unggah sederhana (Python SDK V2)

client.put_object

  • Melakukan unggah sederhana. Ukuran maksimum objek yang dapat diunggah adalah 5 GiB.

  • Mendukung validasi data Pemeriksaan redundansi siklik 64-bit (CRC-64). Fitur ini diaktifkan secara default.

  • Mendukung grafik bilah kemajuan.

  • Badan permintaan bertipe io.Reader. Jika tipe io.Seeker didukung, pengiriman ulang dilakukan jika unggah gagal.

client.put_object_from_file

  • Menyediakan fitur yang sama dengan operasi client.put_object.

  • Data badan permintaan diperoleh dari jalur file.

Unggah tambahan (Python SDK V2)

client.append_object

  • Melakukan unggah tambahan. Ukuran maksimum objek akhir adalah 5 GiB.

  • Mendukung validasi data CRC-64. Fitur ini diaktifkan secara default.

  • Mendukung grafik bilah kemajuan.

  • Badan permintaan bertipe BodyType. Pengiriman ulang dilakukan jika unggah gagal. Operasi ini tidak idempoten. Pengiriman ulang mungkin gagal.

Operasi AppendOnlyFile

AppendOnlyFile.write

AppendOnlyFile.write_from

  • Menyediakan fitur yang sama dengan operasi client.append_object.

  • Mengoptimalkan toleransi kesalahan untuk kegagalan pengiriman ulang.

Unggah multi-bagian (Python SDK V2)

Operasi unggah multi-bagian

client.initiate_multipart_upload

client.upload_part

client.complete_multipart_upload

  • Melakukan unggah multi-bagian. Ukuran maksimum bagian adalah 5 GiB. Ukuran maksimum objek adalah 48,8 TiB.

  • Operasi upload_part mendukung validasi CRC-64. Fitur ini diaktifkan secara default.

  • Operasi upload_part mendukung grafik bilah kemajuan.

  • Badan permintaan untuk operasi upload_part bertipe BodyType. Tipe str, bytes, Iterable[bytes], IO[str], dan IO[bytes] juga didukung.

Unggah formulir (Python SDK V2)

/

  • Menghasilkan informasi seperti Post signature dan Post policy, dan memanggil metode HTTP POST untuk mengunggah file ke OSS.

Unggah menggunakan URL yang ditandatangani (Python SDK V2)

client.presign

  • Menghasilkan URL yang ditandatangani untuk metode PUT yang memiliki waktu kedaluwarsa. Ini memungkinkan pengguna lain untuk sementara mengunggah file.

Manajer unggah file (Python SDK V2)

Uploader.upload_from

  • Mengenkapsulasi operasi unggah sederhana dan unggah multi-bagian. Ukuran maksimum objek yang dapat diunggah adalah 48,8 TiB.

  • Mendukung validasi data CRC-64. Fitur ini diaktifkan secara default.

  • Mendukung grafik bilah kemajuan.

  • Parameter badan permintaan bertipe IO[bytes].

Uploader.upload_file

  • Menyediakan fitur yang sama dengan operasi Uploader.upload_from.

  • Data badan permintaan diperoleh dari jalur file.

  • Mendukung unggah yang dapat dilanjutkan.