全部文档
当前文档
最近更新时间：2026-06-03 21:31:44
以下代码用于修改文件的元信息：
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>')
# 更改文件元信息。通过复制并添加新header的方式实现，故方法名为copy_key
# 第一个参数和第三个参数是对象名称，第二个参数是存储空间名称
# 以替换 content-type 为例
headers = {'content-type': 'text/plain', 'x-kss-metadata-directive': 'REPLACE'}
ret = b.copy_key('<your_key_name>', '<your_bucket_name>', '<your_key_name>', headers=headers)
print("copy_key, request_id: ", ret.response_metadata.request_id)
有关修改文件元信息相关API，请参见PUT Object Copy。
以下代码用于获取文件元信息：
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名称。
ret = b.get_key_meta('<yourKeyName>')
if ret and ret.status == 200:
print("获取文件header成功: \n", ret.data.headers)
print('get_key_meta, request_id: %s' % ret.response_metadata.request_id)
else:
print("获取文件header失败")
print('get_key_meta failed, request_id: %s' % ret.response_metadata.request_id)有关获取文件元信息相关API，请参见HEAD Object。
纯净模式