全部產品
Search
文件中心

Object Storage Service:上傳檔案(Python SDK V2)

更新時間:Jul 31, 2025

Python SDK V2提供了各種上傳檔案的介面,您可以根據使用情境選擇適合的介面。

類型

介面名

說明

簡單上傳(Python SDK V2)

client.put_object

  • 簡單上傳, 最大支援5GiB

  • 支援CRC64資料校正(預設啟用)

  • 支援進度條

  • 請求body類型為io.Reader, 當支援io.Seeker類型時,具備失敗重傳

client.put_object_from_file

  • 與client.put_object介面能力一致

  • 請求body資料來源於檔案路徑

追加上傳(Python SDK V2)

client.append_object

  • 追加上傳, 最終檔案最大支援5GiB

  • 支援CRC64資料校正(預設啟用)

  • 支援進度條

  • 請求body類型為BodyType,具備失敗重傳(該介面為非等冪介面,重傳時可能出現失敗)

AppendOnlyFile介面

AppendOnlyFile.write

AppendOnlyFile.write_from

  • 與client.append_object介面能力一致

  • 最佳化了重傳時失敗後容錯處理

分區上傳(Python SDK V2)

分區上傳介面

client.initiate_multipart_upload

client.upload_part

client.complete_multipart_upload

  • 分區上傳,單個分區最大5GiB,檔案最大48.8TiB

  • upload_part介面支援CRC64校正(預設啟用)

  • upload_part介面支援進度條

  • upload_part請求body類型為BodyType,同時支援 str, bytes, Iterable[bytes], IO[str], IO[bytes]

表單上傳(Python SDK V2)

/

  • 產生Post簽名和Post Policy等資訊,並調用HTTP Post方法上傳檔案到OSS

使用預簽名URL上傳(Python SDK V2)

client.presign

  • 產生帶有到期時間的PUT方法簽名URL,以允許他人臨時上傳檔案

檔案上傳管理器(Python SDK V2)

Uploader.upload_from

  • 封裝了簡單上傳 和 分區上傳介面,最大支援48.8TiB

  • 支援CRC64資料校正(預設啟用)

  • 支援進度條

  • 請求body參數類型為IO[bytes]

Uploader.upload_file

  • 與Uploader.UploadFrom介面能力一致

  • 請求body資料來源於檔案路徑

  • 支援斷點續傳