Python上传文件

类型

接口名

说明

简单上传

client.put_object

• 简单上传, 最大支持5GiB

• 支持CRC64数据校验(默认启用)

• 支持进度条

• 请求body类型为io.Reader, 当支持io.Seeker类型时，具备失败重传

client.put_object_from_file

• 与client.put_object接口能力一致

• 请求body数据来源于文件路径

追加上传

client.append_object

• 追加上传, 最终文件最大支持5GiB

• 支持CRC64数据校验(默认启用)

• 支持进度条

• 请求body类型为BodyType，具备失败重传(该接口为非幂等接口，重传时可能出现失败)

AppendOnlyFile接口

AppendOnlyFile.write

AppendOnlyFile.write_from

• 与client.append_object接口能力一致

• 优化了重传时失败后容错处理

分片上传

分片上传接口

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]

表单上传

/

• 生成Post签名和Post Policy等信息，并调用HTTP Post方法上传文件到OSS

使用预签名URL上传

client.presign

• 生成带有过期时间的PUT方法签名URL，以允许他人临时上传文件

文件上传管理器

Uploader.upload_from

• 封装了简单上传 和 分片上传接口，最大支持48.8TiB

• 支持CRC64数据校验(默认启用)

• 支持进度条

• 请求body参数类型为IO[bytes]

Uploader.upload_file

• 与Uploader.UploadFrom接口能力一致

• 请求body数据来源于文件路径

• 支持断点续传