全部文档
当前文档
最近更新时间：2026-06-03 21:32:11
追加上传是指通过Append Object方法在已上传的追加类型文件（Appendable Object）末尾直接追加内容。
以下为追加上传的代码示例：
from ks3.connection import Connection
# 金山云主账号AccessKey拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号进行 API 访问或日常运维，请登录https://uc.console.ksyun.com/pro/iam/#/user/list创建子账号。
# 通过指定host(Endpoint)，您可以在指定的地域访问存储空间。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='<YOUR_REGION_ENDPOINT>')
# 获取存储空间实例
b = c.get_bucket('<YOUR_BUCKET_NAME>')
# 填写Object完整路径。Object完整路径中不能包含Bucket名称。
k = b.new_key('<yourKeyName>')
# 第一个参数为文件内容；position为追加起始位置
ret = k.append_object_from_string('<yourFileContent1>', position=<appendPosition>)
print('requestid:', ret.response_metadata.request_id)
if ret and ret.status == 200:
print('追加上传成功')
# 如有需要，获取下一次append的位置
print('x-kss-next-append-position:', ret.headers['x-kss-next-append-position'])
# 继续追加
ret = k.append_object_from_string('<yourFileContent2>', position=int(ret.headers['x-kss-next-append-position']))
if ret and ret.status == 200:
print('继续追加上传成功')
# 第一个参数为文件路径；position为追加起始位置
ret = k.append_object_from_filename('<yourSourceFilePath>', position=<appendPosition>)
print('requestid:', ret.response_metadata.request_id)
if ret and ret.status == 200:
print('文件追加上传成功')纯净模式