Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:Dosya Yükleme (Python SDK V2)

Son Güncelleme:Oct 02, 2026

Python V2 için OSS SDK, dosya yükleme işlemleri için çeşitli yöntemler sunar. Senaryonuza en uygun işlemi seçebilirsiniz.

Tür

İşlem adı

Açıklama

Basit Yükleme (Python SDK V2)

client.put_object

  • Basit yükleme yapar. Yüklenebilecek nesnenin maksimum boyutu 5 GiB'dir.

  • 64 bitlik döngüsel yedeklilik denetimi (CRC-64) veri doğrulamasını destekler. Bu özellik varsayılan olarak etkindir.

  • İlerleme çubuklarını destekler.

  • İstek gövdesi io.Reader türündedir. io.Seeker türü destekleniyorsa, yükleme başarısız olursa yeniden iletim yapılır.

client.put_object_from_file

  • client.put_object işlemiyle aynı özelliklere sahiptir.

  • İstek gövdesi verileri bir dosya yolundan alınır.

Ekleme Yöntemiyle Yükleme (Python SDK V2)

client.append_object

  • Ekleme yöntemiyle yükleme yapar. Son nesnenin maksimum boyutu 5 GiB'dir.

  • CRC-64 veri doğrulamasını destekler. Bu özellik varsayılan olarak etkindir.

  • İlerleme çubuklarını destekler.

  • İstek gövdesi BodyType türündedir. Yükleme başarısız olursa yeniden iletim yapılır. Bu işlem özdeş değildir (idempotent değil). Yeniden iletim başarısız olabilir.

AppendOnlyFile işlemi

AppendOnlyFile.write

AppendOnlyFile.write_from

  • client.append_object işlemiyle aynı özelliklere sahiptir.

  • Yeniden iletim hataları için hata toleransını optimize eder.

Parçalı Yükleme (Python SDK V2)

Parçalı yükleme işlemleri

client.initiate_multipart_upload

client.upload_part

client.complete_multipart_upload

  • Parçalı yükleme yapar. Bir parçanın maksimum boyutu 5 GiB, nesnenin maksimum boyutu ise 48,8 TiB'dir.

  • upload_part işlemi CRC-64 doğrulamasını destekler. Bu özellik varsayılan olarak etkindir.

  • upload_part işlemi ilerleme çubuklarını destekler.

  • upload_part işlemi için istek gövdesi BodyType türündedir. str, bytes, Iterable[bytes], IO[str] ve IO[bytes] türleri de desteklenir.

Form Yükleme (Python SDK V2)

/

  • Post imzası ve Post ilkesi gibi bilgileri oluşturur ve HTTP POST yöntemini çağırarak bir dosyayı OSS'e yükler.

İmzalı URL Kullanarak Yükleme (Python SDK V2)

client.presign

  • PUT yöntemi için sona erme süresi olan imzalı bir URL oluşturur. Bu, diğer kullanıcıların geçici olarak dosya yüklemesine olanak tanır.

Dosya Yükleme Yöneticisi (Python SDK V2)

Uploader.upload_from

  • Basit yükleme ve parçalı yükleme işlemlerini kapsüller. Yüklenebilecek nesnenin maksimum boyutu 48,8 TiB'dir.

  • CRC-64 veri doğrulamasını destekler. Bu özellik varsayılan olarak etkindir.

  • İlerleme çubuklarını destekler.

  • İstek gövdesi parametresi IO[bytes] türündedir.

Uploader.upload_file

  • Uploader.upload_from işlemiyle aynı özelliklere sahiptir.

  • İstek gövdesi verileri bir dosya yolundan alınır.

  • Kaldığı yerden devam eden yüklemeyi (resumable upload) destekler.